Функция 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 .
Имя | Значение |
---|---|
|
Face илиpname не является допустимым значением. |
|
Указана показатель экспоненты за пределами диапазона [0, 128]. |
Функция glMaterialf присваивает значения параметрам материала. Существует два сопоставленных набора параметров материала. Один из них, набор лицевой стороны, используется для затеняния точек, линий, растровых изображений и всех многоугольников (если двустороннее освещение отключено) или только фронтовых многоугольников (если включено двустороннее освещение). Другой набор, с задней стороны, используется для затенений многоугольников, обращенных к задней стороне, только если включено двустороннее освещение. Дополнительные сведения о вычислениях односторонного и двустороннего освещения см. в разделе glLightModel .
Функция glMaterialf принимает три аргумента. Первый, face, указывает, будут ли изменены GL_FRONT материалы, GL_BACK материалы или оба GL_FRONT_AND_BACK материала. Второй, pname, указывает, какой из нескольких параметров в одном или обоих наборах будет изменен. Третий параметр указывает, какое значение будет присвоено указанному параметру.
Параметры материала используются в уравнении освещения, которое при необходимости применяется к каждой вершине. Уравнение рассматривается в glLightModel.
Параметры материала можно обновить в любое время. В частности, glMaterialf можно вызывать между вызовом glBegin и соответствующим вызовом glEnd. Если для каждой вершины нужно изменить только один параметр материала, то вместо glMaterialf предпочтительнее glColorMaterial.
Следующая функция извлекает сведения, связанные с glMaterialf:
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|