estructura D3DHAL_DP2INDEXEDLINELIST (d3dhal.h)

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

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, que identifica el primer punto de conexión de la línea.

wV2

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

Comentarios

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

El controlador debe procesar un total de vértices (wPrimitiveCount * 2) desde el 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 de la siguiente manera:

• Cuando el comando se D3DDP2OP_INDEXEDLINELIST, los índices de búfer de vértices son relativos al desplazamiento del búfer de vértices especificado por el miembro dwVertexOffset de la estructura D3DHAL_DRAWPRIMITIVES2DATA .
• Cuando el comando se D3DDP2OP_INDEXEDLINELIST2, 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]). 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 de D3DHAL_DP2STARTVERTEX y dos estructuras de 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]).

Requisitos

Requisito	Valor
Header	d3dhal.h (incluya D3dhal.h)

Consulte también

D3DDP2OP_INDEXEDLINELIST

D3DHAL_DP2COMMAND

D3DHAL_DP2STARTVERTEX

D3DHAL_DRAWPRIMITIVES2DATA

D3dDrawPrimitives2