D3DHAL_DP2INDEXEDTRIANGLEFAN structure (d3dhal.h)

Article
02/23/2024

D3DHAL_DP2INDEXEDTRIANGLEFAN est analysé à partir de la mémoire tampon de commandes par le rappel D3dDrawPrimitives2 lorsque le membre bCommand de la structure D3DHAL_DP2COMMAND a la valeur D3DDP2OP_INDEXEDTRIANGLEFAN et est utilisé pour afficher une séquence de triangles connectés à l’aide d’index de vertex. Tous les triangles partagent un sommet commun.

Syntaxe

typedef struct _D3DHAL_DP2INDEXEDTRIANGLEFAN {
  WORD wV[3];
} D3DHAL_DP2INDEXEDTRIANGLEFAN, *LPD3DHAL_DP2INDEXEDTRIANGLEFAN;

Membres

wV[3]

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 le ventilateur de triangle.

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

Remarques

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

Le pilote doit traiter un total de vertex (wPrimitiveCount + 2) à partir de la mémoire tampon de vertex, trois sommets par triangle. La séquence de triangles affichée est la suivante : (wV[1], wV[2], wV[0]), (wV[2], wV[3], wV[0]), (wV[3], wV[4], wV[0]), ..., (wV[wPrimitiveCount], wV[wPrimitiveCount]+1], wV[0]). Notez que tous les triangles ont le sommet spécifié dans wV[0]en commun.

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.

L’illustration suivante montre une partie d’un exemple de mémoire tampon de commandes contenant une commande D3DDP2OP_INDEXEDTRIANGLEFAN, un décalage D3DHAL_DP2STARTVERTEX et une liste logique de structures D3DHAL_DP2INDEXEDTRIANGLEFAN. Le pilote doit traiter cinq sommets de la mémoire tampon de vertex, rendant un ventilateur avec trois triangles définis par (v[4], v[5], v[7]), (v[5], v[6], v[7]), (v[6], v[9], v[7]).