glFragmentColorMaterial(3G)

NAME
     glFragmentColorMaterialSGIX - cause a fragment material color to track
     the current fragment color


C SPECIFICATION
     void glFragmentColorMaterialSGIX( GLenum face,
                                       GLenum mode )


PARAMETERS
     face  Specifies whether front, back, or both front and back fragment
           material parameters should track the current fragment 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 fragment material parameters track the
           current fragment 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
     glFragmentColorMaterial specifies which fragment material parameters
     track the current fragment color.  When GL_FRAGMENT_COLOR_MATERIAL_SGIX
     is enabled, the material parameter or parameters specified by mode, of
     the material or materials specified by face, track the evaluated fragment
     color at each vertex.

     To enable and disable GL_FRAGMENT_COLOR_MATERIAL_SGIX, call glEnable and
     glDisable with argument GL_FRAGMENT_COLOR_MATERIAL_SGIX.
     GL_FRAGMENT_COLOR_MATERIAL_SGIX is initially disabled.

NOTES
     If GL_FRAGMENT_COLOR_MATERIAL_SGIX is enabled the specified fragment
     material parameters used in fragment lighting calculations will track the
     fragment color calculated by the regular OpenGL Color and Lighting
     operations.  Other parameters will use values specified by the most
     recent call to glFragmentMaterial at the time of the provoking vertex.

     Note that the color used is the result after applying all regular OpenGL
     Lighting calculations, not simply the color supplied in the most recent
     call to glColor.

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

     GL_INVALID_OPERATION is generated if glFragmentColorMaterial is executed
     between the execution of glBegin and the corresponding execution of
     glEnd.
ASSOCIATED GETS
     glIsEnabled with argument GL_FRAGMENT_COLOR_MATERIAL_SGIX
     glGet with argument GL_FRAGMENT_COLOR_MATERIAL_PARAMETER_SGIX
     glGet with argument GL_FRAGMENT_COLOR_MATERIAL_FACE_SGIX


MACHINE DEPENDENCIES
     The SGIX_fragment_lighting extension is supported only on Octane2 VPro
     systems.


SEE ALSO
     glColor, glEnable, glFragmentLight, glFragmentLightModel,
     glFragmentMaterial