Функция glGetMaterialfv

Статья
06/13/2023

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

Синтаксис

void WINAPI glGetMaterialfv(
   GLenum  face,
   GLenum  pname,
   GLfloat *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	Значение target или query не было принято.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Требования

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

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

glBegin
glEnd
glMaterial

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