glGetLightiv-Funktion
Die Funktionen glGetLightfv und glGetLightiv geben Light Source-Parameterwerte zurück.
Syntax
void WINAPI glGetLightiv(
GLenum light,
GLenum pname,
GLint *params
);
Parameter
-
light
-
Eine Lichtquelle. Die Anzahl möglicher Beleuchtungen hängt von der Implementierung ab, aber es werden mindestens acht Beleuchtungen unterstützt. Sie werden durch symbolische Namen der Form GL LIGHT i identifiziert, wobei _ 0 = i < GL MAX _ _ LIGHTS.
-
pname
-
Ein Light Source-Parameter für light. Die folgenden symbolischen Namen werden akzeptiert.
Wert Bedeutung - GL _ AMBIENT
Der Parameter params gibt vier ganzzahlige Werte oder Gleitkommawerte zurück, die die Umgebungsstärke der Lichtquelle darstellen. Ganzzahlwerte werden, wenn sie angefordert werden, linear aus der internen Gleitkommadarstellung zugeordnet, damit 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 [ von -1,1 liegt, ist der entsprechende ganzzahlige Rückgabewert ] nicht definiert. - GL _ DIFFUSE
Der Parameter params gibt vier ganzzahlige Werte oder Gleitkommawerte zurück, die die diffuse Intensität der Lichtquelle darstellen. Ganzzahlwerte werden, wenn sie angefordert werden, linear aus der internen Gleitkommadarstellung zugeordnet, damit 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 [ von -1,1 liegt, ist der entsprechende ganzzahlige Rückgabewert ] nicht definiert. - GL _ SPECULAR
Der Parameter params gibt vier ganzzahlige Werte oder Gleitkommawerte zurück, die die Specular-Intensität der Lichtquelle darstellen. Ganzzahlwerte werden, wenn sie angefordert werden, linear aus der internen Gleitkommadarstellung zugeordnet, damit 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 [ von -1,1 liegt, 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, wenn sie angefordert werden, berechnet, indem die internen Gleitkommawerte auf den nächsten ganzzahligen Wert gerundet werden. Die zurückgegebenen Werte werden in Augenkoordinaten beibehalten. Sie sind nicht gleich den mit glLightangegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des GlLight-Namens identifiziert. - GL _ SPOT _ DIRECTION
Der Parameter params gibt drei ganzzahlige Werte oder Gleitkommawerte zurück, die die Richtung der Lichtquelle darstellen. Ganzzahlige Werte werden, wenn sie angefordert werden, berechnet, indem die internen Gleitkommawerte auf den nächsten ganzzahligen Wert gerundet werden. Die zurückgegebenen Werte werden in Augenkoordinaten beibehalten. Sie sind nicht gleich den mit glLight angegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des GlLight-Namens 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 berechnet, wenn er angefordert wird, 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 Spot-Cutoffwinkel des Lichts darstellt. Ein ganzzahliger Wert wird berechnet, wenn er angefordert wird, 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 berechnet, wenn er angefordert wird, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird. - GL _ _ LINEARE DÄMPFUNG
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 berechnet, wenn er angefordert wird, indem die interne Gleitkommadarstellung auf die nächste ganze Zahl gerundet wird. - GL _ QUADRATISCHE _ DÄMPFUNG
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 berechnet, wenn er angefordert wird, 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 Parametern den Wert oder die Werte eines Light Source-Parameters zurück. Der Lichtparameter benennt das Licht und ist ein symbolischer Name der Form GL _ LIGHT i 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 Light Source-Parametern an, wiederum durch symbolischen Namen.
Es ist immer der Fall, dass GL _ LIGHT i = GL _ LIGHT0 + i ist.
Wenn ein Fehler generiert wird, werden keine Änderungen am Inhalt der Parameter vorgenommen.
Requirements (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 |
|