glTextureColorMaskSGIS(3G)

NAME
     glTextureColorMaskSGIS - enable and disable the storing of texture
     element color components


C SPECIFICATION
     void glTextureColorMaskSGIS( GLboolean red,
                                  GLboolean green,
                                  GLboolean blue,
                                  GLboolean alpha )


PARAMETERS
     red, green, blue, alpha
                           Specify whether red, green, blue, alpha, luminance,
                           or intensity components will or will not be stored
                           when defining a texture image.  The initial values
                           are all GL_TRUE, indicating that all color
                           components determined by the internal format of the
                           texture image will be stored.

DESCRIPTION
     glTextureColorMaskSGIS specifies whether the individual color components
     of the texture elements in the image being defined by glTexImage1D,
     glTexImage2D, glTexImage3D, glTexSubImage1D, glTexSubImage2D,
     glTexSubImage3D, glCopyTexImage1D, glCopyTexImage2D, glCopyTexImage3D,
     glCopySubTexImage1D, glCopySubTexImage2D or glCopySubTexImage3D will or
     will not be stored.  If red is GL_FALSE, no change is made to the red,
     luminance or intensity component of any texture element in the image
     being defined.  If green, blue or alpha is GL_FALSE, no change is made to
     the corresponding component of any texture element in the image being
     defined.

     When a texture image is being defined for the first time, the values of
     components that are not stored as a result of the texture color mask are
     undefined.

     glTextureColorMaskSGIS has no effect on the definition of texture images
     with an index or depth component internal format.

ERRORS
     GL_INVALID_OPERATION is generated if glTextureColorMaskSGIS is executed
     between the execution of glBegin and the corresponding execution of
     glEnd.

ASSOCIATED GETS
     glGet with argument GL_TEXTURE_COLOR_WRITEMASK_SGIS
MACHINE DEPENDENCIES
     The SGIS_texture_color_mask extension is only supported on Octane2 VPro
     systems.


SEE ALSO
     glTexImage1D, glTexImage2D, glTexImage3D, glTexSubImage1D,
     glTexSubImage2D, glTexSubImage3D, glCopyTexImage1D, glCopyTexImage2D,
     glCopyTexImage3D, glCopySubTexImage1D, glCopySubTexImage2D,
     glCopySubTexImage3D