Страницы свойств компилятора HLSL

Статья
04/03/2023

Страницы свойств компилятора HLSL (fxc.exe) можно использовать для настройки сборки отдельных файлов шейдера HLSL. Аргументы командной строки также можно указать компилятору HLSL с помощью свойства "Дополнительные параметры" страницы свойств командной строки. Это включает аргументы, которые нельзя настроить с помощью других свойств страниц свойств HLSL. Сведения о компиляторе HLSL см. в разделе Средство компилятора эффектов

Страница общего свойства HLSL

Дополнительные каталоги включаемых файлов

Задает один или несколько каталогов для добавления в качестве пути включения; несколько значений разделяются точками с запятой. (/I[path])

Имя точки входа

Указывает имя точки входа для шейдера (/E[name])

Отключить оптимизацию

Значение Да (/Od) для отключения оптимизаций, в противном случае значение Нет. По умолчанию значение Да (/Od) используется для конфигураций Отладка, а значение Нет — для конфигураций Выпуск.

Аргумент командной строки /Od для компилятора HLSL неявно применяет аргумент командной строки /gfp, однако выходные данные могут не совпадать с выходными данными, создаваемыми при явной передаче обоих аргументов командной строки /Od и /gfp.

Включить сведения об отладке

Значение Да (/Zi) для включения сведений об отладке, в противном случае значение Нет. По умолчанию значение Да (/Zi) используется для конфигураций Отладка, а значение Нет — для конфигураций Выпуск.

Тип шейдера

Указывает вид шейдера. Различные виды шейдеров реализуют различные части графического конвейера. Некоторые виды шейдеров доступны только в более поздних моделях шейдеров (которые указываются свойством Модель шейдера), например, вычислительные шейдеры впервые появились в модели шейдера 5.

Это свойство соответствует части [тип] аргумента командной строки /T [тип]_[модель] для компилятора HLSL. Свойство Модель шейдера указывает часть [модель] этого аргумента.

Варианты

Действие
Шейдер вершин
Построитель текстуры
Шейдер геометрии
Шейдер корпуса
Шейдер домена
Шейдер вычислений
Библиотека
Создание объекта корневой подписи

Модель шейдера

Указывает модель шейдера. Разные модели шейдеров имеют разные возможности. Как правило, последние модели шейдеров предоставляют расширенные возможности, но требуют более современного графического оборудования для выполнения кода шейдеров. Некоторые виды шейдеров (которые указываются свойством Тип шейдера) доступны только в более поздних моделях шейдеров, например, вычислительные шейдеры впервые появились в модели шейдера 5.

Это свойство соответствует части [модель] аргумента командной строки /T [тип]_[модель] для компилятора HLSL. Свойство Тип шейдера указывает часть [тип] этого аргумента.

Все ресурсы привязаны

Компилятор предполагает, что все ресурсы, на которые может ссылаться шейдер, привязаны и находятся в хорошем состоянии в течение длительного выполнения шейдера (/all_resources_bound). Доступно для модели шейдера версии 5.1 и более поздних версий.

Включение несвязанных таблиц дескриптора

Сообщите компилятору, что шейдер может содержать объявление массива ресурсов с несвязанным диапазоном (/enable_unbounded_descriptor_tables). Доступно для модели шейдера версии 5.1 и более поздних версий.

Установка корневой подписи

Присоединение корневой подписи к байткоду шейдера (/setrootsignature). Доступно для модели шейдера версии 5.0 и более поздних версий.

Определения препроцессора

Добавляет одно или несколько определений препроцессора, применяемых к файлу исходного кода HLSL. Для разделения определений символов используйте точку с запятой.

Это свойство соответствует аргументу командной строки /D [определения] для компилятора HLSL.

Компиляция пользовательского шейдера пикселей Direct2D

Компиляция настраиваемого эффекта Direct2D, содержащего построители текстуры. Не используйте его для вершины или настраиваемого эффекта вычисления.

Компиляция нескольких процессоров

Одновременное выполнение нескольких экземпляров.

Страница расширенных свойств

Отключает отображение объявления при загрузке и информационных сообщений. (/nologo)

Обрабатывать предупреждения как ошибки

Интерпретирует все предупреждения компилятора как ошибки. Для нового проекта рекомендуется использовать параметр /WX во всех компиляциях. Разрешение всех предупреждений обеспечит минимальное число трудновыявляемых дефектов кода.

Страница свойств выходных файлов

Имя переменной заголовков

Задает имя переменной в файле заголовка (/Vn [имя])

Имя файла заголовков

Задает имя файла заголовка, содержащего объектный код. (/Fh [имя])

Имя объектного файла

Задает имя объектного файла. (/Fo [имя])

Файл ассемблерного кода

Задает содержимое выходного файла языка сборки. (/Fc, /Fx)