glMateriali-Funktion

Die glMateriali-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 einer der folgenden Sein: GL _ FRONT, GL _ BACK oder GL FRONT und GL _ _ BACK.

pname

Der einwertige Materialparameter des Gesichts oder der Gesichter, die aktualisiert werden. Muss _ GLINESS sein.

Wert Bedeutung
_GL-VERTRAUENSWÜRDIGKEIT
Der Parameter param ist eine einzelne ganze Zahl, die den RGBA-Glanz exponenten des Materials angibt. Ganzzahlige Werte werden direkt zugeordnet. Nur Werte im Bereich [ 0, 128 ] werden akzeptiert. Der Standardspekular exponent für vordere und hintere Materialien ist 0.

param

Der Wert, auf den der Parameter GL _ CABINESS 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 _ UNGÜLTIGER _ WERT
Ein Glanz exponent außerhalb des Bereichs von [ 0, 128 ] wurde angegeben.

Hinweise

Die glMateriali-Funktion weist Materialparametern Werte zu. Es gibt zwei übereinstimmende Sätze von Materialparametern. Eine , die vordere Gruppe, wird verwendet, um Punkte, Linien, Bitmaps und alle Polygone (wenn die zweiseitige Beleuchtung deaktiviert ist) oder einfach frontseitige Polygone (wenn die zweiseitige Beleuchtung aktiviert ist) zu beschatten. Der andere Satz, rückwärts gerichtet, wird nur verwendet, um rückwärts gerichtete Polygone zu schattierung, wenn die zweiseitige Beleuchtung aktiviert ist. Ausführliche Informationen zu ein- und zweiseitigen Beleuchtungsberechnungen finden Sie unter glLightModel.

Die glMateriali-Funktion verwendet 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. Die 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 Gleichung wird in glLightModelerläutert.

Die Materialparameter können jederzeit aktualisiert werden. Insbesondere kann glMateriali zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen 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:

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