简介

本文总结Unity shader的内置宏。基于Unity 2020.3和Built-in管线。
这里的内置宏包括shader内定义宏和平台相关宏。

一、shader内定义宏

shader内定义宏是指需要由用户手动定义的宏。Unity内置了下面5种命令，用户可以根据需要在不同pass中自行定义。

• multi_compile_fwdbase
• multi_compile_fwdadd
• multi_compile_fwdadd_fullshadows
• multi_compile_fog
• multi_compile_instancing
  下面逐个介绍

1.multi_compile_fwdbase

这个命令应在Forward Base Pass中定义，定义后会引入built-in管线中Forward Base Pass所需要的宏：

2.multi_compile_fwdbase

这个命令应在Forward Add Pass中定义，定义后会引入built-in管线中与光源类型相关的宏：

注1：这里的COOKIE是指灯光是否设置了Cookie属性
注2：为什么SPOT没有对应的Cookie相关宏，因为SPOT本身的形状就是就是通过贴图控制的

3.multi_compile_fwdadd_fullshadows

这个命令应在Forward Add Pass中定义，定义后会引入built-in管线中与光源类型相关的宏以及阴影相关宏：

4.multi_compile_fog

这个命令可以在Forward Base Pass和Forwar Add Pass中定义:

5.multi_compile_instancing

这个命令与GPU Instancing有关，Unity自动的GPU Instancing只在Forward Base Pass启用：

6.shader目标模型

定义#pragma target后会启用SHADER_TARGET宏。SHADER_TARGET与#pragma target所定义的数值相匹配，比如定义为3.0时，SHADER_TARGET值将是30。

二、平台相关宏

平台相关宏是指不需要用户手动定义，根据不同配置自动启用的宏。

1.渲染平台相关

另外，在使用GLSL的平台上会开启SHADER_TARGET_GLSL。

2.Unity版本宏

UNITY_VERSION包含了Unity版本的数值。比如Unity版本为5.0.1，那么UNITY_VERSION的值就是501。

3.着色器阶段宏

包括6个阶段
SHADER_STAGE_VERTEX
SHADER_STAGE_FRAGMENT
SHADER_STAGE_DOMAIN
SHADER_STAGE_HULL
SHADER_STAGE_GEOMETRY
SHADER_STAGE_COMPUTE

4.平台差异相关宏

以下宏由项目设置决定，在shader和C#脚本中均可查看是否启用，C#脚本中由枚举BuiltinShaderDefine定义，可以通过GraphicsSettings.HasShaderDefine接口查询：

注：某些宏的查询并不准，如：UNITY_FRAMEBUFFER_FETCH_AVAILABLE