ShaderLab 命令：模板

配置与 GPU 上的模板缓冲区相关的设置。

模板缓冲区为帧缓冲区中的每个像素存储一个 8 位整数值。为给定像素执行片元着色器之前，GPU 可以将模板缓冲区中的当前值与给定参考值进行比较。这称为模板测试。如果模板测试通过，则 GPU 会执行深度测试。如果模板测试失败，则 GPU 会跳过对该像素的其余处理。这意味着可以使用模板缓冲区作为遮罩来告知 GPU 要绘制的像素以及要丢弃的像素。

通常会将模板缓冲区用于特殊效果，例如门户或镜子。此外，在渲染硬阴影或者构造型实体几何 (CSG) 时，有时会使用模板缓冲区。

渲染管线兼容性

用法

此命令会更改渲染状态。在 Pass 代码块中使用它可为该通道设置渲染状态，或者在 SubShader 代码块中使用它可为该子着色器中的所有通道设置渲染状态。

可以使用 Stencil 命令执行两种不同的操作：配置模板测试，以及配置 GPU 写入模板缓冲区的内容。可以在同一个命令中执行这两种操作，但最常见的用例是创建一个 Shader 对象，该对象会遮罩其他 Shader 对象无法绘制到的屏幕区域。为此，需要将第一个 Shader 对象配置为始终通过模板测试并写入模板缓冲区，并将其他对象配置为执行模板测试而不写入模板缓冲区。

使用 Ref、ReadMask 和 Comp 参数可配置模板测试。使用 Ref、WriteMask、Pass、Fail 和 ZFail 参数可配置模板写入操作。

模板测试方程为：

(ref & readMask) comparisonFunction (stencilBufferValue & readMask)

有效参数值

比较操作值

在 C# 中，这些值通过 Rendering.CompareFunction 枚举进行表示。

模板操作值

在 C# 中，这些值通过 Rendering.Rendering.StencilOp 枚举进行表示。

示例

Shader "Examples/CommandExample"
{
    SubShader
    {
         // 此处是定义子着色器的代码的其余部分。

        Pass
        {    
             // 此通道中的所有像素都会通过模板测试并将值 2 写入模板缓冲区
             // 如果要防止后续着色器绘制到渲染目标的此区域或将它们限制为仅渲染到此区域，则通常会执行此操作
             Stencil
             {
                 Ref 2
                 Comp Always
                 Pass Replace
             }            

             // 此处是定义通道的代码的其余部分。
        }
    }
}

此示例代码演示在 SubShader 代码块中使用此命令的语法。

Shader "Examples/CommandExample"
{
    SubShader
    {
             // 仅当模板缓冲区的当前值小于 2 时，此子着色器中的所有像素才通过模板测试
             // 如果希望仅绘制到渲染目标中未"遮罩"的区域，则通常会执行此操作
             Stencil
             {
                 Ref 2
                 Comp Less
             }  

         // 此处是定义子着色器的代码的其余部分。

        Pass
        {    
              // 此处是定义通道的代码的其余部分。
        }
    }
}