estrutura D3DHAL_DP2INDEXEDLINESTRIP (d3dhal.h)

Artigo
02/23/2024

D3DHAL_DP2INDEXEDLINESTRIP é analisado do buffer de comando pelo retorno de chamada D3dDrawPrimitives2 quando o membro bCommand da estrutura D3DHAL_DP2COMMAND é definido como D3DDP2OP_INDEXEDLINESTRIP e é usado para renderizar uma sequência de segmentos de linha conectados usando índices de vértice.

Sintaxe

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

Membros

wV[2]

Especifica os índices no buffer de vértice do qual o driver obtém dados de coordenadas para os vértices que compõem a faixa de linha.

Embora esse membro tenha apenas espaço suficiente para conter dois índices, essa matriz de índices deve ser tratada como uma matriz de tamanho variável com elementos (wPrimitiveCount+ 1). (wPrimitiveCount é um membro da estrutura D3DHAL_DP2COMMAND.)

Comentários

As faixas de linha indexadas renderizadas com buffers de vértice são especificadas usando D3DHAL_DP2INDEXEDLINESTRIP. O número de segmentos de linha a serem processados é especificado pelo membro wPrimitiveCount de D3DHAL_DP2COMMAND. A sequência de segmentos de linha renderizados é: (wV[0], wV[1]), (wV[1], wV[2]), (wV[2], wV[3]), ..., (wVStart[wPrimitiveCount -1], wVStart[wPrimitiveCount]).

D3dDrawPrimitives2 deve processar índices (wPrimitiveCount+1) do buffer de comando, processando estruturas wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP. O valor de wPrimitiveCount é especificado na estrutura D3DHAL_DP2COMMAND.

Uma estrutura D3DHAL_DP2STARTVERTEX segue imediatamente o comando no buffer de comando. Os índices de buffer de vértice são relativos ao deslocamento do buffer de vértice especificado pelo membro dwVertexOffset da estrutura D3DHAL_DRAWPRIMITIVES2DATA mais o deslocamento base obtido do membro wVStart da estrutura D3DHAL_DP2STARTVERTEX.

A figura a seguir mostra uma parte de um buffer de comando de exemplo que contém um comando D3DDP2OP_INDEXEDLINESTRIP, um deslocamento D3DHAL_DP2STARTVERTEX e uma lista de estruturas de D3DHAL_DP2INDEXEDLINESTRIP. O driver deve processar quatro vértices do buffer de vértice, renderizando três segmentos de linha conectados definidos por (v[8], v[4]), (v[4], v[7]), (v[7], v[6]).