Función glClear

La función glClear borra los búferes en valores preestablecidos.

Sintaxis

void WINAPI glClear(
   GLbitfield mask
);

Parámetros

mask

Operadores OR bit a bit de máscaras que indican los búferes que se van a borrar. Las cuatro máscaras son las siguientes.

Valor	Significado
GL_COLOR_BUFFER_BIT	Los búferes habilitados actualmente para la escritura en color.
GL_DEPTH_BUFFER_BIT	Búfer de profundidad.
GL_ACCUM_BUFFER_BIT	Búfer de acumulación.
GL_STENCIL_BUFFER_BIT	Búfer de galería de símbolos.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar los siguientes códigos de error.

Nombre	Significado
GL_INVALID_VALUE	Cualquier bit distinto de los cuatro bits definidos se estableció en mask.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

La función glClear establece el área de plano de bits de la ventana en valores previamente seleccionados por glClearColor, glClearIndex, glClearDepth, glClearStencil y glClearAccum. Puede borrar varios búferes de color simultáneamente seleccionando más de un búfer a la vez mediante glDrawBuffer.

La prueba de propiedad de píxeles, la prueba de tijera, el anclaje y la máscara de escritura del búfer afectan al funcionamiento de glClear. El cuadro tijera enlaza la región desactivada. La función glClear omite la función alfa, la función blend, la operación lógica, la galería de símbolos, la asignación de texturas y el almacenamiento en búfer z.

La función glClear toma un único argumento (mask) que es el OR bit a bit de varios valores que indican qué búfer se va a borrar.

El valor al que se borra cada búfer depende de la configuración del valor claro de ese búfer.

Si un búfer no está presente, una llamada glClear dirigida a ese búfer no tiene ningún efecto.

Las siguientes funciones recuperan información relacionada con glClear:

glGet con GL_ACCUM_CLEAR_VALUE de argumentos

glGet con GL_DEPTH_CLEAR_VALUE de argumentos

glGet con GL_INDEX_CLEAR_VALUE de argumentos

glGet con GL_COLOR_CLEAR_VALUE de argumentos

glGet con GL_STENCIL_CLEAR_VALUE de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor