glFogfv-Funktion
Die glFogfv-Funktion gibt Nebelparameter an.
Syntax
void WINAPI glFogfv(
GLenum pname,
const GLfloat *params
);
Parameter
-
pname
-
Gibt einen Nebelparameter an.
Akzeptiert einen der folgenden Werte.
Wert Bedeutung - GL_FOG_MODE
Der Parameter params ist ein Gleitkommawert, der die Formel angibt, die zum Berechnen des Nebelmischungsfaktors f verwendet werden soll. Es werden drei symbolische Konstanten akzeptiert: GL_LINEAR, GL_EXP und GL_EXP2. Die Formeln, die diesen symbolischen Konstanten entsprechen, werden im folgenden Abschnitt Hinweise definiert. Der Standard-Nebelmodus ist GL_EXP. - GL_FOG_DENSITY
Der Parameter params ist ein Gleitkommawert, der die Dichte angibt, die Nebeldichte, die in beiden exponentiellen Nebelgleichungen verwendet wird. Es werden nur nicht negative Dichten akzeptiert. Die Standardmäßige Nebeldichte ist 1,0. - GL_FOG_START
Der Parameter params ist ein Gleitkommawert, der den Start angibt, also die nähe Entfernung, die in der linearen Nebelgleichung verwendet wird. Die standardnahe Entfernung ist 0,0. - GL_FOG_END
Der params-Parameter ist ein Gleitkommawert, der end angibt, den in der linearen Nebelgleichung verwendeten Fernabstand. Der Standardabstand ist 1,0. - GL_FOG_INDEX
Der parameter params ist ein Gleitkommawert, der if angibt, den Nebelfarbindex. Der Standard-Nebelindex ist 0,0. - GL_FOG_COLOR
Der parameter params enthält vier Gleitkommawerte, die Cf , die Nebelfarbe angeben. Ganzzahlwerte werden linear so zugeordnet, dass der positivste darstellbare Wert 1,0 und der negativste darstellbare Wert -1,0 zugeordnet wird. Gleitkommawerte werden direkt zugeordnet. Nach der Konvertierung werden alle Farbkomponenten auf den Bereich [0,1] geklemmt. Die Standardfarbe für Nebel ist (0,0,0,0,0). -
params
-
Gibt den Wert oder die Werte an, die pname zugewiesen werden sollen. GL_FOG_COLOR erfordert ein Array von vier Werten. Alle anderen Parameter akzeptieren ein Array, das nur einen einzelnen Wert enthält.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
pname war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Sie aktivieren und deaktivieren Nebel mit glEnable und glDisable mithilfe des Arguments GL_FOG. Obwohl aktiviert, wirkt sich Nebel auf gerasterte Geometrie, Bitmaps und Pixelblöcke aus, jedoch keine Pufferlöschvorgänge.
Die glFogfv-Funktion weist den Wert oder die Werte in Params dem durch pname angegebenen Nebelparameter zu.
Nebel mischt eine Nebelfarbe mit der Posttexturingfarbe jedes gerasterten Pixelfragments mithilfe eines Mischfaktors f. Faktor f wird je nach Nebelmodus auf eine von drei Arten berechnet. Lassen Sie z den Abstand in Den Augenkoordinaten vom Ursprung zum beschlagenen Fragment sein. Die Gleichung für GL_LINEAR Nebel lautet:
Die Gleichung für GL_EXP Nebel lautet:
Die Gleichung für GL_EXP2 Nebel lautet:
Unabhängig vom Nebelmodus wird f nach der Berechnung in den Bereich [0,1] eingespannt. Wenn sich OpenGL dann im RGBA-Farbmodus befindet, wird die Farbe Cr des Fragments durch ersetzt.
Im Farbindexmodus wird der Farbindex des Fragments durch ersetzt.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit den glFog-Funktionen ab:
glGet mit argument GL_FOG_COLOR
glGet mit argument GL_FOG_INDEX
glGet mit Argument GL_FOG_DENSITY
glGet mit Argument GL_FOG_START
glGet mit argument GL_FOG_END
glGet mit Argument GL_FOG_MODE
glIsEnabled mit Argument GL_FOG
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 |
|