ShaderLab 커맨드: Stencil

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

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

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

렌더 파이프라인 호환성

사용법

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

You can use the Stencil command to do two different things: to configure the stencil test, and to configure what the GPU writes to the stencil buffer. You can do both of these things in the same command, but the most common use case is to create one Shader object that masks out areas of the screen that other Shader objects cannot draw to. To do this, you need to configure the first Shader object to always pass the stencil test and write to the stencil buffer, and configure the others to perform a stencil test and not write to the stencil buffer.

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

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

(ref & readMask) comparisonFunction (stencilBufferValue & readMask)

유효한 파라미터 값

비교 작업 값

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

스텐실 작업 값

In C#, these values are represented by the Rendering.Rendering.StencilOp enum.

예제

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.
        }
    }
}