Páginas de propiedades del compilador HLSL

Artículo
04/03/2023

Las páginas de propiedades del compilador HLSL (fxc.exe) se pueden usar para configurar cómo se compilan los archivos individuales del sombreador HLSL. Puede especificar los argumentos de la línea de comandos para el compilador HLSL mediante la propiedad Opciones adicionales de la página de propiedades Línea de comandos; esto incluye argumentos que no se pueden configurar mediante otras propiedades de las páginas de propiedades de HLSL. Para obtener información sobre el compilador HLSL, vea Effect-Compiler Tool (Herramienta Compilador de efectos)

Página de propiedades general de HLSL

Directorios de inclusión adicionales

Especifica uno o más directorios que se agregarán a la ruta de acceso de inclusión; si hay más de uno, sepárelos mediante punto y coma. (/I[path])

Nombre del punto de entrada

Especifica el nombre del punto de entrada para el sombreador (/E[name])

Deshabilite las optimizaciones

Sí (/Od) para deshabilitar las optimizaciones; de lo contrario, No. De forma predeterminada, el valor es Sí (/Od) para las configuraciones Debug y No para las configuraciones Release.

El argumento de la línea de comandos /Od para el compilador HLSL aplica implícitamente el argumento de la línea de comandos /Gfp, pero la salida no puede ser idéntico a la que se genera al pasar los dos argumentos de la línea de comandos /Od y /Gfp de forma explícita.

Habilite la información de depuración

Sí (/Zi) para habilitar la información de depuración; en caso contrario, No. De forma predeterminada, el valor es Sí (/Zi) para las configuraciones Debug y No para las configuraciones Release.

Tipo de sombreador

Especifica el tipo de sombreador. Cada tipo de sombreador implementa partes diferentes de la canalización de gráficos. Algunos tipos de sombreadores solo están disponibles en los modelos de sombreador más recientes (que se especifican mediante la propiedad Modelo de sombreador); por ejemplo, los sombreadores de cálculo se introdujeron en el modelo de sombreador 5.

Esta propiedad se corresponde con la parte [tipo] del argumento de la línea de comandos /T [tipo]_[modelo] para el compilador HLSL. La propiedad Modelos de sombreador especifica la parte [modelo] del argumento.

Choices

Efecto
Sombreador de vértices
Sombreador de píxeles
Sombreador de geometría
Sombreador de casco
Sombreador de dominio
Sombreador de cálculo
Library
Generar el objeto de firma raíz

Modelo de sombreador

Especifica el modelo de sombreador. Cada modelo de sombreador tiene funciones distintas. Por lo general, los modelos de sombreador más recientes ofrecen funciones ampliadas pero requieren hardware gráfico más moderno para ejecutar el código del sombreador. Algunos tipos de sombreadores (que se especifican mediante la propiedad Modelo de sombreador) solo están disponibles en los modelos de sombreador más recientes; por ejemplo, los sombreadores de cálculo se introdujeron en el modelo de sombreador 5.

Esta propiedad se corresponde con la parte [modelo] del argumento de la línea de comandos /T [tipo]_[modelo] para el compilador HLSL. La propiedad Tipo de sombreador especifica la parte [tipo] del argumento.

Todos los recursos enlazados

El compilador supondrá que todos los recursos a los que puede hacer referencia un sombreador están enlazados y en buen estado durante toda la duración de la ejecución del sombreador (/all_resources_bound). Disponible para Shader Model 5.1 y versiones superiores.

Habilitar las tablas de descriptores sin enlazar

Informe al compilador que un sombreador puede contener una declaración de una matriz de recursos con rango no limitado (/enable_unbounded_descriptor_tables). Disponible para Shader Model 5.1 y versiones superiores.

Establecer la firma raíz

Adjunte la firma raíz al código de bytes del sombreador de píxeles (/setrootsignature). Disponible para Shader Model 5.0 y versiones superiores.

Definiciones de preprocesador

Agrega una o varias definiciones de símbolo de preprocesador para aplicar al archivo de código fuente HLSL. Use punto y coma para separar las definiciones de símbolo.

Esta propiedad se corresponde con el argumento de la línea de comandos /D [definiciones] para el compilador HLSL.

Compile un efecto de sombreador de píxeles personalizado de Direct2D

Compile un efecto personalizado de Direct2D que contenga sombreadores de píxeles. No lo use para un efecto personalizado de proceso o vértice.

Compilación multiprocesador

Ejecuta varias instancias a la vez.

Página de propiedades Avanzadas

Suprime la presentación de la pancarta de inicio y los mensajes de información. (/nologo)

Tratar advertencias como errores

Trata todas las advertencias del compilador como errores. Para un proyecto nuevo, puede ser mejor usar /WX en todas las compilaciones. Resolver todas las advertencias es una forma de asegurar el menor número posible de defectos de código difíciles de encontrar.

Página de propiedades los archivos de salida

Nombre de variable de encabezado

Especifica un nombre de variable en el archivo de encabezado (/Vn [name])

Nombre de archivo de encabezado

Especifica un nombre para el archivo de encabezado que contiene código de objeto. (/Fh [name])

Nombre de archivo objeto

Especifica un nombre para el archivo objeto. (/Fo [name])

Resultados de ensamblado

Especifica el contenido del archivo de salida del lenguaje de ensamblado. (/Fc, /Fx)