funzione glFogiv

La funzione glFogfv specifica i parametri fog.

Sintassi

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

Parametri

Pname

Specifica un parametro fog.

Accetta uno dei valori seguenti.

Valore	Significato
GL_FOG_MODE	Il parametro params è un singolo valore intero che specifica l'equazione da usare per calcolare il fattore di fusione nebbia, f. Vengono accettate tre costanti simboliche: GL_LINEAR, GL_EXP e GL_EXP2. Le equazioni corrispondenti a queste costanti simboliche sono definite nella sezione Osservazioni seguente. La modalità nebbia predefinita è GL_EXP.
GL_FOG_DENSITY	Il parametro params è un singolo valore intero che specifica la densità, la densità di nebbia usata in entrambe le equazioni di nebbia esponenziali. Vengono accettate solo densità non negativi. La densità di nebbia predefinita è 1,0.
GL_FOG_START	Il parametro params è un singolo valore intero che specifica l'inizio, la distanza vicina utilizzata nell'equazione di nebbia lineare. La distanza di prossimità predefinita è 0,0.
GL_FOG_END	Il parametro params è un singolo valore intero che specifica la fine, la distanza lontana utilizzata nell'equazione di nebbia lineare. La distanza di distanza predefinita è 1,0.
GL_FOG_INDEX	Il parametro params è un singolo valore intero che specifica if , l'indice del colore nebbia. L'indice di nebbia predefinito è 0,0.
GL_FOG_COLOR	Il parametro params contiene quattro valori interi o a virgola mobile che specificano Cf , il colore della nebbia. I valori integer vengono mappati in modo lineare in modo che il valore rappresentabile più positivo sia mappato a 1,0 e che il valore rappresentabile più negativo sia mappato a -1,0. I valori a virgola mobile vengono mappati direttamente. Dopo la conversione, tutti i componenti di colore vengono bloccati nell'intervallo [0,1]. Il colore di nebbia predefinito è (0,0,0,0).

params

Specifica il valore o i valori da assegnare a pname. GL_FOG_COLOR richiede una matrice di quattro valori. Tutti gli altri parametri accettano una matrice contenente un solo valore.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_ENUM	pname non è un valore accettato.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

È possibile abilitare e disabilitare la nebbia con glEnable e glDisable, usando l'argomento GL_FOG. Mentre è abilitata, la nebbia influisce sulla geometria rasterizzata, sulle bitmap e sui blocchi pixel, ma non sulle operazioni di cancellazione del buffer.

La funzione glFogiv assegna il valore o i valori in params al parametro fog specificato da pname.

La nebbia fonde un colore nebbia con ogni colore posttexturing di ogni frammento di pixel rasterizzato usando un fattore di fusione f. Il fattore f viene calcolato in uno dei tre modi, a seconda della modalità nebbia. Lasciare che z sia la distanza nelle coordinate oculari dall'origine al frammento in fase di nebbia. L'equazione per GL_LINEAR nebbia è:

L'equazione per GL_EXP nebbia è:

L'equazione per GL_EXP2 nebbia è:

Indipendentemente dalla modalità nebbia, f viene bloccato all'intervallo [0,1] dopo il calcolo. Quindi, se OpenGL è in modalità colore RGBA, il colore del frammento C_r viene sostituito da

In modalità indice colore, l'indice di colore del frammento i_r viene sostituito da

Le funzioni seguenti recuperano informazioni correlate alle funzioni glFog :

glGet con argomento GL_FOG_COLOR

glGet con argomento GL_FOG_INDEX

glGet con argomento GL_FOG_DENSITY

glGet con argomento GL_FOG_START

glGet con argomento GL_FOG_END

glGet con argomento GL_FOG_MODE

glIsEnabled con argomento GL_FOG

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glDisable

glEnable

glEnd

glGet

glIsEnabled