Função glGetMaterialfv

As funções glGetMaterialfv e glGetMaterialiv retornam parâmetros materiais.

Sintaxe

void WINAPI glGetMaterialfv(
   GLenum  face,
   GLenum  pname,
   GLfloat *params
);

Parâmetros

Cara

Especifica qual dos dois materiais está sendo consultado. GL_FRONT ou GL_BACK são aceitos, representando os materiais frontal e traseiro, respectivamente.

Pname

O parâmetro material a ser retornado. Os valores a seguir são aceitos.

Valor	Significado
GL_AMBIENT	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a reflexão ambiente do material. 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 reflexão difusa do material. 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 reflexão especular do material. 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_EMISSION	O parâmetro params retorna quatro valores inteiros ou de ponto flutuante que representam a intensidade de luz emitida do material. 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_SHININESS	O parâmetro params retorna um valor inteiro ou de ponto flutuante que representa o expoente especular do material. Os valores inteiros, quando solicitados, são calculados arredondando o valor de ponto flutuante interno para o valor inteiro mais próximo.
GL_COLOR_INDEXES	O parâmetro params retorna três valores inteiros ou de ponto flutuante que representam os índices ambiente, difuso e especular do material. Use esses índices apenas para iluminação de índice de cores. (Os outros parâmetros são todos usados apenas para iluminação RGBA.) Os valores inteiros, quando solicitados, são calculados arredondando os valores de ponto flutuante interno para os valores inteiros mais próximos.

params

Retorna os dados solicitados.

Retornar valor

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

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Comentários

A função glGetMaterial retorna em params o valor ou os valores do parâmetro pname da face do material.

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

Requisitos

Confira também

glBegin

glEnd

glMaterial