| Extracted from Pike v7.8 release 866 at 2018-07-18.

[Top]
GL

# Method GL.glColorMaterial()

Method glColorMaterial

  `void glColorMaterial(int face, int mode)`

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.

Parameter `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 .

Parameter `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 .

Throws

  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 .