*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> OpenGL/glcolormaterial (3)              


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

     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

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

     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
[ Back ]
 Similar pages
Name OS Title
glfragmentcolormaterial IRIX cause a fragment material color to track the current fragment color
DXmColorMixGetNewColor Tru64 Retrieves (returns) the color mixing widget's current new color red, green, and blue values.
DXmColorMixSetNewColor Tru64 Sets the new color red, green, and blue values in the color mixing widget.
SgColorChooserSetStoredColor IRIX A ColorChooser function that sets the color of the ColorChooser's stored color swatch
xcmsdb Tru64 Device Color Characterization utility for X Color Management System
xcmsdb HP-UX Device Color Characterization utility for X Color Management System
xcmsdb IRIX Device Color Characterization utility for X Color Management System
glColor4iv Tru64 set the current color
glColor4d Tru64 set the current color
glColor4f Tru64 set the current color
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service