GLSECONDARYCOLOR(3gl)GLSECONDARYCOLOR(3gl)NAME
glSecondaryColor3b, glSecondaryColor3d, glSecondaryColor3f, glSec‐
ondaryColor3i, glSecondaryColor3s, glSecondaryColor3ub, glSecondary‐
Color3ui, glSecondaryColor3us, glSecondaryColor3bv, glSecondary‐
Color3dv, glSecondaryColor3fv, glSecondaryColor3iv, glSecondary‐
Color3sv, glSecondaryColor3ubv, glSecondaryColor3uiv, glSecondary‐
Color3usv - set the current secondary color
C SPECIFICATION
void glSecondaryColor3b( GLbyte red,
GLbyte green,
GLbyte blue )
void glSecondaryColor3d( GLdouble red,
GLdouble green,
GLdouble blue )
void glSecondaryColor3f( GLfloat red,
GLfloat green,
GLfloat blue )
void glSecondaryColor3i( GLint red,
GLint green,
GLint blue )
void glSecondaryColor3s( GLshort red,
GLshort green,
GLshort blue )
void glSecondaryColor3ub( GLubyte red,
GLubyte green,
GLubyte blue )
void glSecondaryColor3ui( GLuint red,
GLuint green,
GLuint blue )
void glSecondaryColor3us( GLushort red,
GLushort green,
GLushort blue )
PARAMETERS
red, green, blue
Specify new red, green, and blue values for the current
secondary color.
C SPECIFICATION
void glSecondaryColor3bv( const GLbyte *v )
void glSecondaryColor3dv( const GLdouble *v )
void glSecondaryColor3fv( const GLfloat *v )
void glSecondaryColor3iv( const GLint *v )
void glSecondaryColor3sv( const GLshort *v )
void glSecondaryColor3ubv( const GLubyte *v )
void glSecondaryColor3uiv( const GLuint *v )
void glSecondaryColor3usv( const GLushort *v )
PARAMETERS
v Specifies a pointer to an array that contains red, green, and
blue values.
DESCRIPTION
glSecondaryColor sets a new three-valued RGB color. The current alpha
value is set to 1.0 implicitly. When v is appended to the name, the
color commands can take a pointer to an array of such values.
Current secondary color values are stored in floating-point format,
with unspecified mantissa and exponent sizes. Unsigned integer color
components, when specified, are linearly mapped to floating-point val‐
ues such that the largest representable value maps to 1.0 (full inten‐
sity), and 0 maps to 0.0 (zero intensity). Signed integer color compo‐
nents, 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 secondary 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 secondary color is (0, 0, 0, 1).
The current secondary color can be updated at any time. In particular,
glSecondaryColor can be called between a call to glBegin and the corre‐
sponding call to glEnd.
ASSOCIATED GETS
glGet with argument GL_CURRENT_SECONDARY_COLOR
SEE ALSO
glColor
12 Feb 04 GLSECONDARYCOLOR(3gl)
