Função glColorMaterial

A função glColorMaterial faz com que uma cor material rastreie a cor atual.

Sintaxe

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

Parâmetros

Cara

Especifica se os parâmetros de material frontal, traseiro ou frontal e traseiro devem acompanhar a cor atual. Os valores aceitos são GL_FRONT, GL_BACK e GL_FRONT_AND_BACK. O valor padrão é GL_FRONT_AND_BACK.

mode

Especifica qual dos vários parâmetros de material acompanha a cor atual. Os valores aceitos são GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR e GL_AMBIENT_AND_DIFFUSE. O valor padrão é GL_AMBIENT_AND_DIFFUSE.

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 ou mode não era um valor aceito.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glColorMaterial especifica quais parâmetros de material acompanham a cor atual. Quando você habilita GL_COLOR_MATERIAL, para cada um dos materiais ou materiais especificados por face, o parâmetro material ou os parâmetros especificados pelo modo acompanham a cor atual o tempo todo. Habilite e desabilite GL_COLOR_MATERIAL com as funções glEnable e glDisable, que você chama com GL_COLOR_MATERIAL como argumento. Por padrão, GL_COLOR_MATERIAL está desabilitada.

Com glColorMaterial, você pode alterar um subconjunto de parâmetros materiais para cada vértice usando apenas a função glColor , sem chamar glMaterial. Se você vai especificar apenas esse subconjunto de parâmetros para cada vértice, é melhor fazer isso com glColorMaterial do que com glMaterial.

As seguintes funções recuperam informações relacionadas a glColorMaterial:

glGet com GL_COLOR_MATERIAL_PARAMETER de argumento

glGet com GL_COLOR_MATERIAL_FACE de argumento

glIsEnabled com GL_COLOR_MATERIAL de argumento

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

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial