Semántica

Una semántica es una cadena adjunta a una entrada o salida del sombreador que transmite información sobre el uso previsto de un parámetro. La semántica es necesaria en todas las variables que se pasan entre las fases del sombreador. La sintaxis para agregar una semántica a una variable de sombreador se muestra aquí (Sintaxis de variable (DirectX HLSL)).

En general, los datos pasados entre fases de canalización son completamente genéricos y el sistema no los interpreta de forma única; se permite la semántica arbitraria que no tiene ningún significado especial. Los parámetros (en Direct3D 10 y versiones posteriores) que contienen estas semánticas especiales se conocen como semántica de valor del sistema.

Semántica compatible con Direct3D 9, Direct3D 10 y versiones posteriores

Los siguientes tipos de semántica se admiten en Direct3D 9, Direct3D 10 y versiones posteriores.

• Semántica del sombreador de vértices
• Semántica del sombreador de píxeles

Semántica del sombreador de vértices

Esta semántica tiene significado cuando se adjunta a un parámetro de sombreador de vértices. Estas semánticas son compatibles con Direct3D 9, Direct3D 10 y versiones posteriores.

n es un entero opcional entre 0 y el número de recursos admitidos. Por ejemplo, POSITION0, TEXCOORD1, etc.

Semántica del sombreador de píxeles

Esta semántica tiene significado cuando se adjunta a un parámetro de entrada del sombreador de píxeles. Estas semánticas son compatibles con Direct3D 9, Direct3D 10 y versiones posteriores.

n es un entero opcional entre 0 y el número de recursos admitidos. Por ejemplo, PSIZE0, COLOR1, etc.

La semántica COLOR solo es válida en el modo de compatibilidad del sombreador (es decir, cuando se crea el sombreador mediante D3D10_SHADER_ENABLE_BACKWARDS_COMPATIBILITY).

Semántica solo compatible con Direct3D 10 y versiones posteriores.

Los siguientes tipos de semántica se han introducido recientemente para Direct3D 10 y no están disponibles para Direct3D 9.

• Semántica de valores del sistema

Semántica de valores del sistema

La semántica de valores del sistema es nueva en Direct3D 10. Todos los valores del sistema comienzan con un prefijo de SV_, un ejemplo común es SV_POSITION, que se interpreta mediante la fase de rasterizador. Los valores del sistema son válidos en otras partes de la canalización. Por ejemplo, SV_Position se pueden especificar como entrada para un sombreador de vértices, y también como una salida. Los sombreadores de píxeles solo pueden escribir en parámetros con la semántica de valores del sistema SV_Depth y SV_Target.

Otros valores del sistema (SV_VertexID, SV_InstanceID y SV_IsFrontFace) solo pueden introducirse en el primer sombreador activo de la canalización que puede interpretar el valor determinado; después de eso, la función de sombreador debe pasar los valores a las fases posteriores.

SV_PrimitiveID es una excepción a esta regla que indica que solo se introduce en el primer sombreador activo de la canalización que puede interpretar el valor determinado; el hardware puede proporcionar el mismo valor de id. que la entrada a la fase del sombreador de casco, la fase de sombreador de dominio, y después de esa, sea cual sea la fase, es la primera habilitada: fase del sombreador de geometría o fase del sombreador de píxeles.

Si el teselado está habilitado, la fase del sombreador de casco y la fase de sombreador de dominio están presentes. Para una revisión determinada, el mismo PrimitiveID se aplica a la invocación del sombreador de casco de la revisión y a todas las invocaciones del sombreador de dominio teselado. El mismo PrimitiveID también se propaga a la siguiente fase activa; fase del sombreador de geometría o fase de sombreador de píxeles si está habilitada.

Si el sombreador de geometría establece como entrada SV_PrimitiveID, y debido a que pueden generar cero, uno o varios primitivos por invocación, el sombreador debe programar su propia elección de SV_PrimitiveID valor para cada primitivo de salida si un sombreador de píxeles posterior establece como entrada SV_PrimtiveID.

A modo de otro ejemplo, la fase del sombreador de vértices no puede interpretar SV_PrimitiveID porque un vértice puede ser miembro de varios primitivos.

Estas semánticas se han agregado a Direct3D 10; no están disponibles en Direct3D 9.

Semántica de valores del sistema para la fase de rasterizador.

Limitaciones al escribir SV_Depth:

• Cuando el muestreo múltiple (MultisampleEnable es TRUE en D3D10_RASTERIZER_DESC) y escribe un valor de profundidad (mediante un sombreador de píxeles), el valor único escrito también se usa en la prueba de profundidad; por lo tanto, la capacidad de representar bordes primitivos en una resolución superior se pierde cuando se habilita el muestreo múltiple.
• Al usar el control de flujo dinámico, es imposible determinar en tiempo de compilación si se garantiza que un sombreador que escribe SV_Depth en algunas rutas de acceso escriba SV_Depth en cada ejecución. Error al escribir SV_Depth cuando se declara como resultado un comportamiento indefinido (que puede incluir o no descartar el píxel).
• Cualquier valor float32 que incluya +/-INF y NaN se puede escribir en SV_Depth.
• Escribir en SV_Depth sigue siendo válido al realizar la combinación de color de origen dual.

Migración de Direct3D 9 a Direct3D 10 y versiones posteriores

Se deben tener en cuenta los siguientes problemas al migrar código de Direct3D 9 a Direct3D 10 y versiones posteriores:

Asignación a la semántica de Direct3D 9

Algunas de las semánticas de Direct3D 10 y versiones posteriores se asignan directamente a la semántica de Direct3D 9.

[!] Nota para desarrolladores de Direct3D 9: para destinos de Direct3D 9, la semántica del sombreador debe asignarse a la semántica válida de Direct3D 9. Para la compatibilidad con versiones anteriores, FXC trata POSITION0 (y sus nombres de variante) como SV_Position. FXC trata COLOR como SV_TARGET. DXC y compiladores más recientes consideran POSITION[n] y COLOR como semántica definida por el usuario.

• Asignación a la semántica de Direct3D 9
• VPOS de Direct3D 9 y SV_Position de Direct3D 10
• Planos de recorte de usuario en HLSL

VPOS de Direct3D 9 y SV_Position de Direct3D 10

SV_Position semántica de D3D10 proporciona una función similar a la semántica VPOS del modelo 3 de sombreador de Direct3D 9. Por ejemplo, en Direct3D 9 se usa la sintaxis siguiente para un sombreador de píxeles mediante coordenadas de espacio de pantalla:

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

VPOS se agregó para la compatibilidad con el modelo 3 de sombreador a fin de especificar coordenadas de espacio de pantalla, ya que la semántica POSITION estaba pensada para coordenadas de espacio de objetos.

En Direct3D 10 y versiones posteriores, la semántica SV_Position (cuando se usa en el contexto de un sombreador de píxeles) especifica coordenadas de espacio de pantalla (desplazado en 0,5). Por lo tanto, el sombreador de Direct3D 9 sería aproximadamente equivalente (sin tener en cuenta el desplazamiento de 0,5) a lo siguiente:

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

Al migrar de Direct3D 9 a Direct3D 10 y versiones posteriores, deberá tener en cuenta esto al traducir los sombreadores.

Planos de recorte de usuario en HLSL

A partir de Windows 8, puede usar el atributo de función lipplanes en una declaración de función HLSL en lugar de SV_ClipDistance para que el sombreador funcione en el nivel de característica 9_x, así como en el nivel de característica 10 y versiones posteriores. Para obtener más información, vea Planos de clip de usuario en hardware de nivel de característica 9.

Temas relacionados

• Sintaxis del lenguaje
• Variables (DirectX HLSL)