fglTextureColorMaskSGIS(3G)

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


FORTRAN SPECIFICATION
     SUBROUTINE fglTextureColorMaskSGIS( LOGICAL*1 red,
                                         LOGICAL*1 green,
                                         LOGICAL*1 blue,
                                         LOGICAL*1 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
     fglTextureColorMaskSGIS specifies whether the individual color components
     of the texture elements in the image being defined by fglTexImage1D,
     fglTexImage2D, fglTexImage3D, fglTexSubImage1D, fglTexSubImage2D,
     fglTexSubImage3D, fglCopyTexImage1D, fglCopyTexImage2D,
     fglCopyTexImage3D, fglCopySubTexImage1D, fglCopySubTexImage2D or
     fglCopySubTexImage3D 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.

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

ERRORS
     GL_INVALID_OPERATION is generated if fglTextureColorMaskSGIS is executed
     between the execution of fglBegin and the corresponding execution of
     fglEnd.

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


SEE ALSO
     fglTexImage1D, fglTexImage2D, fglTexImage3D, fglTexSubImage1D,
     fglTexSubImage2D, fglTexSubImage3D, fglCopyTexImage1D, fglCopyTexImage2D,
     fglCopyTexImage3D, fglCopySubTexImage1D, fglCopySubTexImage2D,
     fglCopySubTexImage3D