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 è:

Equazione che mostra il valore del fattore di fusione in GL_LINEAR modalità nebbia come funzione della distanza.

L'equazione per GL_EXP nebbia è:

Equazione che mostra il valore del fattore di fusione in GL_EXP modalità nebbia.

L'equazione per GL_EXP2 nebbia è:

Equazione che mostra il valore del fattore di fusione in GL_EXP2 modalità 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 Cr viene sostituito da

Equazione che mostra il colore del frammento nebbia come funzione del fattore di fusione e del colore della nebbia.

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

Equazione che mostra l'indice di colore del frammento nebbia come funzione del fattore di fusione e del colore indicizzato.

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