Semântica

Uma semântica é uma cadeia de caracteres anexada a uma entrada ou saída de sombreador que transmite informações sobre o uso pretendido de um parâmetro. A semântica é necessária em todas as variáveis passadas entre os estágios do sombreador. A sintaxe para adicionar uma semântica a uma variável de sombreador é mostrada aqui (sintaxe variável (DirectX HLSL)).

Em geral, os dados passados entre estágios de pipeline são completamente genéricos e não são interpretados exclusivamente pelo sistema; semântica arbitrária é permitida que não têm nenhum significado especial. Parâmetros (no Direct3D 10 e posterior) que contêm essas semânticas especiais são conhecidos como System-Value Semântica.

Semântica com suporte no Direct3D 9 e Direct3D 10 e posterior

Os seguintes tipos de semântica têm suporte no Direct3D 9 e no Direct3D 10 e posterior.

• Semântica do Sombreador de Vértice
• semântica do sombreador de pixel

Semântica do Sombreador de Vértice

Essas semânticas têm significado quando anexadas a um parâmetro de sombreador de vértice. Essas semânticas têm suporte no Direct3D 9 e no Direct3D 10 e posterior.

n é um inteiro opcional entre 0 e o número de recursos com suporte. Por exemplo, POSITION0, TEXCOORD1 etc.

Semântica do Sombreador de Pixel

Essas semânticas têm significado quando anexadas a um parâmetro de entrada de sombreador de pixel. Essas semânticas têm suporte no Direct3D 9 e no Direct3D 10 e posterior.

n é um inteiro opcional entre 0 e o número de recursos com suporte. Por exemplo, PSIZE0, COLOR1 etc.

A semântica COLOR só é válida no modo de compatibilidade do sombreador (ou seja, quando o sombreador é criado usando D3D10_SHADER_ENABLE_BACKWARDS_COMPATIBILITY).

Semântica com suporte apenas para Direct3D 10 e Mais Recente.

Os seguintes tipos de semântica foram introduzidos recentemente para o Direct3D 10 e não estão disponíveis para o Direct3D 9.

• semânticaSystem-Value

Semântica System-Value

A semântica de valor do sistema é nova no Direct3D 10. Todos os valores do sistema começam com um prefixo SV_, um exemplo comum é SV_POSITION, que é interpretado pelo estágio do rasterizador. Os valores do sistema são válidos em outras partes do pipeline. Por exemplo, SV_Position pode ser especificado como uma entrada para um sombreador de vértice, bem como uma saída. Sombreadores de pixel só podem gravar em parâmetros com a semântica SV_Depth e SV_Target valor do sistema.

Outros valores do sistema (SV_VertexID, SV_InstanceID, SV_IsFrontFace) só podem ser inseridos no primeiro sombreador ativo no pipeline que pode interpretar o valor específico; depois disso, a função de sombreador deve passar os valores para estágios subsequentes.

SV_PrimitiveID é uma exceção a essa regra de ser apenas a entrada no primeiro sombreador ativo no pipeline que pode interpretar o valor específico; o hardware pode fornecer o mesmo valor de ID que a entrada para o estágio do sombreador de casco, o estágio do sombreador de domínio e, depois desse estágio, qualquer estágio habilitado: estágio de sombreador de geometria ou estágio de sombreador de pixels.

Se o mosaico estiver habilitado, o estágio do sombreador de casco e o estágio do sombreador de domínio estarão presentes. Para um determinado patch, o mesmo PrimitiveID aplica-se à invocação de sombreador de casco do patch e a todas as invocações de sombreador de domínio com mosaico. O mesmo PrimitiveID também se propaga para o próximo estágio ativo; estágio de sombreador de geometria ou estágio de sombreador de pixel, se habilitado.

Se as entradas do sombreador de geometria SV_PrimitiveID e, como ele pode gerar zero ou um ou mais primitivos por invocação, o sombreador deverá programar sua própria escolha de SV_PrimitiveID valor para cada primitivo de saída se um sombreador de pixel subsequente entrar SV_PrimtiveID.

Como outro exemplo, SV_PrimitiveID não pode ser interpretado pelo estágio de sombreador de vértice porque um vértice pode ser um membro de vários primitivos.

Essas semânticas foram adicionadas ao Direct3D 10; eles não estão disponíveis no Direct3D 9.

Semântica de valor do sistema para o estágio do rasterizador.

Limitações ao escrever SV_Depth:

• Quando multisampling (MultisampleEnable é VERDADEIRO em D3D10_RASTERIZER_DESC) e gravando um valor de profundidade (usando um sombreador de pixel), o valor único gravado também é usado no teste de profundidade ; de modo que a capacidade de renderizar bordas primitivas em resolução mais alta é perdida quando multisampling.
• Ao usar o controle de fluxo dinâmico, é impossível determinar em tempo de compilação se um sombreador que grava SV_Depth em alguns caminhos terá a garantia de gravar SV_Depth em cada execução. Falha ao gravar SV_Depth quando declarado resulta em um comportamento indefinido (que pode ou não incluir o descarte do pixel).
• Qualquer valor float32, incluindo +/-INF e NaN, pode ser gravado em SV_Depth.
• A gravação de SV_Depth ainda é válida ao executar o Blending de Cores de Origem Dupla.

Migração do Direct3D 9 para o Direct3D 10 e posterior

Os seguintes problemas devem ser considerados ao migrar o código do Direct3D 9 para o Direct3D 10 e posterior:

Mapeamento para Semântica do Direct3D 9

Algumas das semânticas direct3D 10 e posteriores são mapeadas diretamente para a semântica direct3D 9.

[!] Observação para desenvolvedores do Direct3D 9: para destinos do Direct3D 9, a semântica do sombreador deve ser mapeada para a semântica válida do Direct3D 9. Para compatibilidade com versões anteriores, a FXC trata POSITION0 (e seus nomes variantes) como SV_Position. O FXC trata COLOR como SV_TARGET. DXC e compiladores mais recentes consideram POSITION[n] e COLOR como semântica definida pelo usuário.

• Mapeamento de para a semântica direct3D 9
• VPOS do Direct3D 9 e Direct3D 10 SV_Position
• planos de clipe de usuário no HLSL

VPOS do Direct3D 9 e Direct3D 10 SV_Position

A SV_Position semântica D3D10 fornece funcionalidade semelhante à semântica do modelo de sombreador Direct3D 9 3 VPOS. Por exemplo, no Direct3D 9, a seguinte sintaxe é usada para um sombreador de pixel usando coordenadas de espaço de tela:

float4 psMainD3D9( float4 screenSpace : VPOS ) : COLOR
{
    // code here 
}

O VPOS foi adicionado para suporte ao modelo de sombreador 3, para especificar coordenadas de espaço na tela, uma vez que a semântica POSITION destinava-se a coordenadas de espaço de objeto.

No Direct3D 10 e posterior, o SV_Position semântico (quando usado no contexto de um sombreador de pixel) especifica coordenadas de espaço de tela (deslocamento em 0,5). Portanto, o sombreador Direct3D 9 seria aproximadamente equivalente (sem considerar o deslocamento de 0,5) para o seguinte:

float4 psMainD3D10( float4 screenSpace : SV_Position ) : COLOR
{
    // code here
}

Ao migrar do Direct3D 9 para o Direct3D 10 e posterior, você precisará estar ciente disso ao traduzir seus sombreadores.

Planos de clipe do usuário no HLSL

A partir do Windows 8, você pode usar o atributo de função clipplanes em uma declaração de função HLSL em vez de SV_ClipDistance para fazer o sombreador funcionar em nível de recurso 9_x bem como no nível de recurso 10 e superior. Para obter mais informações, consulte Planos de clipe de usuário emde hardware de nível 9 do recurso.

Tópicos relacionados

• de Sintaxe de Linguagem
• variáveis (DirectX HLSL)