G
glGetLight
Chapter 7
196
glGetLight
glGetLightfv, glGetLightiv: return light source parameter values.
C Specification
void glGetLightfv(
GLenum light,
GLenum pname,
GLfloat *params)
void glGetLightiv(
GLenum light,
GLenum pname,
GLint *params)
Parameters
light Specifies a light source. The number of possible lights depends on the
implementation, but at least eight lights are supported. They are
identified by symbolic names of the form GL_LIGHTi where 0 ≥ i <
GL_MAX_LIGHTS.
pname Specifies a light source parameter for light. Accepted symbolic names
are GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR, GL_POSITION,
GL_SPOT_DIRECTION, GL_SPOT_EXPONENT,
GL_SPOT_CUTOFF, GL_CONSTANT_ATTENUATION,
GL_LINEAR_ATTENUATION, and
GL_QUADRATIC_ATTENUATION.
params Returns the requested data.
Description
glGetLight returns in params the value or values of a light source parameter. light
names the light and is a symbolic name of the form GL_LIGHTi for 0 ≥ i <
GL_MAX_LIGHTS, where GL_MAX_LIGHTS is an implementation-dependent constant
that is greater than or equal to eight. pname specifies one of ten light source parameters,
again by symbolic name.
The following parameters are defined:
GL_AMBIENT
params returns four integer or floating-point values representing the ambient intensity
of the light source. Integer values, when requested, are linearly mapped from the
internal floating-point representation such that 1.0 maps to the most positive
representable integer value, and - 1.0 maps to the most negative representable integer
value. If the internal value is outside the range [- 1, 1], the corresponding integer return
value is undefined. The initial value is (0, 0, 0, 1).
GL_DIFFUSE