ShaderLab 커맨드: Stencil

GPU의 스텐실 버퍼와 관련된 설정을 구성합니다.

스텐실 버퍼는 프레임 버퍼의 모든 픽셀에 대해 8비트 정수 값을 저장합니다. 특정 픽셀의 프래그먼트 셰이더를 실행하기 전에 GPU는 스텐실 버퍼의 현재 값을 특정한 레퍼런스 값과 비교할 수 있습니다. 이를 스텐실 테스트라고 합니다. 스텐실 테스트에 통과하면 GPU가 뎁스 테스트를 수행합니다. 스텐실 테스트에 실패하면 GPU가 해당 픽셀의 나머지 처리를 건너뜁니다. 즉, 스텐실 버퍼를 마스크로 사용하여 GPU에 드로우할 픽셀과 폐기할 픽셀을 지시할 수 있습니다.

스텐실 버퍼는 일반적으로 포털이나 미러와 같은 특수효과에 사용합니다. 또한 간혹 하드 섀도우 렌더링 또는 구조적 입체 지오메트리(CSG)에 스텐실 버퍼를 사용하기도 합니다.

렌더 파이프라인 호환성

사용법

이 커맨드는 렌더 상태를 변경합니다. Pass 블록에서 사용하여 해당 패스의 렌더 상태를 설정하거나, SubShader 블록에서 사용하여 해당 서브셰이더에 있는 모든 패스의 렌더 상태를 설정할 수 있습니다.

Stencil 커맨드를 사용하여 두 가지를 작업을 수행할 수 있습니다. 하나는 스텐실 테스트 설정이며, 다른 하나는 GPU가 스텐실 버퍼에 작성하는 내용 설정입니다. 같은 커맨드에서 이 두 가지를 모두 수행할 수 있으나, 가장 일반적인 사용 사례는 다른 셰이더 오브젝트가 드로우할 수 없도록 일부 화면 영역을 마스크하는 셰이더 오브젝트를 만드는 것입니다. 이를 수행하려면 첫 셰이더 오브젝트가 항상 스텐실 테스트를 통과하도록 설정하고, 나머지 셰이더 오브젝트가 스텐실 테스트를 수행하고 스텐실 버퍼에 작성하지 않도록 설정해야 합니다.

Ref, ReadMask 및 Comp 파라미터를 사용하여 스텐실 테스트를 설정하십시오. Ref, WriteMask, Pass, Fail 및 ZFail 파라미터를 사용하여 스텐실 작성 작업을 설정하십시오.

스텐실 테스트 등식은 다음과 같습니다.

(ref & readMask) comparisonFunction (stencilBufferValue & readMask)

유효한 파라미터 값

비교 작업 값

C#에서 이러한 값은 Rendering.CompareFunction](../ScriptReference/Rendering.CompareFunction.html) 열거형으로 표시됩니다.

스텐실 작업 값

C#에서 이러한 값은 Rendering.Rendering.StencilOp 열거형으로 표시됩니다.

예제

Shader "Examples/CommandExample"
{
    SubShader
    {
         // The rest of the code that defines the SubShader goes here.

        Pass
        {    
             // All pixels in this Pass will pass the stencil test and write a value of 2 to the stencil buffer
             // You would typically do this if you wanted to prevent subsequent shaders from drawing to this area of the render target or restrict them to render to this area only
             Stencil
             {
                 Ref 2
                 Comp Always
                 Pass Replace
             }            

             // The rest of the code that defines the Pass goes here.
        }
    }
}

이 예제 코드는 SubShader 블록에서 이 커맨드를 사용하기 위한 구문을 나타냅니다.

Shader "Examples/CommandExample"
{
    SubShader
    {
             // All pixels in this SubShader pass the stencil test only if the current value of the stencil buffer is less than 2
             // You would typically do this if you wanted to only draw to areas of the render target that were not "masked out"
             Stencil
             {
                 Ref 2
                 Comp Less
             }  

         // The rest of the code that defines the SubShader goes here.        

        Pass
        {    
              // The rest of the code that defines the Pass goes here.
        }
    }
}