Função glMateriali

A funçãoglMateriali especifica parâmetros de material para o modelo de iluminação.

Sintaxe

void WINAPI glMateriali(
   GLenum face,
   GLenum pname,
   GLint  param
);

Parâmetros

Cara

O rosto ou rostos que estão sendo atualizados. Deve ser um dos seguintes: GL_FRONT, GL_BACK ou GL_FRONT e GL_BACK.

Pname

O parâmetro de material de valor único do rosto ou rostos que estão sendo atualizados. Deve ser GL_SHININESS.

Valor	Significado
GL_SHININESS	O parâmetro param é um único inteiro que especifica o expoente especular RGBA do material. Os valores inteiros são mapeados diretamente. Somente os valores no intervalo [0, 128] são aceitos. O expoente especular padrão para materiais voltados para frente e para trás é 0.

param

O valor para o qual o parâmetro GL_SHININESS será definido.

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 .

Nome	Significado
GL_INVALID_ENUM	Face oupname não era um valor aceito.
GL_INVALID_VALUE	Um expoente especular fora do intervalo de [0, 128] foi especificado.

Comentários

A função glMateriali atribui valores a parâmetros materiais. Há dois conjuntos correspondentes de parâmetros materiais. Um deles, o conjunto frontal , é usado para sombrear pontos, linhas, bitmaps e todos os polígonos (quando a iluminação de dois lados é desabilitada) ou apenas polígonos voltados para a frente (quando a iluminação de dois lados está habilitada). O outro conjunto, voltado para trás, é usado para sombrear polígonos voltados para trás somente quando a iluminação de dois lados está habilitada. Consulte glLightModel para obter detalhes sobre cálculos de iluminação de um lado e de dois lados.

A função glMateriali usa três argumentos. O primeiro, face, especifica se os materiais GL_FRONT, os materiais GL_BACK ou ambos os materiais GL_FRONT_AND_BACK serão modificados. O segundo, pname, especifica qual dos vários parâmetros em um ou ambos os conjuntos será modificado. O terceiro, param, especifica qual valor será atribuído ao parâmetro especificado.

Os parâmetros de material são usados na equação de iluminação que, opcionalmente, é aplicada a cada vértice. A equação é discutida em glLightModel.

Os parâmetros de material podem ser atualizados a qualquer momento. Em particular, glMateriali pode ser chamado entre uma chamada para glBegin e a chamada correspondente para glEnd. Se apenas um único parâmetro de material for alterado por vértice, no entanto, glColorMaterial será preferencial em vez de glMateriali.

A função a seguir recupera informações relacionadas ao glMateriali:

glGetMaterial

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

glColorMaterial

glLight

glLightModel