Функция glClear

Функция glClear очищает буферы до предустановленных значений.

Синтаксис

void WINAPI glClear(
   GLbitfield mask
);

Параметры

mask

Побитовые операторы ИЛИ масок, указывающие буферы для очистки. Четыре маски следующие.

Значение Значение
GL_COLOR_BUFFER_BIT
Буферы в настоящее время включены для записи цветов.
GL_DEPTH_BUFFER_BIT
Буфер глубины.
GL_ACCUM_BUFFER_BIT
Буфер накопления.
GL_STENCIL_BUFFER_BIT
Буфер набора элементов.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

Следующие коды ошибок могут быть получены функцией glGetError .

Имя Значение
GL_INVALID_VALUE
Любой бит, отличный от четырех определенных битов, был установлен в маске.
GL_INVALID_OPERATION
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Комментарии

Функция glClear задает для области битовой плоскости окна значения, ранее выбранные glClearColor, glClearIndex, glClearDepth, glClearStencil и glClearAccum. Вы можете очистить несколько цветовых буферов одновременно, выбрав несколько буферов одновременно с помощью glDrawBuffer.

Проверка владения пикселями, проверка ножницы, дизернирование и буферные маски записи влияют на работу glClear. Ножницы ограничили очищенную область. Функция glClear игнорирует альфа-функцию, функцию blend, логическую операцию, набор элементов, сопоставление текстур и z-буферизацию.

Функция glClear принимает один аргумент (маску), который является побитовой ИЛИ нескольких значений, указывающих, какой буфер необходимо очистить.

Значение, до которого очищается каждый буфер, зависит от значения, заданного для этого буфера.

Если буфер отсутствует, вызов glClear , направленный на этот буфер, не оказывает никакого влияния.

Следующие функции извлекают сведения, связанные с glClear:

glGet с аргументом GL_ACCUM_CLEAR_VALUE

glGet с аргументом GL_DEPTH_CLEAR_VALUE

glGet с аргументом GL_INDEX_CLEAR_VALUE

glGet с аргументом GL_COLOR_CLEAR_VALUE

glGet с аргументом GL_STENCIL_CLEAR_VALUE

Требования

Требование Значение
Минимальная версия клиента
Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
Windows 2000 Server [только классические приложения]
Заголовок
Gl.h
Библиотека
Opengl32.lib
DLL
Opengl32.dll

См. также раздел

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor