fonction glIndexPointer

La fonction glIndexPointer définit un tableau d’index de couleur.

Syntaxe

void WINAPI glIndexPointer(
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Paramètres

type

Type de données de chaque index de couleur dans le tableau à l’aide des constantes symboliques suivantes : GL_SHORT, GL_INT, GL_FLOAT, GL_DOUBLE.

Foulée

Décalage d’octet entre les index de couleur consécutifs. Lorsque la foulée est nulle, les index de couleur sont étroitement emballés dans le tableau.

Pointeur

Pointeur vers le premier index de couleur du tableau.

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
GL_INVALID_ENUM	type n’était pas une valeur acceptée.
GL_INVALID_VALUE	stride ou count était négatif.

Notes

La fonction glIndexPointer spécifie l’emplacement et les données d’un tableau d’index de couleurs à utiliser lors du rendu. Le paramètre type spécifie le type de données de chaque index de couleur et la foulée détermine le décalage d’octet d’un index de couleur à l’autre, ce qui permet l’empaquetage des sommets et des attributs dans un seul tableau ou stockage dans des tableaux distincts. Dans certaines implémentations, le stockage des sommets et des attributs dans un tableau unique peut être plus efficace que d’utiliser des tableaux distincts. Pour plus d’informations, consultez glInterleavedArrays.

Un tableau d’index de couleurs est activé lorsque vous spécifiez la constante GL_INDEX_ARRAY avec glEnableClientState. Lorsque cette option est activée, glDrawArrays et glArrayElement utilisent le tableau d’index de couleurs. Par défaut, le tableau d’index de couleurs est désactivé.

Vous ne pouvez pas inclure glIndexPointer dans les listes d’affichage.

Lorsque vous spécifiez un tableau d’index de couleurs à l’aide de glIndexPointer, les valeurs de tous les paramètres du tableau d’index de couleur de la fonction sont enregistrées dans un état côté client et les éléments statiques du tableau peuvent être mis en cache. Étant donné que les paramètres du tableau d’index de couleur sont à l’état côté client, leurs valeurs ne sont pas enregistrées ou restaurées par glPushAttrib et glPopAttrib.

Bien qu’aucune erreur ne soit générée lorsque vous appelez glIndexPointer dans des paires glBegin et glEnd , les résultats ne sont pas définis.

Les fonctions suivantes récupèrent des informations relatives à glIndexPointer :

glIsEnabled avec argument GL_INDEX_ARRAY

glGet avec argument GL_INDEX_ARRAY_STRIDE

glGet avec argument GL_INDEX_ARRAY_COUNT

glGet avec argument GL_INDEX_ARRAY_TYPE

glGet avec argument GL_INDEX_ARRAY_SIZE

glGetPointerv avec argument GL_INDEX_ARRAY_POINTER

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

glColorPointer

glDrawArrays

glEdgeFlagPointer

glGetPointerv

glGetString

glNormalPointer

glPushAttrib

glTexCoordPointer

glVertexPointer