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 |
|---|---|
|
taille n’était pas 3 ou 4. |
|
type n’était pas une valeur acceptée. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|