Ler em inglês

Compartilhar via


Função glClear

A função glClear limpa buffers para valores predefinidos.

Sintaxe

void WINAPI glClear(
   GLbitfield mask
);

Parâmetros

mask

Operadores OR bit a bit de máscaras que indicam os buffers a serem limpos. As quatro máscaras são as seguintes.

Valor Significado
GL_COLOR_BUFFER_BIT
Os buffers atualmente habilitados para gravação de cores.
GL_DEPTH_BUFFER_BIT
O buffer de profundidade.
GL_ACCUM_BUFFER_BIT
O buffer de acumulação.
GL_STENCIL_BUFFER_BIT
O buffer de estêncil.

Retornar valor

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

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome Significado
GL_INVALID_VALUE
Qualquer bit diferente dos quatro bits definidos foi definido em máscara.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glClear define a área de bitplane da janela como valores selecionados anteriormente por glClearColor, glClearIndex, glClearDepth, glClearStencil e glClearAccum. Você pode limpar vários buffers de cores simultaneamente selecionando mais de um buffer por vez usando glDrawBuffer.

O teste de propriedade de pixel, o teste de tesoura, o dithering e as máscaras de gravação do buffer afetam a operação do glClear. A caixa de tesoura delimita a região desmarcada. A função glClear ignora a função alfa, a função blend, a operação lógica, o estêncil, o mapeamento de textura e o buffer z.

A função glClear usa um único argumento (máscara) que é o OR bit a bit de vários valores que indicam qual buffer deve ser limpo.

O valor para o qual cada buffer é limpo depende da configuração do valor claro para esse buffer.

Se um buffer não estiver presente, uma chamada glClear direcionada a esse buffer não terá efeito.

As seguintes funções recuperam informações relacionadas ao glClear:

glGet com GL_ACCUM_CLEAR_VALUE de argumento

glGet com GL_DEPTH_CLEAR_VALUE de argumento

glGet com GL_INDEX_CLEAR_VALUE de argumento

glGet com GL_COLOR_CLEAR_VALUE de argumento

glGet com GL_STENCIL_CLEAR_VALUE 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

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor