Функция glGetLightfv
Функции 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 [только классические приложения] |
Заголовок |
|
Библиотека |
|
DLL |
|