glColorMaterial man page on Oracle

Man page or keyword search:  
man Server   33470 pages
apropos Keyword Search (all sections)
Output format
Oracle logo
[printable version]

GLCOLORMATERIAL(3G)		 OpenGL Manual		   GLCOLORMATERIAL(3G)

NAME
       glColorMaterial - cause a material color to track the current color

C SPECIFICATION
       void glColorMaterial(GLenum face, GLenum 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
       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

SEE ALSO
       glColor(), glColorPointer(), glDrawArrays(), glDrawElements(),
       glDrawRangeElements(), glEnable(), glLight(), glLightModel(),
       glMaterial()

COPYRIGHT
       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/.

AUTHORS
       opengl.org

opengl.org			  04/29/2014		   GLCOLORMATERIAL(3G)
[top]

List of man pages available for Oracle

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net