glFogiv-Funktion

Die glFogfv-Funktion gibt Parameter für die Gleitsicht an.

Syntax

void WINAPI glFogiv(
         GLenum pname,
   const GLint  *params
);

Parameter

pname

Gibt einen Parameter für die Metriken an.

Akzeptiert einen der folgenden Werte.

Wert Bedeutung
_GL-MODUS _
Der parameter-Parameter ist ein einzelner ganzzahliger Wert, der die Gleichung angibt, die zum Berechnen des Mischungsfaktors "blend" (f) verwendet werden soll. Es werden drei symbolische Konstanten akzeptiert: GL _ LINEAR, GL _ EXP und GL _ EXP2. Die Gleichungen, die diesen symbolischen Konstanten entsprechen, werden im folgenden Abschnitt "Hinweise" definiert. Der Standardmodus ist GL _ EXP.
_GL-DICHTE _
Der params-Parameter ist ein einzelner ganzzahliger Wert, der die Dichte angibt, die in beiden exponentiellen Formeln verwendete Dichte. Es werden nur nicht negative Dichten akzeptiert. Die Standardmäßige Dichte für Die Dichte beträgt 1,0.
_GL-START _
Der params-Parameter ist ein einzelner ganzzahliger Wert, der start angibt, die in der linearen Formel verwendete Entfernung in der Nähe. Der Standardwert für near distance ist 0,0.
GL _ _ VERSCHENKTE END
Der parameter-Parameter ist ein einzelner ganzzahliger Wert, der end angibt, den fernen Abstand, der in der linearen Formel verwendet wird. Der standardweite Abstand beträgt 1,0.
_ _ GLBULS INDEX
Der parameter-Parameter ist ein einzelner ganzzahliger Wert, der if angibt, den Farbindex der Farbe "color". Der Standardindex ist 0,0.
GL _ FOG _ COLOR
Der params-Parameter enthält vier ganzzahlige Werte oder Gleitkommawerte, die Cf , die Farbtonfarbe, angeben. Ganzzahlige Werte werden linear zugeordnet, sodass 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 an den Bereich [ 0,1 ] klammern. Die Standardfarbe ist (0,0,0,0).

params

Gibt den Wert oder die Werte an, die pname zugewiesen werden sollen. GL _ COLOR 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
GL _ INVALID _ ENUM
pname war kein akzeptierter Wert.
GL _ INVALID _ OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen.

Hinweise

Sie aktivieren und deaktivieren Dies ist mit glEnable und glDisablemöglich. Verwenden Sie dazu das Argument GL _ CSV. Während diese Option aktiviert ist, wirkt sich dies auf gerasterte Geometrie, Bitmaps und Pixelblöcke aus, jedoch nicht auf Vorgänge zum Löschen von Puffern.

Die glFogiv-Funktion weist den Wert oder die Werte in Parametern dem durch pname angegebenen parameter -Parameter zu.

Blendet eine Farbtonfarbe mit der Posttexturfarbe jedes rasterisierten Pixelfragments unter Verwendung eines Mischungsfaktors f. Faktor f wird je nach Betriebsmodus auf drei Arten berechnet. Z ist die Entfernung in Den Augenkoordinaten vom Ursprung zum fragmentierten Fragment. Die Gleichung für GL _ LINEAR-Gleichung lautet:

Gleichung, die den Wert des Mischungsfaktors im GL_LINEAR Mode der Mode mode as a function of distance (Abstandsfunktion) zeigt.

Die Gleichung für GL _ EXP-Gleichung lautet:

Gleichung, die den Wert des Mischungsfaktors im GL_EXP Mode zeigt.

Die Gleichung für GL _ EXP2-Gleichung lautet:

Gleichung, die den Wert des Mischungsfaktors im GL_EXP2 Mode zeigt.

Unabhängig vom Modus wird f nach der Berechnung an den Bereich [ 0,1 ] angepasst. Wenn sich OpenGL dann im RGBA-Farbmodus befindet, wird die Farbe Cr des Fragments durch ersetzt.

Gleichung, die die Farbe des verknüpften Fragments als Funktion der Mischungsfaktor- und Farbfarbe zeigt.

Im Farbindexmodus wird der Farbindex des Fragments durch ersetzt.

Gleichung, die den Farbindex des fragmentierten Fragments als Funktion des Mischungsfaktors und der indizierten Farbe zeigt.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit den glFog-Funktionen ab:

glGet mit dem Argument GL _ COLOR _

glGet mit dem Argument GL _ _ VERSCHENKUNGSINDEX

glGet mit dem Argument GL _ DENSITY _ DENSITY

glGet mit dem Argument GL _ _ VERSCHENKUNGSSTART

glGet mit dem Argument GL _ BACKEND _ END

glGet mit dem Argument GL _ _ VERSCHENKUNGSMODUS

glIsEnabled mit dem Argument GL _ VERSCHENK

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

glDisable

glEnable

glEnd

glGet

glIsEnabled