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 de variável (DirectX HLSL)).

Em geral, os dados passados entre os estágios do pipeline são completamente genéricos e não são interpretados exclusivamente pelo sistema; são permitidas semânticas arbitrárias que não têm nenhum significado especial. Os parâmetros (no Direct3D 10 e posterior) que contêm essa semântica especial são chamados de Semântica de Valor do Sistema.

Semântica suportada no Direct3D 9 e Direct3D 10 e posterior

Os seguintes tipos de semântica são suportados no Direct3D 9 e 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 associadas a um parâmetro vertex-shader. Essas semânticas são suportadas no Direct3D 9 e no Direct3D 10 e posterior.

n é um inteiro opcional entre 0 e o número de recursos suportados. 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 pixel-shader. Essas semânticas são suportadas no Direct3D 9 e no Direct3D 10 e posterior.

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

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

Semântica suportada 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ântica de valor do sistema

Semântica de valor do sistema

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. Os sombreadores de pixel só podem gravar em parâmetros com a semântica de valor do sistema SV_Depth e SV_Target.

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 os estágios subsequentes.

SV_PrimitiveID é uma exceção a essa regra de ser inserido apenas 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 de sombreador de casco, estágio de sombreador de domínio e, depois disso, qualquer estágio habilitado primeiro: estágio de sombreador de geometria ou estágio de sombreador de pixel.

Se a tesselação estiver habilitada, o estágio de sombreador de casco e o estágio de sombreador de domínio estarão presentes. Para um determinado patch, o mesmo PrimitiveID se aplica à chamada de sombreador de casco do patch e a todas as chamadas de sombreador de domínio tesseladas. 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 o sombreador de geometria SV_PrimitiveID entradas e porque ele pode produzir zero ou um ou mais primitivos por invocação, o sombreador deve programar sua própria escolha de valor de SV_PrimitiveID para cada primitiva de saída se um sombreador de pixel subsequente SV_PrimtiveID entradas.

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árias primitivas.

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 de rasterização.

Limitações ao escrever SV_Depth:

• Quando a amostragem múltipla (MultisampleEnable é TRUE em D3D10_RASTERIZER_DESC) e a gravação de um valor de profundidade (usando um sombreador de pixel), o valor único escrito também é usado no teste de profundidade, de modo que a capacidade de renderizar bordas primitivas em resolução mais alta é perdida durante a multiamostragem.
• 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. A falha ao gravar SV_Depth quando declarada resulta em 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 SV_Depth ainda é válida ao executar a Mistura 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:

Mapeando para semântica do Direct3D 9

Algumas das semânticas do Direct3D 10 e posteriores são mapeadas diretamente para a semântica do 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, o FXC trata POSITION0 (e seus nomes de variantes) como SV_Position. FXC trata a COR como SV_TARGET. DXC e compiladores mais recentes consideram POSITION[n] e COLOR como semântica definida pelo usuário.

• Mapeando para semântica do Direct3D 9
• VPOS Direct3D 9 e Direct3D 10 SV_Position
• Planos de clipe do usuário em HLSL

VPOS Direct3D 9 e Direct3D 10 SV_Position

O SV_Position semântico D3D10 fornece funcionalidade semelhante à semântica VPOS do modelo de sombreador 3 do Direct3D 9. Por exemplo, no Direct3D 9, a sintaxe a seguir é 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 de tela, já que a semântica POSITION foi destinada a coordenadas de espaço de objeto.

No Direct3D 10 e posterior, a semântica SV_Position (quando usada no contexto de um sombreador de pixel) especifica coordenadas de espaço de tela (deslocadas por 0,5). Portanto, o sombreador Direct3D 9 seria aproximadamente equivalente (sem considerar o deslocamento 0,5) ao 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 em 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 com que seu sombreador funcione no 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 em hardware de nível de recurso 9.

Tópicos relacionados

• Sintaxe da linguagem
• Variáveis (DirectX HLSL)