Auf Englisch lesen

Freigeben über


glFogf-Funktion

Die GlFogf - und -Funktion geben Nebelparameter an.

Syntax

void WINAPI glFogf(
   GLenum  pname,
   GLfloat param
);

Parameter

pname

Gibt einen einwertigen Nebelparameter an.

Akzeptiert einen der folgenden Werte.

Wert Bedeutung
GL_FOG_MODE
Der Parameter params ist ein einzelner 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 einzelner 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 einzelner Gleitkommawert, der den Start angibt, die in der linearen Nebelgleichung verwendete Nahdistanz. Die standardnahe Entfernung ist 0,0.
GL_FOG_END
Der parameter params ist ein einzelner Gleitkommawert, der end angibt, den in der linearen Nebelgleichung verwendeten Abstand. Der Standardabstand ist 1,0.
GL_FOG_INDEX
Der parameter params ist ein einzelner Gleitkommawert, der if , den Nebelfarbindex angibt. Der Standard-Nebelindex ist 0,0.

param

Gibt den Wert an, auf den pname 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
pname war kein akzeptierter Wert.
GL_INVALID_OPERATION
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 glFogf-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:

Gleichung mit dem Wert von GL_LINEAR Nebel.

Die Gleichung für GL_EXP Nebel lautet:

Gleichung mit dem Wert des Mischfaktors im Nebelmodus GL_EXP.

Die Gleichung für GL_EXP2 Nebel lautet:

Gleichung, die den Wert des Mischfaktors im GL_EXP2 Nebelmodus zeigt.

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.

Gleichung, die die Farbe des beschlagenen Fragments als Funktion des Mischfaktors und der Nebelfarbe anzeigt.

Im Farbindexmodus wird der Farbindex des Fragments durch ersetzt.

Gleichung, die den Farbindex des beschlagenen Fragments als Funktion des Mischfaktors und der indizierten Farbe anzeigt.

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

Weitere Informationen

glBegin

glDisable

glEnable

glEnd

glGet

glIsEnabled