estructura D3DHAL_DP2INDEXEDLINELIST (d3dhal.h)

Artículo
02/06/2025

D3DHAL_DP2INDEXEDLINELIST se analiza desde el búfer de comandos mediante el D3dDrawPrimitives2 devolución de llamada cuando el miembro de la estructura de D3DHAL_DP2COMMAND se establece en D3DDP2OP_INDEXEDLINELIST y se usa para representar las líneas mediante índices de vértices.

Sintaxis

typedef struct _D3DHAL_DP2INDEXEDLINELIST {
  WORD wV1;
  WORD wV2;
} D3DHAL_DP2INDEXEDLINELIST, *LPD3DHAL_DP2INDEXEDLINELIST;

Miembros

wV1

Especifica el índice en el búfer de vértices, identificando el primer punto de conexión de la línea.

wV2

Especifica el índice en el búfer de vértices, identificando el segundo punto de conexión de la línea.

Observaciones

los índices D3dDrawPrimitives2 deben procesar (wPrimitiveCount * 2) desde el búfer de comandos, en el procesamiento de estructuras D3DHAL_DP2INDEXEDLINELIST wPrimitiveCount. El valor de wPrimitiveCount se especifica en la estructura D3DHAL_DP2COMMAND.

El controlador debe procesar un total de (wPrimitiveCount * 2) vértices del búfer de vértices, dos vértices por línea. La secuencia de líneas representadas es (wV1₀, wV2₀), (wV1₁, wV2₁), ..., (wV1n,wV2n), donde n es igual (wPrimitiveCount- 1). El controlador debe interpretar los índices de búfer de vértices en función del comando actual como se indica a continuación:

Cuando se D3DDP2OP_INDEXEDLINELIST el comando, los índices de búfer de vértices son relativos al desplazamiento del búfer de vértices especificado por el dwVertexOffset miembro de la estructura D3DHAL_DRAWPRIMITIVES2DATA.
Cuando se D3DDP2OP_INDEXEDLINELIST2 el comando, una estructura de D3DHAL_DP2STARTVERTEX sigue inmediatamente y precede a las estructuras de D3DHAL_DP2INDEXEDLINELIST en el búfer de comandos. Los índices de búfer de vértices son relativos al desplazamiento del búfer de vértices especificado por dwVertexOffset más el desplazamiento base obtenido del miembro wVStart de la estructura D3DHAL_DP2STARTVERTEX.

En la ilustración siguiente se muestra una parte de un búfer de comandos de ejemplo que contiene un comando D3DDP2OP_INDEXEDLINELIST y dos estructuras de D3DHAL_DP2INDEXEDLINELIST. El controlador debe dibujar dos líneas con los cuatro vértices siguientes del búfer de vértices: (v[0], v[4]), (v[5], v[6]). Figura que muestra un búfer de comandos con un comando D3DDP2OP_INDEXEDLINELIST y dos estructuras de D3DHAL_DP2INDEXEDLINELIST

Figura que muestra un búfer de comandos con un comando D3DDP2OP_INDEXEDLINELIST y dos estructuras de D3DHAL_DP2INDEXEDLINELIST

De forma similar, en la ilustración siguiente se muestra una parte de un búfer de comandos de ejemplo que contiene un comando de D3DDP2OP_INDEXEDLINELIST2, un desplazamiento D3DHAL_DP2STARTVERTEX y dos estructuras D3DHAL_DP2INDEXEDLINELIST. El controlador debe procesar cuatro vértices desde el búfer de vértices, representando dos líneas definidas por (v[3], v[7]), (v[8], v[9]). Ilustración que muestra un búfer de comandos con un comando de D3DDP2OP_INDEXEDLINELIST2, un desplazamiento D3DHAL_DP2STARTVERTEX y dos estructuras de D3DHAL_DP2INDEXEDLINELIST