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 |
|---|---|
|
le mode n’était pas une valeur acceptée. |
|
Count est une valeur négative. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|