fonction glArrayElement

La fonction glArrayElement spécifie les éléments de tableau utilisés pour afficher un sommet.

Syntaxe

void WINAPI glArrayElement(
   GLint index
);

Paramètres

index

Index dans les tableaux activés.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Utilisez la fonction glArrayElement dans les paires glBegin et glEnd pour spécifier les données de vertex et d’attribut pour les primitives de point, de ligne et de polygone. La fonction glArrayElement spécifie les données d’un sommet unique à l’aide des données de vertex et d’attribut situées à l’index des tableaux de vertex activés.

Vous pouvez utiliser glArrayElement pour construire des primitives en indexant des données de vertex, plutôt qu’en diffusant des tableaux de données dans le premier et dernier ordre. Étant donné que glArrayElement spécifie un seul sommet, vous pouvez spécifier explicitement des attributs pour des primitives individuelles. Par exemple, vous pouvez définir une seule normale pour chaque triangle individuel.

Lorsque vous incluez des appels à glArrayElement dans des listes d’affichage, les données de tableau nécessaires, déterminées par les pointeurs du tableau et les valeurs d’activation, sont également entrées dans la liste d’affichage. Les valeurs de pointeur de tableau et d’activation sont déterminées lors de la création de listes d’affichage, et non lors de l’exécution des listes d’affichage.

Vous pouvez lire et mettre en cache des données de tableau statiques à tout moment avec glArrayElement. Lorsque vous modifiez les éléments d’un tableau statique sans le spécifier à nouveau, les résultats des appels suivants à glArrayElement ne sont pas définis.

Lorsque vous appelez glArrayElement sans appeler au préalable glEnableClientState(GL_VERTEX_ARRAY), aucun dessin ne se produit, mais les attributs correspondant aux tableaux activés sont modifiés. Bien qu’aucune erreur ne soit générée lorsque vous spécifiez un tableau dans des paires glBegin et glEnd , les résultats ne sont pas définis.

Notes

La fonction glArrayElement 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

glBegin

glColorPointer

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGetPointerv

glGetString

glIndexPointer

glNormalPointer

glTexCoordPointer

glVertexPointer