glGetLightiv-Funktion

Die Funktionen glGetLightfv und glGetLightiv geben Parameterwerte der Lichtquelle zurück.

Syntax

void WINAPI glGetLightiv(
   GLenum light,
   GLenum pname,
   GLint  *params
);

Parameter

light

Eine Lichtquelle. Die Anzahl möglicher Leuchten hängt von der Implementierung ab, aber mindestens acht Leuchten werden unterstützt. Sie werden durch symbolische Namen der Form GL_LIGHT i gekennzeichnet, wobei 0 = i< GL_MAX_LIGHTS.

pname

Ein Lichtquellenparameter für Licht. Die folgenden symbolischen Namen werden akzeptiert.

Wert	Bedeutung
GL_AMBIENT	Der Parameter params gibt vier ganzzahlige oder Gleitkommawerte zurück, die die Umgebungsintensität der Lichtquelle darstellen. Ganzzahlige Werte 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 sich der interne Wert außerhalb des Bereichs [-1,1] befindet, ist der entsprechende ganzzahlige Rückgabewert nicht definiert.
GL_DIFFUSE	Der Params-Parameter gibt vier ganzzahlige oder Gleitkommawerte zurück, die die diffuse Intensität der Lichtquelle darstellen. Ganzzahlige Werte 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 sich der interne Wert außerhalb des Bereichs [-1,1] befindet, ist der entsprechende ganzzahlige Rückgabewert nicht definiert.
GL_SPECULAR	Der params-Parameter gibt vier ganzzahlige oder Gleitkommawerte zurück, die die Spiegelintensität der Lichtquelle darstellen. Ganzzahlige Werte 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 sich der interne Wert außerhalb des Bereichs [-1,1] befindet, ist der entsprechende ganzzahlige Rückgabewert nicht definiert.
GL_POSITION	Der Parameter params gibt vier ganzzahlige Werte oder Gleitkommawerte zurück, die die Position der Lichtquelle darstellen. Ganzzahlige Werte werden bei Anforderung berechnet, indem die internen Gleitkommawerte auf den nächsten ganzzahligen Wert gerundet werden. Bei den zurückgegebenen Werten handelt es sich um werte, die in Augenkoordinaten beibehalten werden. Sie entsprechen nicht den mit glLight angegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des Aufrufs von glLight identifiziert.
GL_SPOT_DIRECTION	Der Parameter params gibt drei ganzzahlige oder Gleitkommawerte zurück, die die Richtung der Lichtquelle darstellen. Ganzzahlige Werte werden bei Anforderung berechnet, indem die internen Gleitkommawerte auf den nächsten ganzzahligen Wert gerundet werden. Bei den zurückgegebenen Werten handelt es sich um werte, die in Augenkoordinaten beibehalten werden. Sie entsprechen nicht den mit glLight angegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des Aufrufs von glLight identifiziert. Obwohl die Spotrichtung vor der Verwendung in der Beleuchtungsgleichung normalisiert wird, sind die zurückgegebenen Werte die transformierten Versionen der angegebenen Werte vor der Normalisierung.
GL_SPOT_EXPONENT	Der params-Parameter gibt einen einzelnen ganzzahligen Wert oder Gleitkommawert zurück, der den Spotexponenten des Lichts darstellt. Ein ganzzahliger Wert wird bei Anforderung berechnet, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird.
GL_SPOT_CUTOFF	Der Parameter params gibt einen einzelnen ganzzahligen Wert oder Gleitkommawert zurück, der den Punktausschnittswinkel des Lichts darstellt. Ein ganzzahliger Wert wird bei Anforderung berechnet, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird.
GL_CONSTANT_ATTENUATION	Der params-Parameter gibt einen einzelnen ganzzahligen Wert oder Gleitkommawert zurück, der die konstante (nicht entfernungsbezogene) Dämpfung des Lichts darstellt. Ein ganzzahliger Wert wird bei Anforderung berechnet, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird.
GL_LINEAR_ATTENUATION	Der params-Parameter gibt einen einzelnen ganzzahligen Wert oder Gleitkommawert zurück, der die lineare Dämpfung des Lichts darstellt. Ein ganzzahliger Wert wird bei Anforderung berechnet, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird.
GL_QUADRATIC_ATTENUATION	Der parameter params gibt einen einzelnen ganzzahligen wert oder gleitkommawert zurück, der die quadratische Dämpfung des Lichts darstellt. Ein ganzzahliger Wert wird bei Anforderung berechnet, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird.

params

Gibt die angeforderten Daten zurück.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Die glGetLight-Funktion gibt in params den Wert oder die Werte eines Lichtquellenparameters zurück. Der Lichtparameter benennt das Licht und ist ein symbolischer Name der Form GL_LIGHTi für 0 = i< GL_MAX_LIGHTS, wobei GL_MAX_LIGHTS eine implementierungsabhängige Konstante ist, die größer oder gleich acht ist. Der pname-Parameter gibt einen von zehn Lichtquellenparametern an, wiederum durch symbolischen Namen.

Es ist immer so, dass GL_LIGHTi = GL_LIGHT0 + i.

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

Weitere Informationen

glBegin

glEnd

glLight