estructura D3DHAL_DP2INDEXEDLINESTRIP (d3dhal.h)

Artículo
02/23/2024

D3DHAL_DP2INDEXEDLINESTRIP se analiza desde el búfer de comandos mediante la devolución de llamada D3dDrawPrimitives2 cuando el miembro bCommand de la estructura D3DHAL_DP2COMMAND está establecido en D3DDP2OP_INDEXEDLINESTRIP y se usa para representar una secuencia de segmentos de línea conectados mediante índices de vértice.

Sintaxis

typedef struct _D3DHAL_DP2INDEXEDLINESTRIP {
  WORD wV[2];
} D3DHAL_DP2INDEXEDLINESTRIP, *LPD3DHAL_DP2INDEXEDLINESTRIP;

Miembros

wV[2]

Especifica los índices en el búfer de vértices del que el controlador obtiene los datos de coordenadas de los vértices que componen la franja de línea.

Aunque este miembro solo tiene espacio suficiente para contener dos índices, esta matriz de índices debe tratarse como una matriz de tamaño variable con elementos (wPrimitiveCount+ 1). (wPrimitiveCount es miembro de la estructura D3DHAL_DP2COMMAND).

Comentarios

Las franjas de línea indizada representadas con búferes de vértices se especifican mediante D3DHAL_DP2INDEXEDLINESTRIP. El miembro wPrimitiveCount de D3DHAL_DP2COMMAND especifica el número de segmentos de línea que se van a procesar. La secuencia de segmentos de línea representados es: (wV[0], wV[1]), (wV[1], wV[2]), (wV[2], wV[3]), ..., (wVStart[wPrimitiveCount -1], wVStart[wPrimitiveCount]).

D3dDrawPrimitives2 debe procesar (wPrimitiveCount+1) índices desde el búfer de comandos, en el procesamiento de estructuras wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP. El valor de wPrimitiveCount se especifica en la estructura D3DHAL_DP2COMMAND.

Una estructura de D3DHAL_DP2STARTVERTEX sigue inmediatamente el comando 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 el miembro dwVertexOffset de la estructura D3DHAL_DRAWPRIMITIVES2DATA 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 de D3DDP2OP_INDEXEDLINESTRIP, un desplazamiento D3DHAL_DP2STARTVERTEX y una lista de estructuras de D3DHAL_DP2INDEXEDLINESTRIP. El controlador debe procesar cuatro vértices desde el búfer de vértices, representando tres segmentos de línea conectados definidos por (v[8], v[4]), (v[4], v[7]), (v[7], v[6]).