GLCOLORMATERIAL(3G) UNIX Programmer's Manual GLCOLORMATERIAL(3G)
glColorMaterial - cause a material color to track the
current color
void glColorMaterial( GLenum face,
GLenum mode )
face Specifies whether front, back, or both front and back
material parameters should track the current color.
Accepted values are GL_FRONT, GL_BACK, and
GL_FRONT_AND_BACK. The initial value is
GL_FRONT_AND_BACK.
mode Specifies which of several material parameters track
the current color. Accepted values are GL_EMISSION,
GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR, and
GL_AMBIENT_AND_DIFFUSE. The initial value is
GL_AMBIENT_AND_DIFFUSE.
glColorMaterial specifies which material parameters track
the current color. When GL_COLOR_MATERIAL is enabled, the
material parameter or parameters specified by mode, of the
material or materials specified by face, track the current
color at all times.
To enable and disable GL_COLOR_MATERIAL, call glEnable and
glDisable with argument GL_COLOR_MATERIAL. GL_COLOR_MATERIAL
is initially disabled.
glColorMaterial makes it possible to change a subset of
material parameters for each vertex using only the glColor
command, without calling glMaterial. If only such a subset
of parameters is to be specified for each vertex, calling
glColorMaterial is preferable to calling glMaterial.
Call glColorMaterial before enabling GL_COLOR_MATERIAL.
Calling glDrawElements, glDrawArrays, or glDrawRangeElements
may leave the current color indeterminate, if the color
array is enabled. If glColorMaterial is enabled while the
current color is indeterminate, the lighting material state
specified by face and mode is also indeterminate.
If the GL version is 1.1 or greater, and GL_COLOR_MATERIAL
is enabled, evaluated color values affect the results of the
lighting equation as if the current color were being
MirOS BSD #10-current Printed 20.2.2012 1
GLCOLORMATERIAL(3G) UNIX Programmer's Manual GLCOLORMATERIAL(3G)
modified, but no change is made to the tracking lighting
parameter of the current color.
GL_INVALID_ENUM is generated if face or mode is not an
accepted value.
GL_INVALID_OPERATION is generated if glColorMaterial is exe-
cuted between the execution of glBegin and the corresponding
execution of glEnd.
glIsEnabled with argument GL_COLOR_MATERIAL
glGet with argument GL_COLOR_MATERIAL_PARAMETER
glGet with argument GL_COLOR_MATERIAL_FACE
glColor(3G), glColorPointer(3G), glDrawArrays(3G),
glDrawElements(3G), glDrawRangeElements(3G), glEnable(3G),
glLight(3G), glLightModel(3G), glMaterial(3G)
MirOS BSD #10-current Printed 20.2.2012 2
Generated on 2012-02-20 02:47:02 by $MirOS: src/scripts/roff2htm,v 1.70 2011/12/03 18:21:12 tg Exp $
These manual pages and other documentation are copyrighted by their respective writers;
their source is available at our CVSweb,
AnonCVS, and other mirrors. The rest is Copyright © 2002‒2011 The MirOS Project, Germany.
This product includes material
provided by Thorsten Glaser.
This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.