NAME

glIndexMask - control the writing of individual bits in the color index buffers

C SPECIFICATION

void ggllIInnddeexxMMaasskk( GLuint _m_a_s_k )

        

delim $$

PARAMETERS

_m_a_s_k
Specifies a bit mask to enable and disable the writing of individual bits in the color index buffers. Initially, the mask is all 1's.

DESCRIPTION

ggllIInnddeexxMMaasskk controls the writing of individual bits in the color index buffers. The least significant $n$ bits of _m_a_s_k, where $n$ is the number of bits in a color index buffer, specify a mask. Where a 1 (one) appears in the mask, it's possible to write to the corresponding bit in the color index buffer (or buffers). Where a 0 (zero) appears, the corresponding bit is write-protected.

This mask is used only in color index mode, and it affects only the buffers currently selected for writing (see ggllDDrraawwBBuuffffeerr). Initially, all bits are enabled for writing.

ERRORS

GGLL__IINNVVAALLIIDD__OOPPEERRAATTIIOONN is generated if ggllIInnddeexxMMaasskk is executed between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd.

ASSOCIATED GETS

ggllGGeett with argument GGLL__IINNDDEEXX__WWRRIITTEEMMAASSKK

SEE ALSO

ggllCCoolloorrMMaasskk((33GG)), ggllDDeepptthhMMaasskk((33GG)), ggllDDrraawwBBuuffffeerr((33GG)), ggllIInnddeexx((33GG)), ggllIInnddeexxPPooiinntteerr((33GG)), ggllSStteenncciillMMaasskk((33GG))