fonction glColorPointer

La fonction glColorPointer définit un tableau de couleurs.

Syntaxe

void WINAPI glColorPointer(
         GLint   size,
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Paramètres

size

Nombre de composants par couleur. La valeur doit être 3 ou 4.

type

Type de données de chaque composant de couleur dans un tableau de couleurs. Les types de données acceptables sont spécifiés avec les constantes suivantes : GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT ou GL_DOUBLE.

Foulée

Décalage d’octets entre les couleurs consécutives. Lorsque stride est égal à zéro, les couleurs sont étroitement emballées dans le tableau.

Pointeur

Pointeur vers le premier composant du premier élément de couleur dans un tableau de couleurs.

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

Notes

La fonction glColorPointer spécifie l’emplacement et le format de données d’un tableau de composants de couleur à utiliser lors du rendu. Le paramètre stride détermine le décalage d’octets d’une couleur à l’autre, ce qui permet l’empaquetage des attributs de vertex dans un tableau unique ou le stockage dans des tableaux distincts. Dans certaines implémentations, le stockage des attributs de vertex dans un tableau unique peut être plus efficace que l’utilisation de tableaux distincts.

Activé le tableau de couleurs en spécifiant la constante GL_COLOR_ARRAY avec glEnableClientState. L’appel de glArrayElement, glDrawElements ou glDrawArrays utilise le tableau de couleurs qui est ainsi activé. Par défaut, le tableau de couleurs est désactivé. Les appels glColorPointer ne peuvent pas être entrés dans les listes d’affichage.

Lorsque vous spécifiez un tableau de couleurs à l’aide de glColorPointer, les valeurs de tous les paramètres du tableau de couleurs de la fonction sont enregistrées dans un état côté client et vous pouvez mettre en cache des éléments de tableau statiques. Étant donné que les paramètres du tableau de couleurs sont dans un état côté client, glPushAttrib et glPopAttrib n’enregistrent ni ne restaurent les valeurs des paramètres.

Bien que la spécification du tableau de couleurs dans les paires glBegin et glend ne génère pas d’erreur, les résultats ne sont pas définis.

Les fonctions suivantes récupèrent des informations relatives à la fonction glColorPointer :

glIsEnabled avec argument GL_COLOR_ARRAY

glGet avec argument GL_COLOR_ARRAY_SIZE

glGet avec argument GL_COLOR_ARRAY_TYPE

glGet avec argument GL_COLOR_ARRAY_STRIDE

glGet avec argument GL_COLOR_ARRAY_COUNT

glGetPointerv avec argument GL_COLOR_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

glBegin

glDrawArrays

glEdgeFlagPointer

glEnableClientState

glEnd

glGet

glGetString

glGetPointerv

glIndexPointer

glIsEnabled

glNormalPointer

glPopAttrib

glPushAttrib

glTexCoordPointer

glVertexPointer