glFogiv fonction)

La fonction glFogfv spécifie des 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
_mode de brouillard GL _
Le paramètre params est une valeur entière unique qui spécifie l’équation à utiliser pour calculer le facteur de mélange 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 de brouillard par défaut est GL _ exp.
_densité de brouillard GL _
Le paramètre params est une valeur entière unique qui spécifie la densité, la densité de brouillards 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.
_début du brouillard GL _
Le paramètre params est une valeur entière unique qui spécifie Start, la distance la plus proche utilisée dans l’équation de brouillard linéaire. La distance proche par défaut est 0,0.
_fin du brouillard comptable _
Le paramètre params est une valeur entière unique qui spécifie end, la distance utilisée dans l’équation de brouillard linéaire. La distance éloignée par défaut est 1,0.
_index de brouillard GL _
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.
_couleur de brouillard GL _
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 de façon linéaire de telle sorte que la valeur représentable la plus positive corresponde à 1,0, et la valeur représentable la plus négative correspond à-1,0. Les valeurs à virgule flottante sont mappées directement. Après la conversion, tous les composants de couleur sont ancrés à la plage [ 0, 1 ] . La couleur de brouillard par défaut est (0, 0, 0, 0).

params

Spécifie la ou les valeurs à assigner à pname. La _ _ couleur de brouillard GL requiert 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
_enum GL non valide _
pname n’est pas une valeur acceptée.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Remarques

Vous activez et désactivez le brouillard avec glEnable et glDisable, à l’aide de l’argument GL _ Fog. Bien qu’activé, le brouillard affecte les géométries pixellisées, les bitmaps et les blocs de pixels, mais pas les opérations d’effacement de la mémoire tampon.

La fonction glFogiv assigne la ou les valeurs dans les paramètres au paramètre de brouillard spécifié par pname.

Le brouillard fusionne une couleur de brouillard avec chaque couleur de posttexturing du fragment de pixel pixellisé à l’aide d’un facteur de fusion f. Factor f est calculé de l’une des trois façons suivantes, en fonction du mode de brouillard. Indiquez z comme distance en coordonnées oculaires à partir de l’origine jusqu’au fragment à la une. L’équation du _ brouillard linéaire du GL est la suivante :

Équation représentant la valeur du facteur de fusion en GL_LINEAR mode de brouillard en tant que fonction de distance.

L’équation du brouillard du GL _ exp est la suivante :

Équation représentant la valeur du facteur de fusion en GL_EXP mode de brouillard.

L’équation du _ brouillard EXP2 GL est la suivante :

Équation représentant la valeur du facteur de fusion en GL_EXP2 mode de brouillard.

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

Équation qui indique la couleur du fragment-brouillard en fonction du facteur de fusion et de la couleur de brouillard.

En mode d’index des couleurs, l’index de couleurs du fragment est remplacé par

Équation représentant l’index de couleurs du fragment à l’échelle du monde en tant que fonction du facteur de fusion et de la couleur indexée.

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

glGet avec argument GL _ - _ couleur de brouillard

glGet avec l' _ index de brouillard de GL d’argument _

glGet avec argument GL _ - _ densité de brouillard

glGet avec argument de _ début de brouillard GL _

glGet avec argument GL de _ brouillard de _ fin

glGet avec argument GL de _ brouillard _ en mode

glIsEnabled avec argument de brouillard de la comptabilité _

Configuration requise

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