Функция glClear

Статья
06/12/2023

Функция 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