Функция glColorMaterial

Статья
06/13/2023

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

Имя	Значение
GL_INVALID_ENUM	лицо или режим не является допустимым значением.
GL_INVALID_OPERATION	Функция была вызвана между вызовом 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 [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

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

glBegin
glColor
glDisable
GlEnable
glEnd
glGet
glIsEnabled
glLight
glLightModel
glMaterial

Поделиться через