glMateriali-Funktion
DieglMateriali-Funktion gibt Materialparameter für das Beleuchtungsmodell an.
Syntax
void WINAPI glMateriali(
GLenum face,
GLenum pname,
GLint 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 sein.
Wert Bedeutung - GL_SHININESS
Der Parameter param ist eine einzelne ganze Zahl, die den RGBA-Spiegelexponenten des Materials angibt. Ganzzahlige Werte werden direkt zugeordnet. Es werden nur Werte im Bereich [0, 128] akzeptiert. Der Standard-Spiegelexponent für nach vorne und hinten gerichtete Materialien 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 |
|---|---|
|
Entweder face oder pname war kein akzeptierter Wert. |
|
Es wurde ein spiegelförmiger Exponent außerhalb des Bereichs von [0, 128] angegeben. |
Bemerkungen
Die glMateriali-Funktion weist Materialparametern Werte zu. Es gibt zwei übereinstimmend Sätze von Materialparametern. Eine , die nach vorne gerichtete Gruppe, dient zum Schattieren von Punkten, Linien, Bitmaps und allen Polygonen (wenn die zweiseitige Beleuchtung deaktiviert ist) oder nur polygonseitig nach vorne gerichteten Polygonen (wenn die beidseitige Beleuchtung aktiviert ist). Die andere Gruppe, die nach hinten gerichtet ist, wird nur verwendet, um nach hinten gerichtete Polygone zu schattieren, wenn die zweiseitige Beleuchtung aktiviert ist. Ausführliche Informationen zu einseitigen und beidseitigen Beleuchtungsberechnungen finden Sie unter glLightModel .
Die glMateriali-Funktion akzeptiert drei Argumente. Die erste , Face, 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. Der dritte Parameter 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 glMateriali 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 glMateriali bevorzugt.
Die folgende Funktion ruft Informationen im Zusammenhang mit glMateriali 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 |
|