glGetLightfv-Funktion

Die Funktionen glGetLightfv und glGetLightiv geben Die Werte des Lichtquellenparameters zurück.

Syntax

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

Parameter

light

Eine Lichtquelle. Die Anzahl der möglichen Lichter hängt von der Implementierung ab, aber es werden mindestens acht Leuchten unterstützt. Sie werden durch symbolische Namen der Form GL_LIGHT i identifiziert, 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 Ganzzahl- oder Gleitkommawerte zurück, die die Umgebungsintensität der Lichtquelle 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 Intensität der Lichtquelle 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 Glanzintensität der Lichtquelle 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_POSITION	Der Parameter params gibt vier Ganzzahl- 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. Die zurückgegebenen Werte sind werte, die in Augenkoordinaten verwaltet werden. Sie sind nicht gleich 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 Ganzzahl- 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. Die zurückgegebenen Werte sind werte, die in Augenkoordinaten verwaltet werden. Sie sind nicht gleich den mit glLight angegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des Aufrufs von glLight identifiziert. Obwohl die Spotrichtung normalisiert wird, bevor sie in der Beleuchtungsgleichung verwendet wird, sind die zurückgegebenen Werte die transformierten Versionen der angegebenen Werte vor der Normalisierung.
GL_SPOT_EXPONENT	Der parameter params gibt eine einzelne ganze Zahl oder einen Gleitkommawert zurück, der den Spot-Exponenten 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 eine einzelne ganze Zahl oder einen Gleitkommawert zurück, der den Punkttrennwinkel 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 parameter params gibt eine einzelne ganze Zahl oder einen 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 parameter params gibt eine einzelne ganze Zahl oder einen 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 eine einzelne ganze Zahl oder einen 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 Light-Parameter 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 Parameter pname gibt einen von zehn Lichtquellenparametern an, wiederum nach symbolischem 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