HLSL 컴파일러 속성 페이지

아티클
04/03/2023

HLSL 컴파일러(fxc.exe) 속성 페이지를 사용하여 개별 HLSL 셰이더 파일을 빌드하는 방법을 구성할 수 있습니다. 명령줄 속성 페이지의 추가 옵션 속성을 사용하여 HLSL 컴파일러에 명령줄 인수를 지정할 수도 있습니다. 여기에는 HLSL 속성 페이지의 다른 속성을 사용하여 구성할 수 없는 인수가 포함됩니다. HLSL 컴파일러에 대한 자세한 내용은 효과-컴파일러 도구를 참조하세요.

HLSL 일반 속성 페이지

추가 포함 디렉터리

포함 경로에 추가할 디렉터리를 하나 이상 지정합니다. 항목이 여러 개일 때에는 세미콜론으로 구분합니다. (/I[path])

진입점 이름

셰이더의 진입점 이름(/E[name])을 지정합니다.

최적화 비활성화

최적화를 사용하지 않도록 설정하려면 예(/Od)이고, 사용하도록 설정하려면 아니요입니다. 기본적으로 디버그 구성에 대한 값은 예(/Od)이고 릴리스 구성에 대한 값은 아니요입니다.

HLSL 컴파일러에 대한 /Od 명령줄 인수가 암시적으로 /Gfp 명령줄 인수에 적용되지만 출력은 /Od 및 /Gfp 명령줄 인수 둘 다 명시적으로 전달하여 생성된 출력과 동일하지 않을 수 있습니다.

디버깅 정보 사용

디버깅 정보를 사용하도록 설정 하려면 예(/Zi)이고 사용하지 않도록 설정하려면 아니요입니다. 기본적으로 디버그 구성에 대한 값은 예(/Zi)이고 릴리스 구성에 대한 값은 아니요입니다.

셰이더 형식

셰이더 종류를 지정합니다. 다양한 종류의 셰이더는 그래픽 파이프라인의 다른 파트를 구현합니다. 특정 종류의 셰이더는 Shader Model 속성에서 지정하는 최신 셰이더 모델에서만 사용할 수 있습니다(예: 셰이더 모델 5에 컴퓨팅 셰이더가 도입됐습니다).

이 속성은 HLSL 컴파일러에 대한 /T [type]_[model] 명령줄 인수의 [type] 부분에 해당합니다. 셰이더 모델 속성은 인수의 [model] 부분을 지정합니다.

Choices

효과
꼭짓점 셰이더
픽셀 셰이더
기하 도형 셰이더
헐 셰이더
도메인 셰이더
컴퓨팅 셰이더
라이브러리
루트 서명 개체 생성

셰이더 모델

셰이더 모델을 지정합니다. 다양한 셰이더 모델은 기능이 다양합니다. 일반적으로 최신 셰이더 모델은 기능을 확장했지만 셰이더 코드를 실행하려면 최신 그래픽 하드웨어를 필요로 합니다. 셰이더 형식 속성에서 지정하는 특정 종류의 셰이더는 최신 셰이더 모델에서만 사용할 수 있습니다(예: 셰이더 모델 5에 컴퓨팅 셰이더가 도입됐습니다).

이 속성은 HLSL 컴파일러에 대한 /T [type]_[model] 명령줄 인수의 [model] 부분에 해당합니다. 셰이더 형식 속성은 인수의 [type] 부분을 지정합니다.

모든 리소스 바인딩

컴파일러는 셰이더가 참조할 수 있는 모든 리소스가 바인딩되어 있고 셰이더 실행 기간 동안 양호한 상태라고 가정합니다(/all_resources_bound). 셰이더 모델 5.1 이상에 사용할 수 있습니다.

바인딩되지 않은 설명자 테이블 사용

셰이더에 바인딩되지 않은 범위(/enable_unbounded_descriptor_tables)가 있는 리소스 배열의 선언이 포함될 수 있음을 컴파일러에 알릴 수 있습니다. 셰이더 모델 5.1 이상에 사용할 수 있습니다.

루트 서명 설정

셰이더 바이트코드(/setrootsignature)에 루트 서명을 연결합니다. 셰이더 모델 5.0 이상에 사용할 수 있습니다.

전처리기 정의

HLSL 소스 코드 파일에 적용할 하나 이상의 전처리기 기호 정의를 추가합니다. 기호 정의를 구분하려면 세미콜론을 사용합니다.

이 속성은 HLSL 컴파일러에 대한 /D [definitions] 명령줄 인수에 해당합니다.

Direct2D 사용자 지정 픽셀 셰이더 효과 컴파일

픽셀 셰이더가 포함된 Direct2D 사용자 지정 효과를 컴파일합니다. 꼭짓점 또는 컴퓨팅 사용자 지정 효과에는 사용하지 마세요.

다중 프로세서 컴파일

동시에 여러 인스턴스를 실행합니다.

고급 속성 페이지

시작 배너 및 정보 메시지를 표시하지 않습니다. (/nologo)

경고를 오류로 처리

모든 컴파일러 경고를 오류로 처리합니다. 새 프로젝트인 경우 모든 컴파일에서/WX를 사용하는 것이 좋습니다. 모든 경고를 해결하면 찾기 어려운 코드 오류를 최소화할 수 있습니다.

출력 파일 속성 페이지

헤더 변수 이름

헤더 파일의 변수 이름(/Vn [name])을 지정합니다.

헤더 파일 이름

개체 코드를 포함하는 헤더 파일의 이름을 지정합니다. (/Fh [name])

개체 파일 이름

개체 파일의 이름을 지정합니다. (/Fo [name])

어셈블러 출력

어셈블리 언어 출력 파일의 콘텐츠를 지정합니다. (/Fc, /Fx)