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 |
|---|---|
|
face ou mode não era um valor aceito. |
|
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 |
|
| Biblioteca |
|
| DLL |
|