Méthode IDirect3DDevice9 ::D rawIndexedPrimitive (d3d9helper.h)

Article
02/29/2024

En fonction de l’indexation, restitue la primitive géométrique spécifiée dans un tableau de sommets.

Syntaxe

HRESULT DrawIndexedPrimitive(
  [in] D3DPRIMITIVETYPE unnamedParam1,
  [in] INT              BaseVertexIndex,
  [in] UINT             MinVertexIndex,
  [in] UINT             NumVertices,
  [in] UINT             startIndex,
  [in] UINT             primCount
);

Paramètres

[in] unnamedParam1

Type : D3DPRIMITIVETYPE

Membre du D3DPRIMITIVETYPE type énuméré, décrivant le type de primitive à restituer. D3DPT_POINTLIST n’est pas pris en charge avec cette méthode. Consultez la section Notes.

[in] BaseVertexIndex

Type : INT

Décalage entre le début de la mémoire tampon de vertex et le premier sommet. Voir Scénario 4.

[in] MinVertexIndex

Type : UINT

Index de vertex minimal pour les sommets utilisés pendant cet appel. Il s’agit d’un index de base zéro par rapport à BaseVertexIndex.

[in] NumVertices

Type : UINT

Nombre de sommets utilisés pendant cet appel. Le premier sommet se trouve à l’index : BaseVertexIndex + MinIndex.

[in] startIndex

Type : UINT

Index du premier index à utiliser lors de l’accès à la mémoire tampon de vertex. À partir de StartIndex pour indexer les sommets à partir de la mémoire tampon de vertex.

[in] primCount

Type : UINT

Nombre de primitives à afficher. Le nombre de sommets utilisés est une fonction du nombre primitif et du type primitif. Le nombre maximal de primitives autorisées est déterminé en vérifiant le membre MaxPrimitiveCount de la structure D3DCAPS9 .

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK. Si la méthode échoue, la valeur de retour peut être la suivante : D3DERR_INVALIDCALL.

Remarques

Cette méthode dessine des primitives indexées à partir du jeu actuel de flux d’entrée de données. MinIndex et tous les index du flux d’index sont relatifs au BaseVertexIndex.

Les paramètres MinIndex et NumVertices spécifient la plage d’index de vertex utilisée pour chaque appel IDirect3DDevice9 ::D rawIndexedPrimitive . Ils sont utilisés pour optimiser le traitement des vertex des primitives indexées en traitant une plage séquentielle de sommets avant l’indexation dans ces sommets. Il n’est pas valide pour les index utilisés pendant cet appel de référencer des sommets en dehors de cette plage.

IDirect3DDevice9 ::D rawIndexedPrimitive échoue si aucun tableau d’index n’est défini.

Le D3DPT_POINTLIST membre du type énuméré D3DPRIMITIVETYPE n’est pas pris en charge et n’est pas un type valide pour cette méthode.

Lors de la conversion d’une application héritée en Direct3D 9, vous devez ajouter un appel à IDirect3DDevice9 ::SetFVF pour utiliser le pipeline de fonction fixe, ou à IDirect3DDevice9 ::SetVertexDeclaration pour utiliser un nuanceur de vertex avant d’effectuer des appels Draw.