NAME

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 - set the current color

C SPECIFICATION

void ggllCCoolloorr33bb( GLbyte _r_e_d,
                GLbyte _g_r_e_e_n,
                GLbyte _b_l_u_e )
void ggllCCoolloorr33dd( GLdouble _r_e_d,
                GLdouble _g_r_e_e_n,
                GLdouble _b_l_u_e )
void ggllCCoolloorr33ff( GLfloat _r_e_d,
                GLfloat _g_r_e_e_n,
                GLfloat _b_l_u_e )
void ggllCCoolloorr33ii( GLint _r_e_d,
                GLint _g_r_e_e_n,
                GLint _b_l_u_e )
void ggllCCoolloorr33ss( GLshort _r_e_d,
                GLshort _g_r_e_e_n,
                GLshort _b_l_u_e )
void ggllCCoolloorr33uubb( GLubyte _r_e_d,
                 GLubyte _g_r_e_e_n,
                 GLubyte _b_l_u_e )
void ggllCCoolloorr33uuii( GLuint _r_e_d,
                 GLuint _g_r_e_e_n,
                 GLuint _b_l_u_e )
void ggllCCoolloorr33uuss( GLushort _r_e_d,
                 GLushort _g_r_e_e_n,
                 GLushort _b_l_u_e )
void ggllCCoolloorr44bb( GLbyte _r_e_d,
                GLbyte _g_r_e_e_n,
                GLbyte _b_l_u_e,
                GLbyte _a_l_p_h_a )
void ggllCCoolloorr44dd( GLdouble _r_e_d,
                GLdouble _g_r_e_e_n,
                GLdouble _b_l_u_e,
                GLdouble _a_l_p_h_a )
void ggllCCoolloorr44ff( GLfloat _r_e_d,
                GLfloat _g_r_e_e_n,
                GLfloat _b_l_u_e,
                GLfloat _a_l_p_h_a )
void ggllCCoolloorr44ii( GLint _r_e_d,
                GLint _g_r_e_e_n,
                GLint _b_l_u_e,
                GLint _a_l_p_h_a )
void ggllCCoolloorr44ss( GLshort _r_e_d,
                GLshort _g_r_e_e_n,
                GLshort _b_l_u_e,
                GLshort _a_l_p_h_a )
void ggllCCoolloorr44uubb( GLubyte _r_e_d,
                 GLubyte _g_r_e_e_n,
                 GLubyte _b_l_u_e,
                 GLubyte _a_l_p_h_a )
void ggllCCoolloorr44uuii( GLuint _r_e_d,
                 GLuint _g_r_e_e_n,
                 GLuint _b_l_u_e,
                 GLuint _a_l_p_h_a )
void ggllCCoolloorr44uuss( GLushort _r_e_d,
                 GLushort _g_r_e_e_n,
                 GLushort _b_l_u_e,
                 GLushort _a_l_p_h_a )

delim $$

PARAMETERS

_r_e_d, _g_r_e_e_n, _b_l_u_e
Specify new red, green, and blue values for the current color.
_a_l_p_h_a
Specifies a new alpha value for the current color. Included only in the four-argument ggllCCoolloorr44 commands.

C SPECIFICATION

void ggllCCoolloorr33bbvv( const GLbyte _*_v )

void ggllCCoolloorr33ddvv(
const GLdouble _*_v )


void ggllCCoolloorr33ffvv(
const GLfloat _*_v )


void ggllCCoolloorr33iivv(
const GLint _*_v )


void ggllCCoolloorr33ssvv(
const GLshort _*_v )


void ggllCCoolloorr33uubbvv(
const GLubyte _*_v )


void ggllCCoolloorr33uuiivv(
const GLuint _*_v )


void ggllCCoolloorr33uussvv(
const GLushort _*_v )


void ggllCCoolloorr44bbvv(
const GLbyte _*_v )


void ggllCCoolloorr44ddvv(
const GLdouble _*_v )


void ggllCCoolloorr44ffvv(
const GLfloat _*_v )


void ggllCCoolloorr44iivv(
const GLint _*_v )


void ggllCCoolloorr44ssvv(
const GLshort _*_v )


void ggllCCoolloorr44uubbvv(
const GLubyte _*_v )


void ggllCCoolloorr44uuiivv(
const GLuint _*_v )


void ggllCCoolloorr44uussvv(
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. ggllCCoolloorr sets a new four-valued RGBA color. ggllCCoolloorr has two major variants: ggllCCoolloorr33 and ggllCCoolloorr44. ggllCCoolloorr33 variants specify new red, green, and blue values explicitly and set the current alpha value to 1.0 (full intensity) implicitly. ggllCCoolloorr44 variants specify all four color components explicitly.

ggllCCoolloorr33bb, ggllCCoolloorr44bb, ggllCCoolloorr33ss, ggllCCoolloorr44ss, ggllCCoolloorr33ii, and ggllCCoolloorr44ii take three or four signed byte, short, or long integers as arguments. When vv 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 , with unspecified 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 convert 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 components 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, ggllCCoolloorr can be called between a call to ggllBBeeggiinn and the corresponding call to ggllEEnndd.

ASSOCIATED GETS

ggllGGeett with argument GGLL__CCUURRRREENNTT__CCOOLLOORR
ggllGGeett with argument GGLL__RRGGBBAA__MMOODDEE

SEE ALSO

ggllIInnddeexx((33GG))