fonction glTexEnvf
La fonction glTexEnvf définit un paramètre d’environnement de texture.
Syntaxe
void WINAPI glTexEnvf(
GLenum target,
GLenum pname,
GLfloat param
);
Paramètres
-
cible
-
Environnement de texture. Doit être GL_TEXTURE_ENV.
-
pname
-
Nom symbolique d’un paramètre d’environnement de texture à valeur unique. Doit être GL_TEXTURE_ENV_MODE.
-
param
-
Constante symbolique unique, l’une des GL_MODULATE, GL_DECAL, GL_BLEND ou GL_REPLACE.
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 .
Nom | Signification |
---|---|
|
target ou pname n’était pas l’une des valeurs définies acceptées, ou lorsque params aurait dû avoir une valeur constante définie (basée sur la valeur de pname) et ne l’a pas fait. |
|
La fonction a été appelée entre un appel à glBegin et l’appel à glEnd correspondant. |
Notes
Un environnement de texture spécifie la façon dont les valeurs de texture sont interprétées lorsqu’un fragment est texturé. Le paramètre cible doit être GL_TEXTURE_ENV. Le paramètre pname est GL_TEXTURE_ENV_MODE. Trois fonctions de texture sont définies : GL_MODULATE, GL_DECAL et GL_BLEND.
Une fonction de texture agit sur le fragment à texturer à l’aide de la valeur d’image de texture qui s’applique au fragment (voir glTexParameter) et produit une couleur RGBA pour ce fragment. Le tableau suivant montre comment la couleur RVBA est produite pour chacune des trois fonctions de texture qui peuvent être choisies. C est un triple de valeurs de couleur (RVB) et A est la valeur alpha associée. Les valeurs RVBA extraites d’une image de texture se trouvent dans la plage [0, 1]. L’indice f fait référence au fragment entrant, l’indice t à l’image de texture, l’indice c à la couleur de l’environnement de texture et l’indice v indique une valeur produite par la fonction de texture.
Une image de texture peut avoir jusqu’à quatre composants par élément de texture (voir glTexImage1D et glTexImage2D). Dans une image à un composant, Lt indique ce composant unique. Une image à deux composants utilise L ? et A ? . Une image à trois composants n’a qu’une valeur de couleur, C ? . Une image à quatre composants a à la fois une valeur de couleur C ? et une valeur alpha A? .
Nombre de composants | GL_MODULATE | GL_DECAL | GL_BLEND |
---|---|---|---|
1${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L ?)Cf + L?Cc |
Unv = Af | Unv = Af | ||
2${REMOVE}$ |
Cv = L?Cf | undefined${REMOVE}$ |
Cv = (1 - L?)Cf + L?Cc |
Unv = Af | Unv = Af | ||
3${REMOVE}$ |
Cv = C?Cf | Cv = C? | undefined${REMOVE}$ |
Unv = Af | Unv = Af | ||
4${REMOVE}$ |
Cv = C?Cf | Cv = (1 - A?)Cf + A ?C? | undefined${REMOVE}$ |
Unv = Un?Af | Unv = Af |
GL_TEXTURE_ENV_MODE est GL_MODULATE par défaut.
La fonction suivante récupère les informations relatives à glTexEnvf :
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 |
|
Bibliothèque |
|
DLL |
|