Функция glMateriali

Статья
06/13/2023

ФункцияglMateriali задает параметры материала для модели освещения.

Синтаксис

void WINAPI glMateriali(
   GLenum face,
   GLenum pname,
   GLint  param
);

Параметры

Лицо

Лицо или лица, которые обновляются. Должен иметь одно из следующих значений: GL_FRONT, GL_BACK или GL_FRONT и GL_BACK.

pname

Однозначный параметр материала обновляемого лица или лиц. Должен быть GL_SHININESS.

Значение	Значение
GL_SHININESS	Параметр param — это одно целое число, указывающее спектрическую экспоненту RGBA материала. Целочисленные значения сопоставляются напрямую. Принимаются только значения в диапазоне [0, 128]. Показатель по умолчанию для материалов передней и задней сторон составляет 0.

Значение

GL_SHININESS

Параметр param — это одно целое число, указывающее спектрическую экспоненту RGBA материала. Целочисленные значения сопоставляются напрямую. Принимаются только значения в диапазоне [0, 128]. Показатель по умолчанию для материалов передней и задней сторон составляет 0.

param

Значение, для которого будет задан GL_SHININESS параметра.

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

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

Коды ошибок

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

Имя	Значение
GL_INVALID_ENUM	Лицо илиpname не было принятым значением.
GL_INVALID_VALUE	Указана зеркальная экспонента за пределами диапазона [0, 128].

Функция glMateriali присваивает значения параметрам материала. Существует два сопоставленных набора параметров материала. Один из них, передний набор, используется для затенений точек, линий, растровых изображений и всех многоугольников (если двустороннее освещение отключено) или только фронтовых многоугольников (если включено двустороннее освещение). Другой набор, обращенный назад, используется для затенений многоугольников, обращенных к задней стороне, только если включено двустороннее освещение. Дополнительные сведения об односторонних и двусторонних вычислениях освещения см. в статье glLightModel .

Функция glMateriali принимает три аргумента. Первый, face, указывает, будут ли изменены GL_FRONT материалы, GL_BACK материалы или оба GL_FRONT_AND_BACK материала. Второй , pname, указывает, какие из нескольких параметров в одном или обоих наборах будут изменены. Третий параметр указывает, какое значение будет присвоено указанному параметру.

Параметры материала используются в уравнении освещения, которое при необходимости применяется к каждой вершине. Уравнение рассматривается в glLightModel.

Параметры материала можно обновить в любое время. В частности, можно вызвать glMateriali между вызовом glBegin и соответствующим вызовом glEnd. Однако если требуется изменить только один параметр материала для каждой вершины, предпочтительнее glColorMaterial по сравнению с glMateriali.

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

glGetMaterial

Требования

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

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

glColorMaterial
glLight
glLightModel

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