glColorMaterial-Funktion
Die glColorMaterial-Funktion bewirkt, dass eine Materialfarbe die aktuelle Farbe nachverfolgt.
Syntax
void WINAPI glColorMaterial(
GLenum face,
GLenum mode
);
Parameter
-
Gesicht
-
Gibt an, ob front-, back- oder front- und back-Materialparameter die aktuelle Farbe nachverfolgen sollen. Akzeptierte Werte sind GL_FRONT, GL_BACK und GL_FRONT_AND_BACK. Der Standardwert ist GL_FRONT_AND_BACK.
-
mode
-
Gibt an, welcher von mehreren Materialparametern die aktuelle Farbe nachverfolgt. Zulässige Werte sind GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR und GL_AMBIENT_AND_DIFFUSE. Der Standardwert ist GL_AMBIENT_AND_DIFFUSE.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
face oder mode war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glColorMaterial-Funktion gibt an, welche Materialparameter die aktuelle Farbe nachverfolgen. Wenn Sie GL_COLOR_MATERIAL aktivieren, verfolgen der bzw. die imModus angegebenen Materialparameter(n) die aktuelle Farbe jederzeit nach. Aktivieren und deaktivieren Sie GL_COLOR_MATERIAL mit den Funktionen glEnable und glDisable, die Sie mit GL_COLOR_MATERIAL als Argument aufrufen. Standardmäßig ist GL_COLOR_MATERIAL deaktiviert.
Mit glColorMaterial können Sie eine Teilmenge der Materialparameter für jeden Scheitelpunkt nur mithilfe der glColor-Funktion ändern, ohne glMaterial aufzurufen. Wenn Sie nur eine solche Teilmenge von Parametern für jeden Scheitelpunkt angeben möchten, ist es besser, dies mit glColorMaterial als mit glMaterial zu tun.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit glColorMaterial ab:
glGet mit argument GL_COLOR_MATERIAL_PARAMETER
glGet mit Argument GL_COLOR_MATERIAL_FACE
glIsEnabled mit Argument GL_COLOR_MATERIAL
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|