Nom

glColor3b, glColor3d, glColor3f, glColor3i, glColor3s, glColor3ub, glColor3ui, glColor3us, glColor4b, glColor4d, glColor4f, glColor4i, glColor4s, glColor4ub, glColor4ui, glColor4us, glColor3bv, glColor3dv, glColor3fv, glColor3iv, glColor3sv, glColor3ubv, glColor3uiv, glColor3usv, glColor4bv, glColor4dv, glColor4fv, glColor4iv, glColor4sv, glColor4ubv, glColor4uiv, glColor4usv - modifie la couleur courante

SpÉcification c

void f3glColor3b( GLbyte rouge, .nf .ta w'f3void glColor3b( 'u GLbyte vert, GLbyte bleu ) .fi void f3glColor3d( GLdouble rouge, .nf .ta w'f3void glColor3d( 'u GLdouble vert, GLdouble bleu ) .fi void f3glColor3f( GLfloat rouge, .nf .ta w'f3void glColor3f( 'u GLfloat vert, GLfloat bleu ) .fi void f3glColor3i( GLint rouge, .nf .ta w'f3void glColor3i( 'u GLint vert, GLint bleu ) .fi void f3glColor3s( GLshort rouge, .nf .ta w'f3void glColor3s( 'u GLshort vert, GLshort bleu ) .fi void f3glColor3ub( GLubyte rouge, .nf .ta w'f3void glColor3ub( 'u GLubyte vert, GLubyte bleu ) .fi void f3glColor3ui( GLuint rouge, .nf .ta w'f3void glColor3ui( 'u GLuint vert, GLuint bleu ) .fi void f3glColor3us( GLushort rouge, .nf .ta w'f3void glColor3us( 'u GLushort vert, GLushort bleu ) .fi void f3glColor4b( GLbyte rouge, .nf .ta w'f3void glColor4b( 'u GLbyte vert, GLbyte bleu, GLbyte alpha ) .fi void f3glColor4d( GLdouble rouge, .nf .ta w'f3void glColor4d( 'u GLdouble vert, GLdouble bleu, GLdouble alpha ) .fi void f3glColor4f( GLfloat rouge, .nf .ta w'f3void glColor4f( 'u GLfloat vert, GLfloat bleu, GLfloat alpha ) .fi void f3glColor4i( GLint rouge, .nf .ta w'f3void glColor4i( 'u GLint vert, GLint bleu, GLint alpha ) .fi void f3glColor4s( GLshort rouge, .nf .ta w'f3void glColor4s( 'u GLshort vert, GLshort bleu, GLshort alpha ) .fi void f3glColor4ub( GLubyte rouge, .nf .ta w'f3void glColor4ub( 'u GLubyte vert, GLubyte bleu, GLubyte alpha ) .fi void f3glColor4ui( GLuint rouge, .nf .ta w'f3void glColor4ui( 'u GLuint vert, GLuint bleu, GLuint alpha ) .fi void f3glColor4us( GLushort rouge, .nf .ta w'f3void glColor4us( 'u GLushort vert, GLushort bleu, GLushort alpha ) .fi .EQ delim $$ .EN

ParamÈtres

f2rouge, f2vert, f2bleu Spécifie les nouvelles valeurs des composantes rouge, verte et bleue de la couleur courante.

f2alpha Spécifie la nouvelle valeur alpha (niveau de transparence) de la couleur courante. Incluse seulement dans les commandes %f3glColor4 à quatre paramètres.

SpÉcification c

void f3glColor3bv( const GLbyte *v ) .nf .fi void f3glColor3dv( const GLdouble *v ) .nf .fi void f3glColor3fv( const GLfloat *v ) .nf .fi void f3glColor3iv( const GLint *v ) .nf .fi void f3glColor3sv( const GLshort *v ) .nf .fi void f3glColor3ubv( const GLubyte *v ) .nf .fi void f3glColor3uiv( const GLuint *v ) .nf .fi void f3glColor3usv( const GLushort *v ) .nf .fi void f3glColor4bv( const GLbyte *v ) .nf .fi void f3glColor4dv( const GLdouble *v ) .nf .fi void f3glColor4fv( const GLfloat *v ) .nf .fi void f3glColor4iv( const GLint *v ) .nf .fi void f3glColor4sv( const GLshort *v ) .nf .fi void f3glColor4ubv( const GLubyte *v ) .nf .fi void f3glColor4uiv( const GLuint *v ) .nf .fi void f3glColor4usv( const GLushort *v ) .nf .fi

ParamÈtres

f2v Spécifie un pointeur sur un tableau qui contient les valeurs des composantes rouge, verte, bleue et (parfois) alpha.

Description

La GL stocke la couleur courante simultanément sous la forme d'un index de couleur et d'un quartuplet de composantes RGBA. %f3glColor configure une nouvelle couleur à quatre composantes RGBA. %f3glColor a deux variantes principales : %f3glColor3 et %f3glColor4. La variante %f3glColor3 spécifie les nouvelles valeurs des composantes rouge, verte, et bleue explicitement et configure la nouvelle valeur courante alpha à 1.0 (intensité maximum) implicitement. La variante %f3glColor4 spécifie toutes les quatre composantes de couleur explicitement.

%f3glColor3b, %f3glColor4b, %f3glColor3s, %f3glColor4s, %f3glColor3i, et %f3glColor4i prennent comme paramètres trois ou quatre signed byte, short, ou long integers. Quand f3v est ajouté au nom de la fonction, les commandes de couleur prennent comme paramètre un pointeur sur un tableau de telles valeurs.

Les valeurs courantes de la couleur sont stockées en flottant, avec des tailles de mantisse et d'exposent non spécifiées. Les composantes de couleurs unsigned integer, quand spécifiées, sont converties linéairement en valeurs flottantes de manière à ce que la plus grande valeur représentable soit convertie en 1.0 (intensité maximale), et 0 est convertie en 0.0 (intensité zéro). Des composantes de couleur en signed integer, quand specifiées, sont converties linéairement en valeurs flottantes de telle manière que la plus grande valeur positive représentable soit convertie en 1.0, et la plus grande valeur négative représentable soit convertie en -1.0. (Notez que cette conversion ne convertit pas 0 en précisément 0.0.) Des valeurs flottantes n'ont pas besoin de conversion.

Ni les valeurs flottantes, ni les valeurs entières ne sont limitées à l'intervalle [0,1] avant de mettre à jour la couleur courante. Toutefois, les composantes de la couleur sont limitées avant d'être interpolées ou écrites dans le buffer des couleurs.

Notes

Les valeurs initiales de la couleur courante sont (1, 1, 1, 1).

La couleur courante peut être modifiée à n'importe quel moment. En particulier, %f3glColor peut être appelé entre un appel à %f3glBegin et l'appel correspondant à %f3glEnd.

Gets associÉs

%f3glGet avec l'argument %f3GL_CURRENT_COLOR %f3glGet avec l'argument %f3GL_RGBA_MODE

Voir aussi

%f3glIndex(3G)

Traduction

Sylvain Vignaud < sylvain@vignaud.org >, 2002