NAME

glColorMask - enable and disable writing of frame buffer color components

C SPECIFICATION

void ggllCCoolloorrMMaasskk( GLboolean _r_e_d,
                  GLboolean _g_r_e_e_n,
                  GLboolean _b_l_u_e,
                  GLboolean _a_l_p_h_a )

PARAMETERS

_r_e_d, _g_r_e_e_n, _b_l_u_e, _a_l_p_h_a
Specify whether red, green, blue, and alpha can or cannot be written into the frame buffer. The initial values are all GGLL__TTRRUUEE, indicating that the color components can be written.

DESCRIPTION

ggllCCoolloorrMMaasskk specifies whether the individual color components in the frame buffer can or cannot be written. If _r_e_d is GGLL__FFAALLSSEE, 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

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

ASSOCIATED GETS

ggllGGeett with argument GGLL__CCOOLLOORR__WWRRIITTEEMMAASSKK
ggllGGeett with argument GGLL__RRGGBBAA__MMOODDEE

SEE ALSO

ggllCClleeaarr((33GG)), ggllCCoolloorr((33GG)), ggllCCoolloorrPPooiinntteerr((33GG)), ggllDDeepptthhMMaasskk((33GG)), ggllIInnddeexx((33GG)), ggllIInnddeexxPPooiinntteerr((33GG)), ggllIInnddeexxMMaasskk((33GG)), ggllSStteenncciillMMaasskk((33GG))