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 die materiale Parameter front, back oder front und back 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. Akzeptierte Werte sind GL _ AMBIENT, GL _ AMBIENT, GL _ DIFFUSE, GL _ SPECULAR und GL _ AMBIENT UND _ _ DIFFUSE. Der Standardwert ist GL _ AMBIENT _ UND _ 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, wird die aktuelle Farbe für jedes material oder material, das bzw. das durch das Gesicht angegeben wird, durch den vom Modus angegebenen Materialparameter oder Parameter _ _ jederzeit nachverfolgt. 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 ändern, indem Sie nur die glColor-Funktion verwenden, ohne glMaterial auf aufruft. Wenn Sie nur eine solche Teilmenge von Parametern für jeden Scheitelpunkt angeben möchten, ist es besser, glColorMaterial als glMaterial zu verwenden.
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
Requirements (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 |
|