Функция glGetLightfv

Статья
06/13/2023

Функции glGetLightfv и glGetLightiv возвращают значения параметров источника света.

Синтаксис

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

Параметры

light

Источник света. Количество возможных источников света зависит от реализации, но поддерживается не менее восьми индикаторов. Они идентифицируются символьными именами формы GL_LIGHT i , где 0 = i< GL_MAX_LIGHTS.

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_POSITION	Параметр params возвращает четыре целочисленных значения или значения с плавающей запятой, представляющие положение источника света. При запросе целочисленные значения вычисляются путем округления внутренних значений с плавающей запятой до ближайшего целочисленного значения. Возвращаемые значения хранятся в координатах глаз. Они не будут равны значениям, указанным с помощью glLight, если матрица modelview не была определена во время вызова glLight .
GL_SPOT_DIRECTION	Параметр params возвращает три целочисленных значения или значения с плавающей запятой, представляющие направление источника света. При запросе целочисленные значения вычисляются путем округления внутренних значений с плавающей запятой до ближайшего целочисленного значения. Возвращаемые значения хранятся в координатах глаз. Они не будут равны значениям, указанным с помощью glLight, если матрица modelview не была определена во время вызова glLight . Хотя направление точечных значений нормализуется перед использованием в уравнении освещения, возвращаемые значения являются преобразованными версиями указанных значений до нормализации.
GL_SPOT_EXPONENT	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее точечный показатель света. Целочисленное значение при запросе вычисляется путем округления внутреннего представления с плавающей запятой до ближайшего целого числа.
GL_SPOT_CUTOFF	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее угол среза пятна света. Целочисленное значение при запросе вычисляется путем округления внутреннего представления с плавающей запятой до ближайшего целого числа.
GL_CONSTANT_ATTENUATION	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее постоянное (не связанное с расстоянием) затухание света. Целочисленное значение при запросе вычисляется путем округления внутреннего представления с плавающей запятой до ближайшего целого числа.
GL_LINEAR_ATTENUATION	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее линейное затухание света. Целочисленное значение при запросе вычисляется путем округления внутреннего представления с плавающей запятой до ближайшего целого числа.
GL_QUADRATIC_ATTENUATION	Параметр params возвращает одно целое число или значение с плавающей запятой, представляющее квадратическое затухание света. Целочисленное значение при запросе вычисляется путем округления внутреннего представления с плавающей запятой до ближайшего целого числа.

params

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

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

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

Функция glGetLight возвращает в параметрах значение или значения параметра источника света. Параметр light присваивает свету имя и является символическим именем формы GL_LIGHTi для 0 = i< GL_MAX_LIGHTS, где GL_MAX_LIGHTS — это зависящая от реализации константа, которая больше или равна 8. Параметр pname указывает один из десяти параметров источника света, опять же по символьным именам.

Всегда GL_LIGHTi = GL_LIGHT0 + i.

Если возникает ошибка, содержимое параметров не изменяется.

Требования

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

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

glBegin
glEnd
glLight

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