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 |
|---|---|
|
Qualquer bit diferente dos quatro bits definidos foi definido em máscara. |
|
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 |
|
| Biblioteca |
|
| DLL |
|