D3DHAL_DP2INDEXEDLINESTRIP structure (d3dhal.h)

Article
08/07/2023

D3DHAL_DP2INDEXEDLINESTRIP est analysé à partir de la mémoire tampon de commandes par le rappel D3dDrawPrimitives2 lorsque le membre bCommand de la structure D3DHAL_DP2COMMAND est défini sur D3DDP2OP_INDEXEDLINESTRIP, et est utilisé pour afficher une séquence de segments de ligne connectés à l’aide d’index de vertex.

Syntaxe

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

Membres

wV[2]

Spécifie les index dans la mémoire tampon de vertex à partir de laquelle le pilote obtient des données de coordonnées pour les sommets composant la bande de ligne.

Bien que ce membre ne dispose que de suffisamment d’espace pour contenir deux index, ce tableau d’index doit être traité comme un tableau de taille variable avec des éléments (wPrimitiveCount+ 1). (wPrimitiveCount est membre de la structure D3DHAL_DP2COMMAND.)

Remarques

Les bandes de lignes indexées rendues avec des tampons de vertex sont spécifiées à l’aide de D3DHAL_DP2INDEXEDLINESTRIP. Le nombre de segments de ligne à traiter est spécifié par le membre wPrimitiveCount de D3DHAL_DP2COMMAND. La séquence de segments de ligne affichée est : (wV[0], wV[1]), (wV[1], wV[2]), (wV[2], wV[3]), ..., (wVStart[wPrimitiveCount -1], wVStart[wPrimitiveCount]).

D3dDrawPrimitives2 doit traiter les index (wPrimitiveCount+1) à partir de la mémoire tampon de commandes, en traitant les structures wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP. La valeur de wPrimitiveCount est spécifiée dans la structure D3DHAL_DP2COMMAND.

Une structure D3DHAL_DP2STARTVERTEX suit immédiatement la commande dans la mémoire tampon de commande. Les index de mémoire tampon de vertex sont relatifs au décalage de la mémoire tampon de vertex spécifié par le membre dwVertexOffset de la structure D3DHAL_DRAWPRIMITIVES2DATA plus le décalage de base obtenu à partir du membre wVStart de la structure D3DHAL_DP2STARTVERTEX.

La figure suivante montre une partie d’un exemple de mémoire tampon de commandes contenant une commande D3DDP2OP_INDEXEDLINESTRIP, un décalage D3DHAL_DP2STARTVERTEX et une liste de structures D3DHAL_DP2INDEXEDLINESTRIP. Le pilote doit traiter quatre sommets de la mémoire tampon de vertex, rendant trois segments de ligne connectés définis par (v[8], v[4]), (v[4], v[7]), (v[7], v[6]).