PrimoToon自定义扩展指南：如何添加新的材质类型与特效

【免费下载链接】PrimoToonShader for Unity (Built-in Rendering Pipeline) attempting to replicate the shading of Genshin Impact developed by miHoYo. This is for datamined assets, not custom-made ones nor the MMD variants.项目地址: https://gitcode.com/gh_mirrors/pr/PrimoToon

PrimoToon是一款专为Unity内置渲染管线设计的Shader，旨在复刻《原神》的卡通渲染风格。对于想要扩展其功能的高级用户来说，了解如何添加新的材质类型和特效是提升渲染效果的关键。本文将详细介绍PrimoToon的自定义扩展方法，帮助您创建独特的渲染效果。

🌟 PrimoToon扩展基础架构

PrimoToon的核心架构基于模块化设计，主要文件包括：

• 主Shader文件：PrimoToon.shader - 包含所有材质属性和渲染逻辑
• HLSL辅助文件：PrimoToon-helpers.hlsl - 工具函数和辅助宏
• 输入定义文件：PrimoToon-inputs.hlsli - 统一的输入结构
• 主渲染文件：PrimoToon-main.hlsl - 核心渲染管线
• 轮廓线系统：PrimoToon-outlines.hlsl - 轮廓线渲染逻辑
• 阴影系统：PrimoToon-shadows.hlsl - 阴影计算

🔧 添加新的材质类型

PrimoToon目前支持三种基础材质类型：Base（基础材质）、Face（面部材质）和Weapon（武器材质）。要添加新的材质类型，您需要修改以下部分：

1. 修改材质类型选择器

在PrimoToon.shader的Properties区块中，找到variant_selector属性定义：

[ThryWideEnum(Base, 0, Face, 1, Weapon, 2)]variant_selector("Material Type--{on_value_actions:[ {value:0,actions:[{type:SET_PROPERTY,data:_UseFaceMapNew=0.0}, {type:SET_PROPERTY,data:_UseWeapon=0.0}]}, {value:1,actions:[{type:SET_PROPERTY,data:_UseFaceMapNew=1.0}, {type:SET_PROPERTY,data:_UseWeapon=0.0}]}, {value:2,actions:[{type:SET_PROPERTY,data:_UseFaceMapNew=0.0}, {type:SET_PROPERTY,data:_UseWeapon=1.0} ]}]}", Int) = 0

2. 添加新材质类型步骤

步骤一：扩展枚举值将ThryWideEnum的选项从(Base, 0, Face, 1, Weapon, 2)扩展，例如添加Cloth, 3作为新的材质类型。

步骤二：定义材质开关在Shader中定义新的材质开关变量，如_UseCloth，用于控制新材质的启用状态。

步骤三：配置动作映射在on_value_actions数组中添加新的动作映射，确保当选择新材质时正确设置相关开关变量。

步骤四：实现材质逻辑在PrimoToon-main.hlsl中添加新的材质渲染逻辑，包括光照计算、纹理混合等。

✨ 自定义特效系统集成

PrimoToon内置了丰富的特效系统，您可以通过以下方式扩展：

溶解效果扩展

溶解效果是PrimoToon的特色功能之一，相关资源文件位于：

• 武器溶解纹理：Resources/Eff_WeaponsTotem_Dissolve_00.png
• 武器颗粒纹理：Resources/Eff_WeaponsTotem_Grain_00.png
• 扫描图案纹理：Resources/Eff_Gradient_Repeat_01.png

添加新特效的流程

1. 定义特效属性：在Shader的Properties区块中添加新的纹理和参数
2. 创建特效函数：在HLSL文件中实现特效算法
3. 集成到主管线：在适当的渲染阶段调用特效函数
4. 优化性能：确保特效不会显著影响渲染性能

🛠️ 编辑器自定义与ThryEditor

PrimoToon使用ThryEditor作为材质编辑器，位于Scripts/ThryEditor/目录。要扩展编辑器功能：

编辑器图标资源

• 主编辑器图标：Scripts/ThryEditor/Resources/thryEditor_iconThry.png
• 贴图工具图标：Scripts/ThryEditor/Resources/decal_gizmo.png

自定义属性绘制器

在Scripts/ThryEditor/Editor/Drawers.cs中可以添加自定义的属性绘制器，实现更友好的用户界面。

本地化支持

ThryEditor支持多语言本地化，相关文件位于Scripts/ThryEditor/thry_editor_locale.csv，您可以为新功能添加翻译。

📁 资源管理与纹理配置

正确的纹理配置对于PrimoToon至关重要：

必需纹理设置

• 漫反射纹理：Texture Type设置为Default，Compression设为High Quality
• 法线贴图：sRGB属性取消勾选，Texture Type保持Default
• 光照贴图：sRGB属性取消勾选
• 渐变纹理：Wrap Mode设为Clamp，禁用压缩和Mip映射

新增纹理集成

当添加新的材质类型时，确保：

1. 在Shader中正确定义纹理属性
2. 设置合适的纹理采样参数
3. 实现纹理的混合和过滤逻辑

🔄 高级扩展技巧

1. 顶点着色器扩展

修改顶点着色器以支持新的顶点数据，如自定义切线或顶点颜色。

2. 片元着色器优化

使用分支预测和条件编译来优化新材质的性能。

3. 多材质混合

实现多个材质类型的混合效果，创建更复杂的表面特性。

4. 实时效果控制

通过脚本动态控制材质参数，实现动画效果。

🚀 测试与验证

添加新功能后，务必进行以下测试：

1. 功能测试：确保新材质类型正确渲染
2. 性能测试：检查帧率影响
3. 兼容性测试：在不同硬件和Unity版本上测试
4. 错误处理：添加适当的错误检查和回退机制

📚 最佳实践建议

1. 保持向后兼容：新功能不应破坏现有材质的渲染
2. 模块化设计：将新功能封装为独立的HLSL文件
3. 文档完善：为新功能添加详细的注释和使用说明
4. 社区分享：将有用的扩展贡献回项目

🎯 总结

PrimoToon的自定义扩展为高级用户提供了强大的灵活性。通过理解其架构和扩展机制，您可以创建独特的材质类型和特效，满足特定的渲染需求。记住始终遵循项目的最佳实践，并在扩展过程中保持代码的整洁和可维护性。

无论您是想要创建新的角色材质、环境特效还是独特的视觉风格，PrimoToon的扩展系统都能为您提供必要的工具和框架。开始您的自定义之旅，打造独一无二的卡通渲染效果吧！ 🎨

【免费下载链接】PrimoToonShader for Unity (Built-in Rendering Pipeline) attempting to replicate the shading of Genshin Impact developed by miHoYo. This is for datamined assets, not custom-made ones nor the MMD variants.项目地址: https://gitcode.com/gh_mirrors/pr/PrimoToon