Páginas de propriedades do compilador do HLSL

Artigo
04/03/2023

Use as páginas de propriedades do compilador HLSL (fxc.exe) para configurar como os arquivos individuais do sombreador HLSL são criados. Especifique também argumentos de linha de comando para o compilador do HLSL usando a propriedade Opções Adicionais da página de propriedades da Linha de Comando; isso inclui argumentos que não podem ser configurados usando outras propriedades das páginas de propriedades do HLSL. Para obter informações sobre o compilador HLSL, confira Ferramenta Compilador de Efeitos

Página de propriedades gerais do HLSL

Diretórios de Inclusão Adicionais

Especifica um ou mais diretórios a serem adicionados ao caminho de inclusão, separados por ponto e vírgula no caso de mais de um. (/I[path])

Nome do Ponto de Entrada

Especifica o nome do ponto de entrada para o sombreador (/E[name])

Desabilitar otimizações

Sim (/Od) para desabilitar as otimizações; caso contrário, Não. Por padrão, o valor é Sim (/Od) para configurações de Depuração e Não para configurações de Versão.

O argumento de linha de comando /Od para o compilador HLSL aplica implicitamente o argumento de linha de comando /Gfp, mas a saída pode não ser idêntica à saída produzida ao passar os argumentos de linha de comando /Od e /Gfp explicitamente.

Habilitar informações de depuração

Sim (/Zi) para habilitar as informações de depuração; caso contrário, Não. Por padrão, o valor é Sim (/Zi) para configurações de Depuração e Não para configurações de Versão.

Tipo de Sombreador

Especifica o tipo de sombreador. Diferentes tipos de sombreadores implementam diferentes partes do pipeline gráfico. Alguns tipos de sombreadores estão disponíveis apenas em modelos de sombreador mais recentes (que são especificados pela propriedade Modelo de Sombreador) – por exemplo, sombreadores de computação foram introduzidos no modelo de sombreador 5.

Essa propriedade corresponde à parte [type] do argumento de linha de comando /T [type]_[model] para o compilador HLSL. A propriedade Modelos de Sombreador especifica a parte [model] do argumento.

Opções

Efeito
Sombreador de vértice
Sombreador de pixel
Sombreador de geometria
Sombreador de casco
Sombreador de domínio
Sombreador de Computação
Biblioteca
Gerar Objeto de Assinatura Raiz

Modelo de Sombreador

Especifica o modelo de sombreador. Diferentes modelos de sombreador têm diferentes funcionalidades. Em geral, modelos de sombreador mais recentes oferecem funcionalidades expandidas, mas exigem um hardware de elementos gráficos mais moderno para executar o código do sombreador. Alguns tipos de sombreadores (que são especificados pela propriedade Tipo de Sombreador) estão disponíveis apenas em modelos de sombreador mais recentes – por exemplo, sombreadores de computação foram introduzidos no modelo de sombreador 5.

Essa propriedade corresponde à parte [model] do argumento de linha de comando /T [type]_[model] para o compilador HLSL. A propriedade Tipo de Sombreador especifica a parte [type] do argumento.

Todos os recursos associados

O compilador presumirá que todos os recursos aos quais um sombreador pode fazer referência estão associados e em bom estado para toda a execução do sombreador (/all_resources_bound). Disponível para Shader Model 5.1 e posterior.

Habilitar tabelas de descritor não associadas

Informar ao compilador que um sombreador pode conter uma declaração de uma matriz de recursos com intervalo não associado (/enable_unbounded_descriptor_tables). Disponível para Shader Model 5.1 e posterior.

Definir Assinatura Raiz

Anexar a assinatura raiz ao código de bytes do sombreador (/setrootsignature). Disponível para Shader Model 5.0 e posterior.

Definições do Pré-processador

Adiciona uma ou mais definições de símbolo do pré-processador a serem aplicadas ao arquivo de código-fonte HLSL. Use ponto-e-vírgula para separar as definições de símbolo.

Essa propriedade corresponde ao argumento de linha de comando /D [definitions] para o compilador HLSL.

Compilar um efeito de sombreador de pixel personalizado do Direct2D

Compile um efeito personalizado Direct2D que contém sombreadores de pixel. Não use um vértice ou efeito personalizado de computação.

Compilação multiprocessador

Executar várias instâncias ao mesmo tempo.

Página de propriedades avançadas

Suprime a exibição da faixa de inicialização e das mensagens informativas. (/nologo)

Tratar avisos como erros

Trata todos os avisos do compilador como erros. Para um novo projeto, talvez seja melhor usar /WX em todas as compilações. Resolver todos os avisos assegurará o menor número possível de defeitos de código difíceis de localizar.

Página de propriedades de Arquivos de Saída

Nome da Variável de Cabeçalho

Especifica um nome para o nome de variável no arquivo de cabeçalho (/Vn [name])

Nome do Arquivo de Cabeçalho

Especifica um nome para um arquivo de cabeçalho que contém código objeto. (/Fh [nome])

Nome do arquivo-objeto

Especifica um nome para o arquivo-objeto. (/Fo [name])

Saída do Assembler

Especifica o conteúdo do arquivo de saída de linguagem assembly. (/Fc, /Fx)