Функция glColorMaterial
Функция glColorMaterial позволяет отслеживать текущий цвет материала.
Синтаксис
void WINAPI glColorMaterial(
GLenum face,
GLenum mode
);
Параметры
-
Лицо
-
Указывает, должны ли параметры переднего, заднего или переднего и заднего материалов отслеживать текущий цвет. Допустимые значения: GL_FRONT, GL_BACK и GL_FRONT_AND_BACK. Значение по умолчанию — GL_FRONT_AND_BACK.
-
mode
-
Указывает, какие из нескольких параметров материала отслеживают текущий цвет. Допустимые значения: GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR и GL_AMBIENT_AND_DIFFUSE. Значение по умолчанию — GL_AMBIENT_AND_DIFFUSE.
Возвращаемое значение
Эта функция не возвращает значение.
Коды ошибок
Следующие коды ошибок могут быть получены функцией glGetError .
| Имя | Значение |
|---|---|
|
лицо или режим не является допустимым значением. |
|
Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd. |
Комментарии
Функция glColorMaterial указывает, какие параметры материала отслеживают текущий цвет. При включении GL_COLOR_MATERIAL для каждого материала или материалов, указанных лицом, параметр материала или параметры, заданные режимом , постоянно отслеживают текущий цвет. Включите и отключите GL_COLOR_MATERIAL с помощью функций glEnable и glDisable, которые вызываются с GL_COLOR_MATERIAL в качестве аргумента. По умолчанию GL_COLOR_MATERIAL отключен.
С помощью glColorMaterial можно изменить подмножество параметров материала для каждой вершины, используя только функцию glColor , без вызова glMaterial. Если вы собираетесь указать только такое подмножество параметров для каждой вершины, лучше сделать это с помощью glColorMaterial , чем с glMaterial.
Следующие функции извлекают сведения, связанные с glColorMaterial:
glGet с аргументом GL_COLOR_MATERIAL_PARAMETER
glGet с аргументом GL_COLOR_MATERIAL_FACE
glIsEnabled с аргументом GL_COLOR_MATERIAL
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|