glColorMaterial(3G)	       OpenGL Reference		   glColorMaterial(3G)

NAME    [Toc]    [Back]

     glColorMaterial - cause a material	color to track the current color

C SPECIFICATION    [Toc]    [Back]

     void glColorMaterial( GLenum face,
			   GLenum mode )

PARAMETERS    [Toc]    [Back]

     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.

DESCRIPTION    [Toc]    [Back]

     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.

NOTES    [Toc]    [Back]

     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 modified, but	no change is made to the
     tracking lighting parameter of the	current	color.

ERRORS    [Toc]    [Back]

     GL_INVALID_ENUM is	generated if face or mode is not an accepted value.





									Page 1






glColorMaterial(3G)	       OpenGL Reference		   glColorMaterial(3G)



     GL_INVALID_OPERATION is generated if glColorMaterial is executed between
     the execution of glBegin and the corresponding execution of glEnd.

ASSOCIATED GETS    [Toc]    [Back]

     glIsEnabled with argument GL_COLOR_MATERIAL
     glGet with	argument GL_COLOR_MATERIAL_PARAMETER
     glGet with	argument GL_COLOR_MATERIAL_FACE


MACHINE	DEPENDENCIES
     On	RealityEngine, RealityEngine2, and VTX systems,	GL_AMBIENT_AND_DIFFUSE
     mode does not work	correctly.

SEE ALSO    [Toc]    [Back]

     glColor, glColorPointer, glDrawArrays, glDrawElements,
     glDrawRangeElements, glEnable, glLight, glLightModel, glMaterial


									PPPPaaaaggggeeee 2222