内置宏

Unity 在编译着色器程序时会定义几个预处理器宏。

目标平台

SHADER_API_MOBILE 是针对所有常规移动平台（GLES、GLES3、METAL）定义的。

此外，当目标着色语言为 GLSL 时，还会定义 SHADER_TARGET_GLSL（对于 OpenGL/GLES 平台来说始终会定义）。

着色器目标模型

SHADER_TARGET 被定义为与着色器目标编译模型匹配的数值（即匹配 #pragma target 指令）。例如，当编译到着色器模型 3.0 时，SHADER_TARGET 为 30。您可以在着色器代码中使用此宏来进行条件检查。例如：

# if SHADER_TARGET < 30
    // 低于着色器模型 3.0：
    // 着色器功能非常有限，执行近似操作
# else
    // 不错的功能，执行更高级的任务
# endif

Unity 版本

UNITY_VERSION 包含 Unity 版本的数值。例如，对于 Unity 5.0.1，UNITY_VERSION 为 501。如果您需要编写使用不同着色器内置功能的着色器，则可以将其用于版本比较。例如，#if UNITY_VERSION >= 500 预处理器检查仅在版本为 5.0.0 或更高时可以通过。

编译的着色器阶段

编译每个着色器阶段时会定义预处理器宏 SHADER_STAGE_VERTEX、SHADER_STAGE_FRAGMENT、SHADER_STAGE_DOMAIN、SHADER_STAGE_HULL、SHADER_STAGE_GEOMETRY 或 SHADER_STAGE_COMPUTE。通常，在像素着色器和计算着色器之间共享着色器代码时，这些宏非常有用，可以解决某些工作必须以略有不同的方式来完成的情况。

平台差异 helper

不鼓励直接使用这些平台宏，因为它们并非始终有助于代码的未来验证。例如，如果您正在编写一个检查 D3D11 的着色器，您可能希望确保在将来将这项检查扩展为包含 Vulkan。应改用 Unity 定义的几个 helper 宏（在 HLSLSupport.cginc 中）：

• UNITY_REVERSED_Z - 在使用反转 Z 缓冲区的平台上定义。存储的 Z 值的范围是 1 到 0，而不是 0 到 1。

阴影贴图宏

根据平台的不同，声明和采样阴影贴图可能会有很大差异。Unity 有几个宏可帮助解决这个问题：

注意：并非所有显卡都支持阴影贴图。请使用 SystemInfo.SupportsRenderTextureFormat 检查是否支持。

常量缓冲区宏

Direct3D 11 将所有着色器变量分组为“常量缓冲区”。Unity 的大多数内置变量已经分组，但对于您自己的着色器中的变量，更加理想的做法是，根据预期的更新频率将它们放入单独的常量缓冲区。

对此，请使用 CBUFFER_START(name) 和 CBUFFER_END 宏：

CBUFFER_START(MyRarelyUpdatedVariables)
    float4 _SomeGlobalValue;
CBUFFER_END

纹理/采样器声明宏

通常，在着色器代码中使用 texture2D 来声明纹理和采样器对。 但是在某些平台（例如 DX11）上，纹理和采样器是单独的对象， 并且可能的采样器最大数量非常有限。Unity 有一些宏来声明 没有采样器的纹理，并使用另一个纹理中的采样器对纹理进行采样。 如果您遇到采样器限制，并且知道几个纹理实际上可以共享同一个采样器 （采样器定义纹理过滤和包裹模式），请使用这些宏。

有关更多信息，请参阅采样器状态文档。

表面着色器通道指示符

编译表面着色器时，表面着色器会为各种通道生成大量代码以产生光照。编译每个通道时，将定义以下宏之一：

禁用自动升级

UNITY_SHADER_NO_UPGRADE 允许您禁止 Unity 自动升级或修改着色器文件。

深度纹理 helper 宏

大多数情况下，深度纹理用于渲染距离摄像机的深度。在此情况下，UnityCG.cginc include 文件包含的一些宏可以处理上述复杂问题：

• UNITY_TRANSFER_DEPTH(o)：计算顶点的眼睛空间深度并将其在 o 中输出（必须是 float2）。当渲染到深度纹理时，在顶点程序中使用此宏。在具有本机深度纹理的平台上，此宏完全不执行任何操作，因为 Z 缓冲区值是隐式渲染的。
• UNITY_OUTPUT_DEPTH(i)：从 i 返回眼睛空间深度（必须为 float2）。当渲染到深度纹理时，在片元程序中使用此宏。在具有本机深度纹理的平台上，此宏始终返回零，因为 Z 缓冲区值是隐式渲染的。
• COMPUTE_EYEDEPTH(i)：计算顶点的眼睛空间深度并将其在 o 中输出。当不渲染到深度纹理时，在顶点程序中使用此宏。
• DECODE_EYEDEPTH(i)/LinearEyeDepth(i)：通过深度纹理 i 给出高精度值时，返回相应的眼睛空间深度。
• Linear01Depth(i)：通过深度纹理 i 给出高精度值时，返回相应的线性深度，范围在 0 到 1 之间。

注意：在 DX11/12、PS4、XboxOne 和 Metal 中，Z 缓冲区范围是 1 到 0，并定义了 UNITY_REVERSED_Z。在其他平台上，范围是 0 到 1。

例如，以下着色器将渲染其游戏对象的深度：

Shader "Render Depth" {
    SubShader {
        Tags { "RenderType"="Opaque" }
        Pass {
            CGPROGRAM

            #pragma vertex vert
            #pragma fragment frag
            #include "UnityCG.cginc"

            struct v2f {
                float4 pos : SV_POSITION;
                float2 depth : TEXCOORD0;
            };

            v2f vert (appdata_base v) {
                v2f o;
                o.pos = UnityObjectToClipPos(v.vertex);
                UNITY_TRANSFER_DEPTH(o.depth);
                return o;
            }

            half4 frag(v2f i) : SV_Target {
                UNITY_OUTPUT_DEPTH(i.depth);
            }
            ENDCG
        }
    }
}