glColorMask.3gl

Name

  glColorMask -	enable and disable writing of frame buffer color components

C Specification

  void glColorMask( GLboolean red,

		    GLboolean green,

		    GLboolean blue,

		    GLboolean alpha )

Parameters

  red, green, blue, alpha

			Specify	whether	red, green, blue, and alpha can	or

			cannot be written into the frame buffer.  The default

			values are all GL_TRUE,	indicating that	the color

			components can be written.

Description

  glColorMask specifies	whether	the individual color components	in the frame

  buffer can or	cannot be written.  If red is GL_FALSE,	for example, no

  change is made to the	red component of any pixel in any of the color

  buffers, regardless of the drawing operation attempted.



  Changes to individual	bits of	components cannot be controlled.  Rather,

  changes are either enabled or	disabled for entire color components.

Errors

  GL_INVALID_OPERATION is generated if glColorMask is executed between the

  execution of glBegin and the corresponding execution of glEnd.

Associated Gets

  glGet	with argument GL_COLOR_WRITEMASK

  glGet	with argument GL_RGBA_MODE

See Also

  glColor, glIndex, glIndexMask, glDepthMask, glStencilMask

Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV