Функция glGetMaterialiv

Статья
06/12/2023

Функции glGetMaterialfv и glGetMaterialiv возвращают параметры материала.

Синтаксис

void WINAPI glGetMaterialiv(
   GLenum face,
   GLenum pname,
   GLint  *params
);

Параметры

Лицо

Указывает, какой из двух материалов запрашивается. принимаются GL_FRONT или GL_BACK, представляющие передние и задние материалы соответственно.

pname

Возвращаемый параметр материала. Принимаются следующие значения.

Значение	Значение
GL_AMBIENT	Параметр params возвращает четыре целочисленных значения или значения с плавающей запятой, представляющие внешнее отражение материала. Целочисленные значения при запросе линейно сопоставляются с внутренним представлением с плавающей запятой таким образом, что 1,0 сопоставляется с наиболее положительным представляется целочисленным значением, а -1,0 — с наиболее отрицательным целым числом. Если внутреннее значение находится за пределами диапазона [-1,1], соответствующее возвращаемое целочисленное значение не определено.
GL_DIFFUSE	Параметр params возвращает четыре целочисленных значения или значения с плавающей запятой, представляющие рассеянное отражение материала. Целочисленные значения при запросе линейно сопоставляются с внутренним представлением с плавающей запятой таким образом, что 1,0 сопоставляется с наиболее положительным представляется целочисленным значением, а -1,0 — с наиболее отрицательным целым числом. Если внутреннее значение находится за пределами диапазона [-1,1], соответствующее возвращаемое целочисленное значение не определено.
GL_SPECULAR	Параметр params возвращает четыре целочисленных значения или значения с плавающей запятой, представляющие зеркальное отражение материала. Целочисленные значения при запросе линейно сопоставляются с внутренним представлением с плавающей запятой таким образом, что 1,0 сопоставляется с наиболее положительным представляется целочисленным значением, а -1,0 — с наиболее отрицательным целым числом. Если внутреннее значение находится за пределами диапазона [-1,1], соответствующее возвращаемое целочисленное значение не определено.
GL_EMISSION	Параметр params возвращает четыре целочисленных значения или значения с плавающей запятой, представляющие интенсивность излучаемого света материала. Целочисленные значения при запросе линейно сопоставляются с внутренним представлением с плавающей запятой таким образом, что 1,0 сопоставляется с наиболее положительным представляется целочисленным значением, а -1,0 — с наиболее отрицательным целым числом. Если внутреннее значение находится за пределами диапазона [-1,1], соответствующее возвращаемое целочисленное значение не определено.
GL_SHININESS	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее показатель отражения материала. Целочисленные значения при запросе вычисляются путем округления внутреннего значения с плавающей запятой до ближайшего целочисленного значения.
GL_COLOR_INDEXES	Параметр params возвращает три целочисленных значения или значения с плавающей запятой, представляющие внешний, рассеянный и зеркальный индексы материала. Используйте эти индексы только для освещения цветовых индексов. (Все остальные параметры используются только для освещения RGBA.) При запросе целочисленные значения вычисляются путем округления внутренних значений с плавающей запятой до ближайших целочисленных значений.

params

Возвращает запрошенные данные.

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

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

Коды ошибок

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

Имя	Значение
GL_INVALID_ENUM	Целевой объект или запрос не были принятыми значениями.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Требования

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

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

glBegin
glEnd
glMaterial

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