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
GL_INVALID_ENUM	light oder pname war kein akzeptierter Wert.
GL_INVALID_VALUE	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.
GL_INVALID_OPERATION	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:

glGetLight

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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glColorMaterial

glEnd

glLightModel

glMaterial