HLSL로 셰이더 모델 및 GPU 기능 타게팅

#pragma 지시문을 사용하여 셰이더가 특정한 GPU 기능을 요구함을 나타낼 수 있습니다. 런타임 시 Unity는 이 정보를 사용하여 셰이더 프로그램이 현재 하드웨어와 호환되는지 여부를 파악합니다.

#pragma require 지시문으로 개별 GPU 기능을 지정하거나, #pragma target 지시문으로 셰이더 모델을 지정할 수 있습니다. 셰이더 모델은 여러 GPU 기능의 단축이며, 내부적으로는 같은 기능 리스트가 있는 #pragma require 지시문과 동일합니다.

셰이더가 필요로 하는 GPU 기능을 올바르게 설명하는 것이 중요합니다. 셰이더가 요구 사항 리스트에 포함되지 않은 기능을 사용하는 경우, 컴파일 시간 오류가 발생하거나 기기가 런타임 시 셰이더를 지원하지 못할 수 있습니다.

기본 동작

기본적으로 Unity는 #pragma require derivatives로 셰이더를 컴파일합니다. 이는 #pragma target 2.5에 해당합니다.

셰이더 단계를 위한 특수 요구 사항

셰이더가 특정한 셰이더 단계를 정의하는 경우, Unity는 요구 사항 리스트에 자동으로 항목을 추가합니다.

• 셰이더가 지오메트리 단계를 정의하는 경우(#pragma geometry로), Unity는 요구 사항 리스트에 자동으로 geometry를 추가합니다.
• 셰이더가 테셀레이션 단계를 정의하는 경우(#pragma hull 또는 #pragma domain으로), Unity는 요구 사항 리스트에 자동으로 tessellation을 추가합니다.

요구 사항 리스트(또는 동등한 타겟 값)가 이러한 값을 이미 포함하지 않는 경우, Unity는 셰이더를 컴파일할 때 경고 메시지를 표시하여 이러한 요구 사항을 추가했음을 나타냅니다. 이 경고 메시지가 표시되지 않게 하려면 요구 사항을 명시적으로 추가하거나 코드에서 적절한 타겟 값을 사용하십시오.

GPU 기능 또는 셰이더 모델 지정

필수 기능을 지정하려면 예를 들어 다음과 같이 #pragma require 지시문과 함께 공백으로 구분된 값 리스트를 사용하십시오.

# pragma require integers mrt8

#pragma require 지시문과 함께 콜론과 공백으로 구분된 셰이더 키워드 리스트를 사용할 수도 있습니다. 이는 해당 요구 사항이 주어진 키워드가 활성화된 경우에 사용되는 배리언트에만 적용됨을 나타냅니다.

예제:

# pragma require integers mrt8 : EXAMPLE_KEYWORD OTHER_EXAMPLE_KEYWORD

여러 개의 #pragma require 줄을 사용할 수 있습니다. 이 예제에서는 셰이더가 모든 경우에 integers를 요구하며, mrt8 if EXAMPLE_KEYWORD가 활성화되었습니다.

# pragma require integers
# pragma require integers mrt8 : EXAMPLE_KEYWORD

셰이더 모델을 지정하려면 예를 들어 다음과 같이 #pragma target 지시문을 사용하십시오.

# pragma target 4.0

#pragma target 지시문과 함께 공백으로 구분된 셰이더 키워드 리스트를 사용할 수도 있습니다. 이는 해당 요구 사항이 주어진 키워드가 활성화된 경우에 사용되는 배리언트에만 적용됨을 나타냅니다.

예제:

# pragma target 4.0 EXAMPLE_KEYWORD OTHER_EXAMPLE_KEYWORD

참고: #pragma require의 키워드를 지정하는 구문과 #pragma target의 키워드를 지정하는 구문은 약간 다릅니다. #pragma require의 키워드를 지정할 때는 콜론을 사용해야 합니다. #pragma target의 키워드를 지정할 때는 콜론을 사용하지 않습니다.

‘#pragma target’ 값 리스트

다음은 Unity가 사용하는 셰이더 모델의 리스트와, 각 셰이더 모델이 상응하는 #pragma require 값의 조합입니다.

참고: Unity의 셰이더 모델은 DirextX 셰이더 모델 및 OpenGL 버전 요구 사항과 비슷하나, 정확히 상응하지는 않습니다. 설명을 잘 읽고 그 차이점을 이해하십시오.

콘솔 플랫폼의 셰이더 모델 지원에 대한 내용은 각 플랫폼의 문서를 참조하십시오.

참고:

• DirectX 정의에서 셰이더 모델 4.0은 mrt8을 포함하며, 셰이더 모델 5.0은 interpolators32 및 cubearray를 포함합니다. Unity는 보다 폭넓은 호환성을 위해 이러한 기능을 포함하지 않습니다. 이러한 기능을 요구하려면 명시적인 #pragma require 지시문을 사용하십시오.
• geometry를 요구하는 타겟을 사용하지만 셰이더가 지오메트리 단계를 정의하지 않는 경우, Unity는 컴파일 시 요구 사항 리스트에서 geometry를 제거합니다.
• tessellation을 요구하는 타겟을 사용하지만 셰이더가 헐 또는 도메인 단계를 정의하지 않는 경우, Unity는 컴파일 시 요구 사항 리스트에서 tessellation을 제거합니다.

‘#pragma require’ 값 리스트

다음은 #pragma require 지시문에 대해 유효한 모든 값입니다.