빌트인 매크로

Unity는 셰이더 프로그램을 컴파일할 때 일부 프리프로세서 매크로를 정의합니다.

타겟 플랫폼

또한 타겟 셰이딩 언어가 GLSL인 경우(OpenGL/GLES 플랫폼에서 항상 참) SHADER_TARGET_GLSL도 정의됩니다.

셰이더(Shader) 타겟 모델

SHADER_TARGET은 셰이더 타겟 컴파일 모델과 일치하는(즉 #pragma target 명령과 일치하는) 숫자 값으로 정의됩니다. 예를 들어, 셰이더 모델 3.0으로 컴파일하는 경우 SHADER_TARGET은 30입니다. 셰이더 코드에서 조건부 확인을 수행하기 위해 사용할 수 있습니다. 예제:

# if SHADER_TARGET < 30
    // less than Shader model 3.0:
    // very limited Shader capabilities, do some approximation
#else
    // decent capabilities, do a better thing
#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) 스테이지

SHADER_STAGE_VERTEX, SHADER_STAGE_FRAGMENT, SHADER_STAGE_DOMAIN, SHADER_STAGE_HULL, SHADER_STAGE_GEOMETRY, SHADER_STAGE_COMPUTE 프리프로세서 매크로는 각 셰이더 스테이지를 컴파일할 때 정의됩니다. 일반적으로 일부 작업을 약간 다르게 수행해야 하는 경우를 처리하기 위해 픽셀 셰이더와 연산 셰이더 코드를 공유해야 하는 경우에 유용합니다.

플랫폼 차이 헬퍼

이 플랫폼 매크로를 직접 사용하는 것은 장래성을 충분히 보장하지 않기 때문에 권장하지 않습니다. 예를 들어 D3D11를 확인하는 셰이더를 작성하는 경우 나중에 확인을 확장하여 Vulkan이 포함되도록 해야 할 수 있습니다. 대신 Unity는 (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.

텍스처/샘플러(Texture/Sampler) 선언 매크로

일반적으로 셰이더 코드에 texture2D를 사용하여 텍스처 및 샘플러 페어를 선언합니다. 하지만 일부 플랫폼(예: DX11)에서는 텍스처와 샘플러가 별도 오브젝트이고, 최대 가능 샘플러 수가 매우 제한적입니다. Unity에는 샘플러 없이 텍스처를 선언하고 다른 텍스처의 샘플러를 사용하여 텍스처를 샘플링하는 매크로가 몇 개 있습니다. 샘플러 제한에 부딪히는 경우 일부 텍스처가 실제로 샘플러를 공유한다는 것을 알고 있다면 매크로를 사용하십시오. (샘플러는 텍스처 필터링 및 래핑 모드를 정의합니다.)

자세한 내용은 샘플러 상태에 대한 문서를 참조하십시오.

표면 셰이더(Surface Shader) 패스 표시

표면 셰이더는 컴파일될 때 다양한 패스를 위한 코드를 많이 생성하여 조명을 수행합니다. 각 패스를 컴파일할 때 다음 매크로 중 하나가 정의됩니다.

자동 업그레이드 비활성화

UNITY_SHADER_NO_UPGRADE를 사용하여 Unity가 셰이더 파일을 자동으로 업그레이드하거나 수정할 수 없도록 설정할 수 있습니다.

뎁스 텍스처 헬퍼 매크로

뎁스 텍스처는 대부분의 경우 카메라에서 뎁스를 렌더링하는 데 사용됩니다. UnityCG.cginc 포함 파일에는 이 사례에서 위의 복잡성을 처리하는 매크로가 몇 개 있습니다.

• UNITY_TRANSFER_DEPTH(o): 버텍스의 아이 스페이스 뎁스를 계산하고 o 로 출력합니다(float2여야 함). 버텍스 프로그램에서 뎁스 텍스처로 렌더할 때 사용합니다. 네이티브 뎁스 텍스처가 있는 플랫폼에서는 Z 버퍼 값이 무조건 렌더링되기 때문에, 매크로는 아무 기능도 수행하지 않습니다.
• UNITY_OUTPUT_DEPTH(i): i 에서 아이 스페이스 뎁스를 반환합니다(float2여야 함). 프래그먼트 프로그램에서 뎁스 텍스처로 렌더할 때 사용합니다. 네이티브 뎁스 텍스처가 있는 플랫폼에서 매크로는 Z 버퍼 값이 무조건 렌더링되기 때문에 항상 0을 반환합니다.
• COMPUTE_EYEDEPTH(i): 버텍스의 아이 스페이스 뎁스를 계산하고 o 로 출력합니다. 버텍스 프로그램에서 뎁스 텍스처로 렌더링하지 않는 경우에 사용합니다.
• DECODE_EYEDEPTH(i)/LinearEyeDepth(i): i 에서 고정밀도 값이 주어지면 해당 아이 스페이스 뎁스를 반환합니다.
• Linear01Depth(i): 뎁스 텍스처 i 에서 고정밀도 값이 주어지면 해당 리니어 뎁스를 0과 1 사이의 범위로 반환합니다.

참고: DX11/12 및 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
        }
    }
}