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
GL_INVALID_ENUM	face oder mode war kein akzeptierter Wert.
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial