glMaterialf-Funktion

Die glMaterialf-Funktion gibt Materialparameter für das Beleuchtungsmodell an.

Syntax

void WINAPI glMaterialf(
   GLenum  face,
   GLenum  pname,
   GLfloat param
);

Parameter

Gesicht

Das Gesicht oder die Gesichter, die aktualisiert werden. Muss eine der folgenden Sein: GL_FRONT, GL_BACK oder GL_FRONT und GL_BACK.

pname

Der einwertige Materialparameter der zu aktualisierenden Gesichter. Muss GL_SHININESS werden.

Wert	Bedeutung
GL_SHININESS	Der param-Parameter ist ein einzelner Gleitkommawert, der den RGBA-Spiegelexponenten des Materials angibt. Ganzzahlige Werte werden direkt zugeordnet. Es werden nur Werte im Bereich [0, 128] akzeptiert. Der standardmäßige spiegelfähige Exponent für materialien, die nach vorne und nach hinten gerichtet sind, ist 0.

param

Der Wert, auf den parameter GL_SHININESS festgelegt wird.

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	Entweder face oder pname war kein akzeptierter Wert.
GL_INVALID_VALUE	Es wurde ein spiegelförmiger Exponent außerhalb des Bereichs von [0, 128] angegeben.

Bemerkungen

Die glMaterialf-Funktion weist Materialparametern Werte zu. Es gibt zwei übereinstimmend Sätze von Materialparametern. Eine, die nach vorne ausgerichtete Gruppe, wird verwendet, um Punkte, Linien, Bitmaps und alle Polygone (wenn die zweiseitige Beleuchtung deaktiviert ist) oder nur nach vorne ausgerichtete Polygone (wenn die zweiseitige Beleuchtung aktiviert ist) zu schattieren. Die andere Gruppe, nach hinten ausgerichtet, wird nur verwendet, um nach hinten gerichtete Polygone zu schattieren, wenn die zweiseitige Beleuchtung aktiviert ist. Ausführliche Informationen zu einseitigen und zweiseitigen Beleuchtungsberechnungen finden Sie unter glLightModel .

Die glMaterialf-Funktion akzeptiert drei Argumente. Das erste Gesicht gibt an, ob die GL_FRONT Materialien, die GL_BACK Materialien oder beide GL_FRONT_AND_BACK Materialien geändert werden. Der zweite, pname, gibt an, welcher von mehreren Parametern in einem oder beiden Sätzen geändert wird. Die dritte, param, gibt an, welcher Wert dem angegebenen Parameter zugewiesen wird.

Materialparameter werden in der Beleuchtungsgleichung verwendet, die optional auf jeden Scheitelpunkt angewendet wird. Die Formel wird in glLightModel erläutert.

Die Materialparameter können jederzeit aktualisiert werden. Insbesondere kann glMaterialf zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen werden. Wenn jedoch nur ein einzelner Materialparameter pro Vertex geändert werden soll, wird glColorMaterial gegenüber glMaterialf bevorzugt.

Die folgende Funktion ruft Informationen im Zusammenhang mit glMaterialf ab:

glGetMaterial

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

Siehe auch

glColorMaterial

glLight

glLightModel