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 oder die Gesichter, die aktualisiert werden. Dies muss einer der folgenden Sein: GL _ FRONT, GL _ BACK oder GL FRONT und GL _ _ BACK.
-
pname
-
Der einwertige Materialparameter des oder der Gesichter, die aktualisiert werden. Muss _ GLINESS sein.
Wert Bedeutung - _GL-GL-SCHLÄFRIGKEIT
Der Parameter param ist ein einzelner Gleitkommawert, der den RGBA-Exponenten des Materials angibt. Ganzzahlige Werte werden direkt zugeordnet. Nur Werte im Bereich [ 0, 128 ] werden akzeptiert. Der Standardspezifikations exponent für front- und back-facing materials ist 0. -
param
-
Der Wert, auf den der Parameter _ GLINESS 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 |
|---|---|
|
Entweder face oder pname war kein akzeptierter Wert. |
|
Ein specular-Exponent außerhalb des Bereichs von [ 0, 128 ] wurde angegeben. |
Hinweise
Die glMaterialf-Funktion weist Materialparametern Werte zu. Es gibt zwei übereinstimmende Sätze von Materialparametern. Eine, die frontseitige Gruppe, wird verwendet, um Punkte, Linien, Bitmaps und alle Polygone (wenn die zweiseitige Beleuchtung deaktiviert ist) oder einfach frontseitige Polygone zu schattigen (wenn die zweiseitige Beleuchtung aktiviert ist). Die andere Gruppe, die nach hinten gerichtet ist, wird nur verwendet, um nach hinten gerichtete Polygone zu beschatten, wenn die zweiseitige Beleuchtung aktiviert ist. Details zu einseitigen und zweiseitigen Beleuchtungsberechnungen finden Sie unter glLightModel.
Die glMaterialf-Funktion verwendet drei Argumente. Die erste, die Gesichtserkennung, gibt an, ob die GL FRONT-Materialien, die GL BACK-Materialien oder beide _ GL FRONT AND _ _ _ _ BACK-Materialien geändert werden. Der zweite Parameter , pname, gibt an, welcher von mehreren Parametern in einer oder beiden Sätzen geändert wird. Der dritte Parameter ( param) gibt an, welcher Wert dem angegebenen Parameter zugewiesen wird.
Materialparameter werden in der Beleuchtungsgleichung verwendet, die optional auf jeden Scheitelpunkt angewendet wird. Die Gleichung 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 Scheitelpunkt geändert werden soll, wird glColorMaterial gegenüber glMaterialf bevorzugt.
Die folgende Funktion ruft Informationen im Zusammenhang mit glMaterialf ab:
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 |
|