glLightf-Funktion
Die glLightf-Funktion gibt Parameterwerte der Lichtquelle zurück.
Syntax
void WINAPI glLightf(
GLenum light,
GLenum pname,
GLfloat param
);
Parameter
-
light
-
Der Bezeichner eines Lichts. 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_LIGHTi identifiziert, wobei i ein Wert ist: 0 bis GL_MAX_LIGHTS - 1.
-
pname
-
Ein einwertige Lichtquellenparameter für Licht. Die folgenden symbolischen Namen werden akzeptiert.
Wert Bedeutung - GL_SPOT_EXPONENT
Der param-Parameter ist ein einzelner Gleitkommawert, der die Intensitätsverteilung des Lichts angibt. Gleitkommawerte werden direkt zugeordnet. Es werden nur Werte im Bereich [0, 128] akzeptiert.
Die effektive Lichtintensität wird durch den Kosinus des Winkels zwischen der Richtung des Lichts und der Richtung vom Licht zum Scheitelpunkt abgeschwächt, der zur Kraft des Spot-Exponenten angehoben wird. Daher führen höhere Spot-Exponenten zu einer fokussierteren Lichtquelle, unabhängig vom Punktausschnittwinkel. Der Standardspotexponent ist 0, was zu einer gleichmäßigen Lichtverteilung führt.- GL_SPOT_CUTOFF
Der param-Parameter ist ein einzelner Gleitkommawert, der den maximalen Streuwinkel einer Lichtquelle angibt. Gleitkommawerte werden direkt zugeordnet. Es werden nur Werte im Bereich [0, 90] und dem Sonderwert 180 akzeptiert.
Wenn der Winkel zwischen der Richtung des Lichts und der Richtung vom Licht zum beleuchteten Scheitelpunkt größer ist als der Punkttrennwinkel, wird das Licht vollständig maskiert. Andernfalls wird seine Intensität durch den Spot-Exponenten und die Dämpfungsfaktoren gesteuert. Der Standardmäßige Spot-Cutoff ist 180, was zu einer gleichmäßigen Lichtverteilung führt.- GL_CONSTANT_ATTENUATION, GL_LINEAR_ATTENUATION, GL_QUADRATIC_ATTENUATION
Der param-Parameter ist ein einzelner Gleitkommawert, der einen der drei Lichtdämpfungsfaktoren angibt. Gleitkommawerte werden direkt zugeordnet. Es werden nur nicht negative Werte akzeptiert.
Wenn das Licht positional und nicht richtungsmäßig ist, wird seine Intensität durch den Reziproz der Summe von abgeschwächt: dem konstanten Faktor, dem linearen Faktor multipliziert mit dem Abstand zwischen Licht und Scheitelpunkt und dem quadratischen Faktor multipliziert mit dem Quadrat derselben Entfernung. Die Standardabschwächungsfaktoren sind (1,0,0), was zu keiner Dämpfung führt. -
param
-
Gibt den Wert an, auf den der Parameter pname des Lichtquellenlichts 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 |
|---|---|
|
light oder pname war kein akzeptierter Wert. |
|
Ein Spot-Exponentenwert wurde außerhalb des Bereichs [0, 128] angegeben, oder der Spot-Cutoff wurde außerhalb des Bereichs [0, 90] angegeben (mit Ausnahme des Sonderwerts 180), oder es wurde ein negativer Dämpfungsfaktor angegeben. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Die glLightf-Funktion legt den Wert oder die Werte einzelner Lichtquellenparameter fest. Der Lichtparameter benennt das Licht und ist ein symbolischer Name der Form GL_LIGHTi, wobei 0 = i< GL_MAX_LIGHTS.
Der pname-Parameter gibt einen der Lichtquellenparameter an, wiederum durch symbolischen Namen. Der param-Parameter ist entweder ein einzelner Wert oder ein Zeiger auf ein Array, das die neuen Werte enthält.
Die Beleuchtungsberechnung wird mithilfe von glEnable und glDisable mit argument GL_LIGHTING aktiviert und deaktiviert. Wenn die Beleuchtung aktiviert ist, tragen aktivierte Lichtquellen zur Beleuchtungsberechnung bei. Die Lichtquelle i ist mit glEnable und glDisable mit argument GL_LIGHTi aktiviert und deaktiviert.
Es ist immer so, dass GL_LIGHTi = GL_LIGHT0 + i.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit der glLightf-Funktion ab:
glIsEnabled mit Argument GL_LIGHTING
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 |
|