fonction glFogiv

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

Syntaxe

void WINAPI glFogiv(
         GLenum pname,
   const GLint  *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 entière unique 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 entière unique 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 entière unique 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 entière unique qui spécifie end, la distance de distance 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 entière unique 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 entières ou à 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 .

Name	Signification
GL_INVALID_ENUM	pname n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

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 glFogiv affecte la ou les valeurs dans les 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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glDisable

glEnable

glEnd

glGet

glIsEnabled