Jason Ma Toon Render Pipeline (JTRP)

• Jason Ma Toon Render Pipeline (JTRP)
  • Feature
  • Get Start
  • Lit Shader
  • 平滑法线导入工具（ModelOutlineImporter）（Legacy）
  • Light Weight ShaderGUI
    • Function List
  • Reference

这是一个基于Unity HDRP + DirectX 12 Raytracing 的PBR + NPR混合渲染管线，定位于高品质实时渲染MMD、CG内容创作的工具集。

演示+教学视频：

专栏：https://www.zhihu.com/people/blackcat1312/posts

B站：https://space.bilibili.com/42463206

NPR交流群：1046752881

Features

• Lit Toon Shader：working...
• Lit Toon Shader ASE Template：working...
• Geometry Character Outline：working... https://www.bilibili.com/video/BV1vp4y1r7sF
• Post Process Scene Outline：Initially available
• DXR PBR + NPR Sample：Kotenbu
• Light Weight ShaderGUI：Light Weight ShaderGUI | GUI 工具 | Unity Asset Store
• Back Face Outline + Model Outline Importer（Legacy）

Getting started

Development environment: Unity 2020.2、HDRP 10.2、Other dependencies

Download and open the project, open Window > Render Pipeline > HD Render Pipeline Wizard.

Select HDRP+DXR, click Fix All.

Lit Toon Shader

Video：https://www.bilibili.com/video/BV15g4y187sM

• ……
• NEW：基于Ramp的距离-宽度自适应Back Face Outline （已集成入UTS）

DXR PBR + NPR Sample

Video：https://www.bilibili.com/video/BV1Tr4y1F7Pv

Light Weight ShaderGUI

LWGUI是一般ShaderGUI的替代方案，为了写最少的代码并保持灵活易用而编写。所有功能基于Custom Drawer，只需在Shader Property前加上Attribute即可实现各种自定义ShaderGUI。使用时无需写一行ShaderGUI，写Shader的同时进行排版，不同Shader互不相干。Shader末尾需要添加CustomEditor "JTRP.ShaderDrawer.LWGUI"。

LWGUI内置于JTRP，你可以在JTRP的Lit Shader找到更多使用示例。

Function List

/// 创建一个折叠组
/// group：group key，不提供则使用shader property name
/// keyword：_为忽略，不填和__为属性名大写 + _ON
/// style：0 默认关闭；1 默认打开；2 默认关闭无toggle；3 默认打开无toggle
Main(string group = "", string keyWord = "", float style = 0)
    
/// 在折叠组内以默认形式绘制属性
/// group：父折叠组的group key，支持后缀KWEnum或SubToggle的KeyWord以根据enum显示
Sub(string group)

/// n为显示的name，k为对应KeyWord，最多5组，float值为当前激活的KeyWord index（0-4）
KWEnum(string group, string n1, string k1, ... string n5, string k5)

/// 以单行显示Texture，支持额外属性
/// extraPropName：需要显示的额外属性名称
Tex(string group = "", string extraPropName = "")
    
/// <summary>
/// 将一张4*256的Ramp贴图绘制为Gradient
/// </summary>
RampDrawer(string group, string defaultFileName = “JTRP_RampMap”)
    
/// 支持并排最多4个颜色，支持HDR/HSV
/// parameter：填入HSV则将当前颜色转换为HSV颜色传入Shader，无需则填"_"
/// color：可选额外颜色的property name
/// 注意：更改参数需要手动刷新Drawer实例，在shader中随意输入字符引发报错再撤销以刷新Drawer实例
Color(string group, string parameter, string color2, string color3, string color4)
    
/// 以SubToggle形式显示float
/// keyword：_为忽略，不填和__为属性名大写 + _ON
SubToggle(string group, string keyWord = "")
    
/// 同内置PowerSlider，非线性Range
SubPowerSlider(string group, float power = 1)
    
/// 同内置Header，仅与LWGUI共同使用
Title(string group, string header)

/// 绘制float以更改Render Queue
[Queue]

其中函数名带Sub的一般只支持在折叠组下显示，不带Sub的group参数填“_”以在折叠组外显示，另外Decorator与内置Drawer不兼容，比如[Header(string)]只应在不使用Attribute或使用内置Attribute的Property上使用，而在使用LWGUI的Property上应使用[Title(group, string)]，否则显示可能会出错。

平滑法线导入工具（ModelOutlineImporter）（Legacy）

一般的Backface Outline由于是沿法线挤出，会在硬表面模型上产生断裂，为了解决这些问题我开发了平滑的描边法线导入工具。将需要导入平滑法线的模型名称加上后缀名：“_ol”，即可自动应用平滑算法后将法线导入原模型的UV8。Lit的Outline需与此工具配套使用，详情可以参考此文章。

Reference

Resources used by this repository, if you think I violated your interests, please contact me ([email protected]).