estructura D3DHAL_DP2TRIANGLEFAN_IMM (d3dhal.h)

Artículo
02/25/2024

La devolución de llamada D3dDrawPrimitives2 analiza una estructura D3DHAL_DP2TRIANGLEFAN_IMM desde el búfer de comandos cuando el miembro bCommand de la estructura D3DHAL_DP2COMMAND se establece en D3DDP2OP_TRIANGLEFAN_IMM y se usa para representar un ventilador de triángulo.

Sintaxis

typedef struct _D3DHAL_DP2TRIANGLEFAN_IMM {
  DWORD dwEdgeFlags;
} D3DHAL_DP2TRIANGLEFAN_IMM;

Miembros

dwEdgeFlags

Especifica una máscara de bits que identifica cuál de los bordes exteriores del ventilador se debe representar cuando el modo de relleno se D3DFILL_WIREFRAME. Un bit establecido indica que se debe representar su borde correspondiente. Para obtener más información sobre esta máscara de bits, vea la sección Comentarios.

Comentarios

Una estructura D3DHAL_DP2TRIANGLEFAN_IMM sigue inmediatamente la estructura D3DHAL_DP2COMMAND en el búfer de comandos. Los datos del vértice del ventilador del triángulo se alinean inmediatamente después de la estructura de D3DHAL_DP2TRIANGLEFAN_IMM en el búfer de comandos.

D3dDrawPrimitives2 debe procesar un total de vértices wPrimitiveCount+2 desde el búfer de comandos, tres vértices por triángulo, representando triángulos wPrimitiveCount . La secuencia de triángulos representados es (V[1], V[2], V[0]), (V[2], V[3], V[0]), (V[3], V[4], V[0]), ..., (V[wPrimitiveCount], V[wPrimitiveCount] + 1], V[0]). El valor de wPrimitiveCount se especifica en la estructura D3DHAL_DP2COMMAND.

El controlador debe comprobar la marca perimetral de cada uno de los bordes exteriores del ventilador cuando el modo de relleno está D3DFILL_WIREFRAME. A partir del bit menos significativo de dwEdgeFlags, bit 0 se aplica al borde V[0]-V[1], el bit 1 se aplica al borde V[1]-V[2] edge, ..., bit wPrimitiveCount se aplica al borde V[wPrimitiveCount]V[wPrimitiveCount]+1] y bit (wPrimitiveCount + 1) se aplica a V[[wPrimitiveCount]-+1]-V[0] Borde.

En la ilustración siguiente se muestra una parte de un búfer de comandos de ejemplo que contiene un comando de D3DDP2OP_TRIANGLEFAN_IMM, una estructura de D3DHAL_DP2TRIANGLEFAN_IMM y los datos de vértices. El controlador debe procesar los cinco vértices del búfer de comandos, representando un ventilador con tres triángulos definidos por (v[1], v[2], v[0]), (v[2], v[3], v[0]), (v[3], v[4], v[0]).