structure D3DHAL_DP2INDEXEDLINESTRIP (d3dhal.h)

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 constituant la bande de ligne.

Bien que ce membre n’ait que 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 mémoires 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 rendue 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 cours de traitement de wPrimitiveCount D3DHAL_DP2INDEXEDLINESTRIP structures. 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 commande contenant une commande D3DDP2OP_INDEXEDLINESTRIP, un décalage D3DHAL_DP2STARTVERTEX et une liste de structures D3DHAL_DP2INDEXEDLINESTRIP. Le pilote doit traiter quatre sommets à partir 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]).

Figure montrant une mémoire tampon avec une commande D3DDP2OP_INDEXEDLINESTRIP, un décalage D3DHAL_DP2STARTVERTEX et une liste de structures D3DHAL_DP2INDEXEDLINESTRIP

Configuration requise

   
En-tête d3dhal.h (include D3dhal.h)

Voir aussi

D3DDP2OP_INDEXEDLINESTRIP

D3DHAL_DP2COMMAND

D3DHAL_DP2STARTVERTEX

D3DHAL_DRAWPRIMITIVES2DATA

D3dDrawPrimitives2