Функция glColorMask
Функция glColorMask включает и отключает запись компонентов цвета буфера кадров.
Синтаксис
void WINAPI glColorMask(
GLboolean red,
GLboolean green,
GLboolean blue,
GLboolean alpha
);
Параметры
-
red
-
Укажите, может ли красный цвет записываться в framebuffer. Значения по умолчанию — GL_TRUE, что указывает на возможность записи компонента цвета.
-
green
-
Укажите, может ли зеленый цвет записываться в framebuffer. Значение по умолчанию — GL_TRUE, указывающее, что компонент цвета можно записать.
-
blue
-
Укажите, может ли синий цвет записываться в framebuffer. Значение по умолчанию — GL_TRUE, указывающее, что компонент цвета можно записать.
-
канал альфа-версии;
-
Укажите, может ли альфа-канал записываться в framebuffer. Значение по умолчанию — GL_TRUE, указывающее, что компонент цвета можно записать.
Возвращаемое значение
Эта функция не возвращает значение.
Коды ошибок
Следующий код ошибки может быть получен функцией glGetError .
| Имя | Значение |
|---|---|
|
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd. |
Комментарии
Функция glColorMask указывает, можно ли записать отдельные компоненты цвета в framebuffer. Если красный цвет GL_FALSE, например, красный компонент любого пикселя в любом из буферов цвета не изменяется, независимо от попытки отрисовки.
Невозможно управлять изменениями отдельных битов компонентов. Вместо этого изменения включаются или отключаются для всех компонентов цвета.
Следующие функции извлекают сведения, связанные с glColorMask:
glGet с аргументом GL_COLOR_WRITEMASK
glGet с аргументом GL_RGBA_MODE
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|