fglColorMaterial(3G) OpenGL Reference fglColorMaterial(3G)NAME
fglColorMaterial - cause a material color to track the current color
FORTRAN SPECIFICATION
SUBROUTINE fglColorMaterial( INTEGER*4 face,
INTEGER*4 mode )
PARAMETERS
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
fglColorMaterial 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 fglEnable and fglDisable
with argument GL_COLOR_MATERIAL. GL_COLOR_MATERIAL is initially
disabled.
NOTES
fglColorMaterial makes it possible to change a subset of material
parameters for each vertex using only the fglColor command, without
calling fglMaterial. If only such a subset of parameters is to be
specified for each vertex, calling fglColorMaterial is preferable to
calling fglMaterial.
Call fglColorMaterial before enabling GL_COLOR_MATERIAL.
Calling fglDrawElements, fglDrawArrays, or fglDrawRangeElements may leave
the current color indeterminate, if the color array is enabled. If
fglColorMaterial 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.
Page 1
fglColorMaterial(3G) OpenGL Reference fglColorMaterial(3G)ERRORS
GL_INVALID_ENUM is generated if face or mode is not an accepted value.
GL_INVALID_OPERATION is generated if fglColorMaterial is executed between
the execution of fglBegin and the corresponding execution of fglEnd.
ASSOCIATED GETS
fglIsEnabled with argument GL_COLOR_MATERIAL
fglGet with argument GL_COLOR_MATERIAL_PARAMETER
fglGet 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
fglColor, fglColorPointer, fglDrawArrays, fglDrawElements,
fglDrawRangeElements, fglEnable, fglLight, fglLightModel, fglMaterial
Page 2
