Прочитать на английском

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


Функция glMaterialf

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

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