fonction glFogfv

La fonction glFogfv spécifie les paramètres de brouillard.

Syntaxe

void WINAPI glFogfv(
         GLenum  pname,
   const GLfloat *params
);

Paramètres

pname

Spécifie un paramètre de brouillard.

Accepte l’une des valeurs suivantes.

Valeur	Signification
GL_FOG_MODE	Le paramètre params est une valeur à virgule flottante qui spécifie l’équation à utiliser pour calculer le facteur de fusion de brouillard, f. Trois constantes symboliques sont acceptées : GL_LINEAR, GL_EXP et GL_EXP2. Les équations correspondant à ces constantes symboliques sont définies dans la section Notes suivante. Le mode brouillard par défaut est GL_EXP.
GL_FOG_DENSITY	Le paramètre params est une valeur à virgule flottante qui spécifie la densité, la densité de brouillard utilisée dans les deux équations de brouillard exponentiel. Seules les densités non négatives sont acceptées. La densité de brouillard par défaut est 1.0.
GL_FOG_START	Le paramètre params est une valeur à virgule flottante qui spécifie start, la distance proche utilisée dans l’équation de brouillard linéaire. La distance proche par défaut est 0,0.
GL_FOG_END	Le paramètre params est une valeur à virgule flottante qui spécifie end, la distance éloignée utilisée dans l’équation de brouillard linéaire. La distance lointaine par défaut est 1,0.
GL_FOG_INDEX	Le paramètre params est une valeur à virgule flottante qui spécifie if , l’index de couleur de brouillard. L’index de brouillard par défaut est 0,0.
GL_FOG_COLOR	Le paramètre params contient quatre valeurs à virgule flottante qui spécifient Cf , la couleur de brouillard. Les valeurs entières sont mappées linéairement de telle sorte que la valeur représentable la plus positive est mappée à 1,0, et la valeur représentable la plus négative est mappée à -1,0. Les valeurs à virgule flottante sont mappées directement. Après la conversion, tous les composants de couleur sont limités à la plage [0,1]. La couleur de brouillard par défaut est (0,0,0,0).

params

Spécifie la ou les valeurs à affecter à pname. GL_FOG_COLOR nécessite un tableau de quatre valeurs. Tous les autres paramètres acceptent un tableau contenant une seule valeur.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Notes

Vous activez et désactivez le brouillard avec glEnable et glDisable, à l’aide de l’argument GL_FOG. Lorsqu’il est activé, le brouillard affecte la géométrie rastérisée, les bitmaps et les blocs de pixels, mais pas les opérations d’effacement de la mémoire tampon.

La fonction glFogfv affecte la ou les valeurs en paramètres au paramètre fog spécifié par pname.

Le brouillard mélange une couleur de brouillard avec la couleur posttexturante de chaque fragment de pixels rastérisé à l’aide d’un facteur de fusion f. Le facteur f est calculé de l’une des trois manières, en fonction du mode brouillard. Soit z la distance en coordonnées oculaires entre l’origine et le fragment en cours d’enregistrement. L’équation pour GL_LINEAR brouillard est la suivante :

L’équation pour GL_EXP brouillard est la suivante :

L’équation pour GL_EXP2 brouillard est la suivante :

Quel que soit le mode brouillard, f est limité à la plage [0,1] après son calcul. Ensuite, si OpenGL est en mode de couleur RVBA, la couleur C_r du fragment est remplacée par

En mode color-index, l’index de couleur du fragment i_r est remplacé par

Les fonctions suivantes récupèrent des informations relatives aux fonctions glFog :

glGet avec argument GL_FOG_COLOR

glGet avec argument GL_FOG_INDEX

glGet avec GL_FOG_DENSITY d’arguments

glGet avec argument GL_FOG_START

glGet avec argument GL_FOG_END

glGet avec argument GL_FOG_MODE

glIsEnabled avec argument GL_FOG

Spécifications

Voir aussi

glBegin

glDisable

glEnable

glEnd

glGet

glIsEnabled