glColor4s, glColor4ub, glColor4ui, glColor4us, glColor3bv, glColor3dv,
glColor3fv, glColor3iv, glColor3sv, glColor3ubv, glColor3uiv,
glColor3usv, glColor4bv, glColor4dv, glColor4fv, glColor4iv,
glColor4sv, glColor4ubv, glColor4uiv, glColor4usv - set the current
color
C SPECIFICATION
void GLAPIENTRY glColor3b( GLbyte red,
GLbyte green,
GLbyte blue )
void GLAPIENTRY glColor3d( GLdouble red,
GLdouble green,
GLdouble blue )
void GLAPIENTRY glColor3f( GLfloat red,
GLfloat green,
GLfloat blue )
void GLAPIENTRY glColor3i( GLint red,
GLint green,
GLint blue )
void GLAPIENTRY glColor3s( GLshort red,
GLshort green,
GLshort blue )
void GLAPIENTRY glColor3ub( GLubyte red,
GLubyte green,
GLubyte blue )
void GLAPIENTRY glColor3ui( GLuint red,
GLuint green,
GLuint blue )
void GLAPIENTRY glColor3us( GLushort red,
GLushort green,
GLushort blue )
void GLAPIENTRY glColor4b( GLbyte red,
GLbyte gree )
void GLAPIENTRY glColor4d( GLdouble red,
GLdouble gree )
void GLAPIENTRY glColor4f( GLfloat red,
GLfloat gree )
void GLAPIENTRY glColor4i( GLint red,
GLint gree )
void GLAPIENTRY glColor4s( GLshort red,
GLshort gree )
void GLAPIENTRY glColor4ub( GLubyte red,
GLubyte gree )
void GLAPIENTRY glColor4ui( GLuint red,
GLuint gree )
void GLAPIENTRY glColor4us( GLushort red,
GLushort gree )
PARAMETERS
red, gree, blue
void GLAPIENTRY glColor3usv( const GLushort *v )
void GLAPIENTRY glColor4bv( const GLbyte *v )
void GLAPIENTRY glColor4dv( const GLdouble *v )
void GLAPIENTRY glColor4fv( const GLfloat *v )
void GLAPIENTRY glColor4iv( const GLint *v )
void GLAPIENTRY glColor4sv( const GLshort *v )
void GLAPIENTRY glColor4ubv( const GLubyte *v )
void GLAPIENTRY glColor4uiv( const GLuint *v )
void GLAPIENTRY glColor4usv( const GLushort *v )
PARAMETERS
v Specifies a pointer to an array that contains red, green, blue,
and (sometimes) alpha values.
DESCRIPTION
The GL stores both a current single-valued color index and a current
four-valued RGBA color. glColor sets a new four-valued RGBA color.
glColor has two major variants: glColor3 and glColor4. glColor3 vari-
ants specify new red, green, and blue values explicitly and set the
current alpha value to 1.0 (full intensity) implicitly. glColor4 vari-
ants specify all four color components explicitly.
glColor3b, glColor4b, glColor3s, glColor4s, glColor3i, and glColor4i
take three or four signed byte, short, or long integers as arguments.
When v is appended to the name, the color commands can take a pointer
to an array of such values.
Current color values are stored in floating-point format, with unspeci-
fied mantissa and exponent sizes. Unsigned integer color components,
when specified, are linearly mapped to floating-point values such that
the largest representable value maps to 1.0 (full intensity), and 0
maps to 0.0 (zero intensity). Signed integer color components, when
specified, are linearly mapped to floating-point values such that the
most positive representable value maps to 1.0, and the most negative
representable value maps to -1.0. (Note that this mapping does not con-
vert 0 precisely to 0.0.) Floating-point values are mapped directly.
Neither floating-point nor signed integer values are clamped to the
range [0,1] before the current color is updated. However, color compo-
nents are clamped to this range before they are interpolated or written
into a color buffer.
NOTES
The initial value for the current color is (1, 1, 1, 1).
The current color can be updated at any time. In particular, glColor
can be called between a call to glBegin and the corresponding call to
glEnd.
ASSOCIATED GETS
glGet with argument GL_CURRENT_COLOR
Man(1) output converted with
man2html