- cause a material color to track the current color



C SPECIFICATION


PARAMETERS

       _param1  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.

       _param2  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 _param2, of
       the material or materials specified by _param1, 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 sub-
       set 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 indetermi-
       nate, if the color array is enabled.   If  glColorMaterial
       is  enabled  while the current color is indeterminate, the
       lighting material state specified by _param1  and  _param2
       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

       glDrawRangeElements,   glEnable,   glLight,  glLightModel,
       glMaterial



                                                                1