glGetMaterialiv-Funktion

Die Funktionen glGetMaterialfv und glGetMaterialiv geben Materialparameter zurück.

Syntax

void WINAPI glGetMaterialiv(
   GLenum face,
   GLenum pname,
   GLint  *params
);

Parameter

Gesicht

Gibt an, welches der beiden Materialien abgefragt wird. GL_FRONT oder GL_BACK werden akzeptiert, die die Vorder- und Rückseite darstellen.

pname

Der zurückzugebende Materialparameter. Die folgenden Werte werden akzeptiert.

Wert	Bedeutung
GL_AMBIENT	Der parameter params gibt vier ganzzahlige oder gleitkommawerte zurück, die die Umgebungsreflektion des Materials darstellen. Ganzzahlwerte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 dem positivsten darstellbaren ganzzahligen Wert und -1,0 dem negativsten darstellbaren ganzzahligen Wert zugeordnet wird. Wenn der interne Wert außerhalb des Bereichs [-1,1] liegt, ist der entsprechende ganzzahlige Rückgabewert undefiniert.
GL_DIFFUSE	Der Parameter params gibt vier ganzzahlige Oder Gleitkommawerte zurück, die die diffuse Reflektion des Materials darstellen. Ganzzahlwerte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 dem positivsten darstellbaren ganzzahligen Wert und -1,0 dem negativsten darstellbaren ganzzahligen Wert zugeordnet wird. Wenn der interne Wert außerhalb des Bereichs [-1,1] liegt, ist der entsprechende ganzzahlige Rückgabewert undefiniert.
GL_SPECULAR	Der parameter params gibt vier ganzzahlige oder Gleitkommawerte zurück, die die Spiegelung des Materials darstellen. Ganzzahlwerte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 dem positivsten darstellbaren ganzzahligen Wert und -1,0 dem negativsten darstellbaren ganzzahligen Wert zugeordnet wird. Wenn der interne Wert außerhalb des Bereichs [-1,1] liegt, ist der entsprechende ganzzahlige Rückgabewert undefiniert.
GL_EMISSION	Der parameter params gibt vier ganzzahlige oder gleitkommawerte zurück, die die emittierte Lichtintensität des Materials darstellen. Ganzzahlwerte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 dem positivsten darstellbaren ganzzahligen Wert und -1,0 dem negativsten darstellbaren ganzzahligen Wert zugeordnet wird. Wenn der interne Wert außerhalb des Bereichs [-1,1] liegt, ist der entsprechende ganzzahlige Rückgabewert undefiniert.
GL_SHININESS	Der parameter params gibt eine ganze Zahl oder einen Gleitkommawert zurück, der den spiegelförmigen Exponenten des Materials darstellt. Ganzzahlwerte werden bei Anforderung berechnet, indem der interne Gleitkommawert auf den nächsten ganzzahligen Wert gerundet wird.
GL_COLOR_INDEXES	Der parameter params gibt drei ganzzahlige oder Gleitkommawerte zurück, die die Ambient-, Diffuse- und Specularindizes des Materials darstellen. Verwenden Sie diese Indizes nur für die Farbindexbeleuchtung. (Die anderen Parameter werden alle nur für RGBA-Beleuchtung verwendet.) Ganzzahlige Werte werden bei Bedarf berechnet, indem die internen Gleitkommawerte auf die nächsten ganzzahligen Werte gerundet werden.

params

Gibt die angeforderten Daten zurück.

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	target oder query war kein akzeptierter Wert.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glGetMaterial-Funktion gibt in Params den Wert oder die Werte des pname-Parameters der Materialsicht zurück.

Wenn ein Fehler generiert wird, wird keine Änderung am Inhalt von Params vorgenommen.

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

glBegin

glEnd

glMaterial