Função glColorMask

A função glColorMask habilita e desabilita a gravação de componentes de cor do buffer de quadros.

Sintaxe

void WINAPI glColorMask(
   GLboolean red,
   GLboolean green,
   GLboolean blue,
   GLboolean alpha
);

Parâmetros

red

Especifique se vermelho pode ou não ser gravado no framebuffer. Os valores padrão são GL_TRUE, indicando que o componente de cor pode ser gravado.

green

Especifique se o verde pode ou não ser gravado no framebuffer. O valor padrão é GL_TRUE, indicando que o componente de cor pode ser gravado.

blue

Especifique se o azul pode ou não ser gravado no framebuffer. O valor padrão é GL_TRUE, indicando que o componente de cor pode ser gravado.

alfa

Especifique se alfa pode ou não ser gravado no framebuffer. O valor padrão é GL_TRUE, indicando que o componente de cor pode ser gravado.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Nome	Significado
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glColorMask especifica se os componentes de cor individuais no framebuffer podem ou não ser gravados. Se vermelho for GL_FALSE, por exemplo, nenhuma alteração será feita no componente vermelho de qualquer pixel em qualquer um dos buffers de cores, independentemente da tentativa de operação de desenho.

As alterações em bits individuais de componentes não podem ser controladas. Em vez disso, as alterações são habilitadas ou desabilitadas para componentes de cor inteiros.

As seguintes funções recuperam informações relacionadas a glColorMask:

glGet com GL_COLOR_WRITEMASK de argumento

glGet com GL_RGBA_MODE de argumento

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glColor

glDepthMask

glEnd

glGet

glIndex

glIndexMask

glStencilMask