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
GL _ INVALID _ ENUM
face oder mode war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial