D3DHAL_DP2INDEXEDLINELIST struttura (d3dhal.h)

Articolo
02/23/2024

D3DHAL_DP2INDEXEDLINELIST viene analizzato dal buffer dei comandi dal callback D3dDrawPrimitives2 quando il membro bCommand della struttura di D3DHAL_DP2COMMAND è impostato su D3DDP2OP_INDEXEDLINELIST e viene usato per eseguire il rendering delle righe usando indici vertex.

Sintassi

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

Members

wV1

Specifica l'indice nel buffer del vertice, identificando il primo endpoint della riga.

wV2

Specifica l'indice nel buffer del vertice, identificando il secondo endpoint della riga.

Commenti

D3dDrawPrimitives2 deve elaborare gli indici (wPrimitiveCount * 2) dal buffer dei comandi, in effetti l'elaborazione di strutture wPrimitiveCount D3DHAL_DP2INDEXEDLINELIST. Il valore di wPrimitiveCount viene specificato nella struttura D3DHAL_DP2COMMAND.

Il driver deve elaborare un totale di vertici (wPrimitiveCount * 2) dal buffer del vertice, due vertici per riga. La sequenza di righe di cui viene eseguito il rendering è (wV1₀, wV2₀), (wV1₁, wV2₁), ..., (wV1n,wV2 n), dove n equals (wPrimitiveCount- 1). Il driver deve interpretare gli indici del buffer dei vertici in base al comando corrente come indicato di seguito:

Quando il comando è D3DDP2OP_INDEXEDLINELIST, gli indici del buffer del vertice sono relativi all'offset del buffer del vertice specificato dal membro dwVertexOffset della struttura D3DHAL_DRAWPRIMITIVES2DATA .
Quando il comando è D3DDP2OP_INDEXEDLINELIST2, una struttura D3DHAL_DP2STARTVERTEX ne segue immediatamente e precede le strutture D3DHAL_DP2INDEXEDLINELIST nel buffer dei comandi. Gli indici del buffer dei vertici sono relativi all'offset del buffer vertex specificato da dwVertexOffset e l'offset di base ottenuto dal membro wVStart della struttura D3DHAL_DP2STARTVERTEX.

La figura seguente mostra una parte di un buffer di comando di esempio contenente un comando D3DDP2OP_INDEXEDLINELIST e due strutture D3DHAL_DP2INDEXEDLINELIST. Il driver deve disegnare due righe usando i quattro vertici seguenti dal buffer del vertice: (v[0], v[4]), (v[5], v[6]). Figura che mostra un buffer dei comandi con un comando D3DDP2OP_INDEXEDLINELIST e due strutture D3DHAL_DP2INDEXEDLINELIST

Figura che mostra un buffer dei comandi con un comando D3DDP2OP_INDEXEDLINELIST e due strutture D3DHAL_DP2INDEXEDLINELIST

Analogamente, la figura seguente mostra una parte di un buffer di comando di esempio contenente un comando D3DDP2OP_INDEXEDLINELIST2, un offset D3DHAL_DP2STARTVERTEX e due strutture D3DHAL_DP2INDEXEDLINELIST. Il driver deve elaborare quattro vertici dal buffer del vertice, eseguire il rendering di due righe definite da (v[3], v[7]), (v[8], v[9]). Figura che mostra un buffer di comando con un comando D3DDP2OP_INDEXEDLINELIST2, un offset D3DHAL_DP2STARTVERTEX e due strutture D3DHAL_DP2INDEXEDLINELIST