Lire en anglais

Partager via


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 :

Équation montrant la valeur du facteur de fusion dans GL_LINEAR mode brouillard en fonction de la distance.

L’équation pour GL_EXP brouillard est la suivante :

Équation montrant la valeur du facteur de fusion en mode brouillard GL_EXP.

L’équation pour GL_EXP2 brouillard est la suivante :

Équation montrant la valeur du facteur de fusion en mode brouillard GL_EXP2.

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 Cr du fragment est remplacée par

Équation montrant la couleur du fragment journalisé en fonction du facteur de fusion et de la couleur de brouillard.

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

Équation montrant l’index de couleur du fragment journalisé en fonction du facteur de fusion et de la couleur indexée.

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