glColorMaterial : PyOpenGL 3.1.4 GL Man Pages

cause a material color to track the current color

Signature

glColorMaterial( GLenum ( face ) , GLenum ( mode ) )-> void

glColorMaterial( face , mode )

Parameters

Variables	Description
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

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

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

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

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

Associated Gets

glIsEnabled with argument GL_COLOR_MATERIAL

glGet with argument GL_COLOR_MATERIAL_PARAMETER

glGet with argument GL_COLOR_MATERIAL_FACE

Copyright

1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/ .

Sample Code References

The following code samples have been found which appear to reference the functions described here. Take care that the code may be old, broken or not even use PyOpenGL.

glColorMaterial

OpenGLContext OpenGLContext/scenegraph/spherebackground.py Lines: 50

OpenGLContext OpenGLContext/scenegraph/indexedpolygons.py Lines: 26, 75

OpenGLContext OpenGLContext/scenegraph/arraygeometry.py Lines: 150

OpenGLContext OpenGLContext/scenegraph/pointset.py Lines: 64

OpenGL-Demo PyOpenGL-Demo/dek/OglSurface/triangle.py Lines: 49

OpenGL-Demo PyOpenGL-Demo/GLE/maintest.py Lines: 64

{LGPL} PyMT pymt/obj.py Lines: 21, 53

{LGPL} Pyggel pyggel/view.py Lines: 160

Visvis wobjects/polygonalModeling.py Lines: 983

{GPL3} OpenGL-Programmable 03-array.py Lines: 252

{GPL3} OpenGL-Programmable 02-displaylist.py Lines: 250

{GPL3} OpenGL-Programmable 04-vbo.py Lines: 271

{GPL3} OpenGL-Programmable 01-direct.py Lines: 241