内置宏

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

目标平台

此外，当目标着色语言为 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 contains the numeric value of the Unity version. For example, UNITY_VERSION is 202030 for Unity 2020.3.0. This can be used for version comparisons if you need to write Shaders that use different built-in Shader functionality. For example, a #if UNITY_VERSION >= 202000 preprocessor check only passes on versions 2020 or later.

编译的着色器阶段

编译每个着色器阶段时会定义预处理器宏 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

If you use a GPU compute buffer or graphics buffer to set the value of the variables, make sure the buffer and the constant buffer have matching data layouts on all graphics APIs you build for. See Using constant buffers with GPU buffers for more information.

纹理/采样器声明宏

通常，在着色器代码中使用 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 之间。

Note: On DX11/12 and Metal, the Z buffer range is 1–0 and UNITY_REVERSED_Z is defined. On other platforms, the range is 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
        }
    }
}