Función glGetLightiv

Las funciones glGetLightfv y glGetLightiv devuelven valores de parámetros de origen de luz.

Sintaxis

void WINAPI glGetLightiv(
   GLenum light,
   GLenum pname,
   GLint  *params
);

Parámetros

light

Una fuente de luz. El número de luces posibles depende de la implementación, pero se admiten al menos ocho luces. Se identifican por nombres simbólicos de la forma GL_LIGHT i donde 0 = i< GL_MAX_LIGHTS.

pname

Parámetro de fuente de luz para la luz. Se aceptan los siguientes nombres simbólicos.

Value	Significado
GL_AMBIENT	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la intensidad ambiente de la fuente de luz. Los valores enteros, cuando se solicitan, se asignan linealmente desde la representación de punto flotante interno, de modo que 1,0 se asigna al valor entero representable más positivo y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_DIFFUSE	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la intensidad difusa de la fuente de luz. Los valores enteros, cuando se solicitan, se asignan linealmente desde la representación de punto flotante interno, de modo que 1,0 se asigna al valor entero representable más positivo y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_SPECULAR	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la intensidad especular de la fuente de luz. Los valores enteros, cuando se solicitan, se asignan linealmente desde la representación de punto flotante interno, de modo que 1,0 se asigna al valor entero representable más positivo y -1,0 se asigna al valor entero representable más negativo. Si el valor interno está fuera del intervalo [-1,1], el valor devuelto entero correspondiente no está definido.
GL_POSITION	El parámetro params devuelve cuatro valores enteros o de punto flotante que representan la posición de la fuente de luz. Los valores enteros, cuando se solicitan, se calculan redondeando los valores de punto flotante interno al valor entero más cercano. Los valores devueltos son los que se mantienen en coordenadas oculares. No serán iguales a los valores especificados mediante glLight, a menos que se identifique la matriz modelview en el momento en que se llamó a glLight .
GL_SPOT_DIRECTION	El parámetro params devuelve tres valores enteros o de punto flotante que representan la dirección de la fuente de luz. Los valores enteros, cuando se solicitan, se calculan redondeando los valores de punto flotante interno al valor entero más cercano. Los valores devueltos son los que se mantienen en coordenadas oculares. No serán iguales a los valores especificados mediante glLight, a menos que se identifique la matriz modelview en el momento en que se llamó a glLight . Aunque la dirección de spot se normaliza antes de usarse en la ecuación de iluminación, los valores devueltos son las versiones transformadas de los valores especificados antes de la normalización.
GL_SPOT_EXPONENT	El parámetro params devuelve un único valor entero o de punto flotante que representa el exponente de spot de la luz. Un valor entero, cuando se solicita, se calcula redondeando la representación de punto flotante interno al entero más cercano.
GL_SPOT_CUTOFF	El parámetro params devuelve un único valor entero o de punto flotante que representa el ángulo de corte puntual de la luz. Un valor entero, cuando se solicita, se calcula redondeando la representación de punto flotante interno al entero más cercano.
GL_CONSTANT_ATTENUATION	El parámetro params devuelve un único valor entero o de punto flotante que representa la atenuación constante (no relacionada con la distancia) de la luz. Un valor entero, cuando se solicita, se calcula redondeando la representación de punto flotante interno al entero más cercano.
GL_LINEAR_ATTENUATION	El parámetro params devuelve un único valor entero o de punto flotante que representa la atenuación lineal de la luz. Un valor entero, cuando se solicita, se calcula redondeando la representación de punto flotante interno al entero más cercano.
GL_QUADRATIC_ATTENUATION	El parámetro params devuelve un único valor entero o de punto flotante que representa la atenuación cuadrática de la luz. Un valor entero, cuando se solicita, se calcula redondeando la representación de punto flotante interno al entero más cercano.

params

Devuelve los datos solicitados.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

La función glGetLight devuelve en parámetros el valor o los valores de un parámetro de origen de luz. El parámetro light nombra la luz y es un nombre simbólico del formulario GL_LIGHTi para 0 = i< GL_MAX_LIGHTS, donde GL_MAX_LIGHTS es una constante dependiente de la implementación que es mayor o igual que ocho. El parámetro pname especifica uno de los diez parámetros de origen de luz, de nuevo por nombre simbólico.

Siempre es el caso de que GL_LIGHTi = GL_LIGHT0 + i.

Si se genera un error, no se realiza ningún cambio en el contenido de los parámetros.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glEnd

glLight