Функция glMaterialf

Статья
06/13/2023

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

Синтаксис

void WINAPI glMaterialf(
   GLenum  face,
   GLenum  pname,
   GLfloat 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	Face илиpname не является допустимым значением.
GL_INVALID_VALUE	Указана показатель экспоненты за пределами диапазона [0, 128].

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

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

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

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

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

glGetMaterial

Требования

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

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

glColorMaterial
glLight
glLightModel

Share via