Partager via


fonction glColor4usv

Définit la couleur actuelle à partir d’un tableau de valeurs de couleur déjà existant.

Syntaxe

void WINAPI glColor4usv(
   const GLushort *v
);

Paramètres

C

Pointeur vers un tableau qui contient des valeurs rouge, verte, bleue et alpha.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

Le GL stocke à la fois un index de couleur à valeur unique actuel et une couleur RVBA à quatre valeurs actuelles. glcolor définit une nouvelle couleur RVBA à quatre valeurs. glcolor a deux variantes principales : glcolor3 et glcolor4. Les variantes glcolor3 spécifient explicitement de nouvelles valeurs rouges, vertes et bleues et définissent implicitement la valeur alpha actuelle sur 1.0 (pleine intensité). Les variantes glcolor4 spécifient les quatre composants de couleur explicitement.

glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i et glcolor4i prennent trois ou quatre entiers signés, courts ou longs comme arguments. Lorsque v est ajouté au nom, les commandes de couleur peuvent prendre un pointeur vers un tableau de telles valeurs.

Les valeurs de couleur actuelles sont stockées au format à virgule flottante, avec des tailles de mantissa et d’exposant non spécifiées. Les composants de couleur d’entier non signés, lorsqu’ils sont spécifiés, sont mappés de manière linéaire à des valeurs à virgule flottante, de sorte que la plus grande valeur représentable est mappée à 1.0 (intensité totale) et 0 à 0.0 (intensité nulle). Les composants de couleur d’entier signés, lorsqu’ils sont spécifiés, sont mappés de manière linéaire à des valeurs à virgule flottante, de sorte que la valeur représentable la plus positive est mappée à 1.0 et la valeur représentable la plus négative est mappée à -1.0. (Notez que ce mappage ne convertit pas 0 précisément en 0.0.) Les valeurs à virgule flottante sont mappées directement.

Ni les valeurs à virgule flottante ni les entiers signés ne sont limitées à la plage [0,1] avant la mise à jour de la couleur actuelle. Toutefois, les composants de couleur sont limités à cette plage avant d’être interpolés ou écrits dans une mémoire tampon de couleur.

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

glEnd

glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv

glIndex