glTexEnviv fonction)
La fonction glTexEnviv définit un paramètre d’environnement de texture.
Syntaxe
void WINAPI glTexEnviv(
GLenum target,
GLenum pname,
const GLint *params
);
Paramètres
-
cible
-
Environnement de texture. Doit être une _ texture GL _ env.
-
pname
-
Nom symbolique d’un paramètre d’environnement de texture à valeur unique. Les valeurs acceptées sont _ le _ mode env de la texture du GL _ et la couleur de la _ texture GL _ env _ .
-
params
-
Pointeur vers un tableau de paramètres : une constante symbolique unique ou une couleur RVBA.
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 ne faisait pas partie des valeurs définies acceptées, ou lorsque les paramètres devaient avoir une valeur de 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 correspondant à glEnd. |
Notes
Un environnement de texture spécifie la manière dont les valeurs de texture sont interprétées lorsqu’un fragment est texturé. Le paramètre cible doit être de la _ texture GL _ env. Le paramètre pname peut être le _ mode env de la texture GL ou la _ _ couleur de la texture du GL _ _ _ .
Si pname est _ _ _ le mode de texture GL env, alors params est (ou pointe vers) le nom symbolique d’une fonction de texture. Trois fonctions de texture sont définies : _ module de comptabilité GL, _ décalque GL et fusion du GL _ .
Une fonction de texture agit sur le fragment pour être texturée à l’aide de la valeur d’image de texture qui s’applique au fragment (voir glTexParameter) et produit une couleur RVBA 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 une triple des valeurs de couleur (RGB) et a est la valeur alpha associée. Les valeurs RVBA extraites d’une image de texture sont comprises 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 (consultez glTexImage1D et glTexImage2D). Dans une image à un composant, lt indique que seul un composant. Une image à deux composants utilise L ? et un ? . Une image à trois composants a uniquement une valeur de couleur, C ? . Une image à quatre composants a-t-elle une valeur de couleur C ? et une valeur alpha A ? .
| Nombre de composants | GL_MODULATE | GL_DECAL | GL_BLEND |
|---|---|---|---|
| 1 $ {REMOVE} $ |
Cv = L ? Cf | $ {REMOVE} $ non défini |
Cv = (1 - L ? ) Cf + Cc |
| Unv = Unf | Unv = Unf | ||
| 2 $ {REMOVE} $ |
Cv = L ? Cf | $ {REMOVE} $ non défini |
Cv = (1 - L ? ) Cf + Cc |
| Unv = Unf | Unv = Unf | ||
| 3 $ {REMOVE} $ |
Cv = C ? Cf | Cv = C ? | $ {REMOVE} $ non défini |
| Unv = Unf | Unv = Unf | ||
| 4 $ {REMOVE} $ |
Cv = C ? Cf | Cv = (1- A ? ) Cf + A ? Secteur? | $ {REMOVE} $ non défini |
| Unv = R ? Unf | Unv = Unf |
Si pname correspond _ _ _ à la couleur de la texture du GL, params est un pointeur vers un tableau qui contient une couleur RVBA composée de quatre valeurs. Les composants de couleur entier sont interprétés de manière linéaire de telle sorte que l’entier le plus positif est mappé à 1,0, et l’entier le plus négatif est mappé à-1,0. Les valeurs sont ancrées à la plage [ 0, 1 ] quand elles sont spécifiées. C c accepte ces quatre valeurs.
Le _ _ mode env de la texture GL _ est défini par défaut sur la valeur par défaut du module comptabilité GL _ et la _ couleur de la texture de la comptabilité _ env _ est (0, 0, 0, 0).
La fonction suivante récupère des informations relatives à glTexEnviv:
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 |
|