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 glColor3b( GLbyte rouge,

	GLbyte vert,
	GLbyte bleu )

void glColor3d( GLdouble rouge,

	GLdouble vert,
	GLdouble bleu )

void glColor3f( GLfloat rouge,

	GLfloat vert,
	GLfloat bleu )

void glColor3i( GLint rouge,

	GLint vert,
	GLint bleu )

void glColor3s( GLshort rouge,

	GLshort vert,
	GLshort bleu )

void glColor3ub( GLubyte rouge,

	GLubyte vert,
	GLubyte bleu )

void glColor3ui( GLuint rouge,

	GLuint vert,
	GLuint bleu )

void glColor3us( GLushort rouge,

	GLushort vert,
	GLushort bleu )

void glColor4b( GLbyte rouge,

	GLbyte vert,
	GLbyte bleu,
	GLbyte alpha )

void glColor4d( GLdouble rouge,

	GLdouble vert,
	GLdouble bleu,
	GLdouble alpha )

void glColor4f( GLfloat rouge,

	GLfloat vert,
	GLfloat bleu,
	GLfloat alpha )

void glColor4i( GLint rouge,

	GLint vert,
	GLint bleu,
	GLint alpha )

void glColor4s( GLshort rouge,

	GLshort vert,
	GLshort bleu,
	GLshort alpha )

void glColor4ub( GLubyte rouge,

	GLubyte vert,
	GLubyte bleu,
	GLubyte alpha )

void glColor4ui( GLuint rouge,

	GLuint vert,
	GLuint bleu,
	GLuint alpha )

void glColor4us( GLushort rouge,

	GLushort vert,
	GLushort bleu,
	GLushort alpha )

PARAMÈTRES¶

rouge, vert, bleu

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

alpha

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

SPÉCIFICATION C¶

void glColor3bv( const GLbyte *v )

void glColor3dv( const GLdouble *v )

void glColor3fv( const GLfloat *v )

void glColor3iv( const GLint *v )

void glColor3sv( const GLshort *v )

void glColor3ubv( const GLubyte *v )

void glColor3uiv( const GLuint *v )

void glColor3usv( const GLushort *v )

void glColor4bv( const GLbyte *v )

void glColor4dv( const GLdouble *v )

void glColor4fv( const GLfloat *v )

void glColor4iv( const GLint *v )

void glColor4sv( const GLshort *v )

void glColor4ubv( const GLubyte *v )

void glColor4uiv( const GLuint *v )

void glColor4usv( const GLushort *v )

PARAMÈTRES¶

v

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. glColor configure une nouvelle couleur à quatre composantes RGBA. glColor a deux variantes principales : glColor3 et glColor4. La variante glColor3 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 glColor4 spécifie toutes les quatre composantes de couleur explicitement.

glColor3b, glColor4b, glColor3s, glColor4s, glColor3i, et glColor4i prennent comme paramètres trois ou quatre signed byte, short, ou long integers. Quand v 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, glColor peut être appelé entre un appel à glBegin et l'appel correspondant à glEnd.

GETS ASSOCIÉS¶

glGet avec l'argument GL_CURRENT_COLOR
glGet avec l'argument GL_RGBA_MODE

VOIR AUSSI¶

glIndex(3G)

TRADUCTION¶

Sylvain Vignaud <sylvain@vignaud.org>, 2002