Função glGetLightiv

As funções glGetLightfv e glGetLightiv retornam valores de parâmetro de fonte de luz.

Sintaxe

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

Parâmetros

light

Uma fonte de luz. O número de luzes possíveis depende da implementação, mas pelo menos oito luzes têm suporte. Eles são identificados por nomes simbólicos do formulário GL_LIGHT i em que 0 = i< GL_MAX_LIGHTS.

Pname

Um parâmetro de fonte de luz para luz. Os nomes simbólicos a seguir são aceitos.

Valor	Significado
GL_AMBIENT	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a intensidade do ambiente da fonte de luz. Os valores inteiros, quando solicitados, são mapeados linearmente da representação de ponto flutuante interno, de modo que 1,0 mapeia para o valor inteiro representável mais positivo e -1,0 mapeia para o valor inteiro representável mais negativo. Se o valor interno estiver fora do intervalo [-1,1], o valor retornado do inteiro correspondente será indefinido.
GL_DIFFUSE	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a intensidade difusa da fonte de luz. Os valores inteiros, quando solicitados, são mapeados linearmente da representação de ponto flutuante interno, de modo que 1,0 mapeia para o valor inteiro representável mais positivo e -1,0 mapeia para o valor inteiro representável mais negativo. Se o valor interno estiver fora do intervalo [-1,1], o valor retornado do inteiro correspondente será indefinido.
GL_SPECULAR	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a intensidade especular da fonte de luz. Os valores inteiros, quando solicitados, são mapeados linearmente da representação de ponto flutuante interno, de modo que 1,0 mapeia para o valor inteiro representável mais positivo e -1,0 mapeia para o valor inteiro representável mais negativo. Se o valor interno estiver fora do intervalo [-1,1], o valor retornado do inteiro correspondente será indefinido.
GL_POSITION	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a posição da fonte de luz. Os valores inteiros, quando solicitados, são calculados arredondando os valores de ponto flutuante interno para o valor inteiro mais próximo. Os valores retornados são aqueles mantidos nas coordenadas oculares. Eles não serão iguais aos valores especificados usando glLight, a menos que a matriz de modelview tenha sido identificada no momento em que glLight foi chamado.
GL_SPOT_DIRECTION	O parâmetro params retorna três valores inteiros ou de ponto flutuante que representam a direção da fonte de luz. Os valores inteiros, quando solicitados, são calculados arredondando os valores de ponto flutuante interno para o valor inteiro mais próximo. Os valores retornados são aqueles mantidos nas coordenadas oculares. Eles não serão iguais aos valores especificados usando glLight, a menos que a matriz de modelview tenha sido identificada no momento em que glLight foi chamado. Embora a direção spot seja normalizada antes de ser usada na equação de iluminação, os valores retornados são as versões transformadas dos valores especificados antes da normalização.
GL_SPOT_EXPONENT	O parâmetro params retorna um único inteiro ou valor de ponto flutuante que representa o expoente spot da luz. Um valor inteiro, quando solicitado, é calculado arredondando a representação de ponto flutuante interno para o inteiro mais próximo.
GL_SPOT_CUTOFF	O parâmetro params retorna um único inteiro ou valor de ponto flutuante que representa o ângulo de corte de ponto da luz. Um valor inteiro, quando solicitado, é calculado arredondando a representação de ponto flutuante interno para o inteiro mais próximo.
GL_CONSTANT_ATTENUATION	O parâmetro params retorna um único inteiro ou valor de ponto flutuante que representa a atenuação constante (não relacionada à distância) da luz. Um valor inteiro, quando solicitado, é calculado arredondando a representação de ponto flutuante interno para o inteiro mais próximo.
GL_LINEAR_ATTENUATION	O parâmetro params retorna um único inteiro ou valor de ponto flutuante que representa a atenuação linear da luz. Um valor inteiro, quando solicitado, é calculado arredondando a representação de ponto flutuante interno para o inteiro mais próximo.
GL_QUADRATIC_ATTENUATION	O parâmetro params retorna um único inteiro ou valor de ponto flutuante que representa a atenuação quadrática da luz. Um valor inteiro, quando solicitado, é calculado arredondando a representação de ponto flutuante interno para o inteiro mais próximo.

params

Retorna os dados solicitados.

Retornar valor

Essa função não retorna um valor.

Comentários

A função glGetLight retorna em params o valor ou os valores de um parâmetro de fonte de luz. O parâmetro light nomeia a luz e é um nome simbólico do formulário GL_LIGHTi para 0 = i< GL_MAX_LIGHTS, em que GL_MAX_LIGHTS é uma constante dependente de implementação maior ou igual a oito. O parâmetro pname especifica um dos dez parâmetros de fonte de luz, novamente por nome simbólico.

É sempre o caso que GL_LIGHTi = GL_LIGHT0 + i.

Se um erro for gerado, nenhuma alteração será feita no conteúdo de parâmetros.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glEnd

glLight