The glIndexMask function controls the writing of individual bits in the color-index buffers.
void glIndexMask( GLuint mask );
- A bit mask to enable and disable the writing of individual bits in the color-index buffers. Initially, the mask is all ones.
The glIndexMask function controls the writing of individual bits in the color-index buffers. The least significant n bits of mask, where n is the number of bits in a color-index buffer, specify a mask. Wherever a one appears in the mask, the corresponding bit in the color-index buffer (or buffers) is made writable. Where a zero appears, the bit is write-protected.
This mask is used only in color-index mode, and it affects only the buffers currently selected for writing (see glDrawBuffer). Initially, all bits are enabled for writing.
The following function retrieves information related to glIndexMask:
glGet with argument GL_INDEX_WRITEMASK
The following is the error code and its condition.
|GL_INVALID_OPERATION||glIndexMask was called between a call to glBegin and the corresponding call to glEnd.|
Windows NT/2000: Requires Windows NT 3.5 or later.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in Gl.h.
Library: Use Opengl32.lib.