glDrawElements fonction)

La fonction glDrawElements restitue les primitives à partir des données de tableau.

Syntaxe

void WINAPI glDrawElements(
         GLenum  mode,
         GLsizei count,
         GLenum  type,
   const GLvoid  *indices
);

Paramètres

mode

Type de primitives à restituer. Elle peut prendre l’une des valeurs symboliques suivantes : les _ points de la comptabilité, la bande de facturation GL, la _ _ boucle de lignes GL, les _ _ _ lignes de GL, la _ bande triangulaire GL _ , le _ _ ventilateur de triangle GL, _ les triangles GL, le GL _ Quad _ Strip, _ les quads GL et le _ polygone GL.

count

Nombre d’éléments à rendre.

type

Type des valeurs dans les index. Doit être l’un des _ octets non signés GL _ , GL _ unsigned _ short ou GL _ unsigned _ int.

indices

Pointeur vers l’emplacement où les index sont stockés.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
_enum GL non valide _
le mode n’était pas une valeur acceptée.
_valeur non valide du GL _
Count est une valeur négative.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glDrawElements vous permet de spécifier plusieurs primitives géométriques avec très peu d’appels de fonction. Au lieu d’appeler une fonction OpenGL pour passer chaque vertex, normal ou couleur, vous pouvez spécifier des tableaux distincts de vertex, de normales et de couleurs à l’avance, et les utiliser pour définir une séquence de primitives (tout du même type) à l’aide d’un seul appel à glDrawElements.

Quand vous appelez la fonction glDrawElements , elle utilise des éléments séquentiels Count d' index pour construire une séquence de primitives géométriques. Le paramètre mode spécifie le type de primitives construites et la façon dont les éléments de tableau sont utilisés pour construire ces Primitives. Si le _ _ tableau de vertex GL n’est pas activé, aucune primitive géométrique n’est générée.

Les attributs de vertex modifiés par glDrawElements ont une valeur non spécifiée après le retour de glDrawElements . Par exemple, si le _ tableau de couleurs GL _ est activé, la valeur de la couleur actuelle est non définie après l’exécution de glDrawElements . Les attributs qui ne sont pas modifiés restent inchangés.

Vous pouvez inclure la fonction glDrawElements dans les listes d’affichage. Lorsque glDrawElements est inclus dans une liste d’affichage, les données de tableau nécessaires (déterminées par les pointeurs de tableau et activés) sont également entrées dans la liste d’affichage. Étant donné que les pointeurs de tableau et active sont des variables d’État côté client, leurs valeurs affectent les listes d’affichage quand les listes sont créées, et non lors de l’exécution des listes.

Notes

La fonction glDrawElements est disponible uniquement dans OpenGL version 1,1 ou ultérieure.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
GL. h
Bibliothèque
Opengl32. lib
DLL
Opengl32.dll

Voir aussi

glArrayElement

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnd

glGetPointerv

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer