funzione glColorMaterial

La funzione glColorMaterial causa un colore del materiale per tenere traccia del colore corrente.

Sintassi

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

Parametri

Faccia

Specifica se i parametri del materiale anteriore, posteriore o indietro devono tenere traccia del colore corrente. I valori accettati sono GL_FRONT, GL_BACK e GL_FRONT_AND_BACK. Il valore predefinito è GL_FRONT_AND_BACK.

mode

Specifica quale dei diversi parametri del materiale tiene traccia del colore corrente. I valori accettati sono GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR e GL_AMBIENT_AND_DIFFUSE. Il valore predefinito è GL_AMBIENT_AND_DIFFUSE.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_ENUM	viso o modalità non è stato accettato.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glColorMaterial specifica i parametri del materiale che tengono traccia del colore corrente. Quando si abilita GL_COLOR_MATERIAL, per ogni materiale o materiale specificato dal viso, il parametro del materiale o i parametri specificati in modalità tiene traccia del colore corrente in ogni momento. Abilitare e disabilitare GL_COLOR_MATERIAL con le funzioni glEnable e glDisable, chiamate con GL_COLOR_MATERIAL come argomento. Per impostazione predefinita, GL_COLOR_MATERIAL è disabilitato.

Con glColorMaterial è possibile modificare un subset di parametri di materiale per ogni vertice usando solo la funzione glColor , senza chiamare glMaterial. Se si specifica solo un subset di parametri per ogni vertice, è preferibile farlo con glColorMaterial rispetto a glMaterial.

Le funzioni seguenti recuperano informazioni correlate a glColorMaterial:

glGet con argomento GL_COLOR_MATERIAL_PARAMETER

glGet con argomento GL_COLOR_MATERIAL_FACE

glIsEnabled con argomento GL_COLOR_MATERIAL

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial