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 |
|---|---|
|
viso o modalità non è stato accettato. |
|
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 |
|
| Libreria |
|
| DLL |
|