fonction glTexParameteri

Définit les paramètres de texture.

Syntaxe

void WINAPI glTexParameteri(
   GLenum target,
   GLenum pname,
   GLint  param
);

Paramètres

cible

Texture cible, qui doit être GL_TEXTURE_1D ou GL_TEXTURE_2D.

pname

Nom symbolique d’un paramètre de texture à valeur unique. Les symboles suivants sont acceptés dans pname.

Valeur	Signification
GL_TEXTURE_MIN_FILTER	La fonction de minification de texture est utilisée chaque fois que le pixel texturé est mappé à une zone supérieure à un élément de texture. Il existe six fonctions de minification définies. Deux d’entre eux utilisent l’un ou les quatre éléments de texture les plus proches pour calculer la valeur de texture. Les quatre autres utilisent des mipmaps. Un mipmap est un ensemble ordonné de tableaux représentant la même image à des résolutions progressivement inférieures. Si la texture a des dimensions 2nx2m , il y a max(n, m) + 1 mipmaps. Le premier mipmap est la texture d’origine, avec des dimensions de 2nx2m. Chaque mipmap suivant a des dimensions 2k1x2l1, où 2kx2l sont les dimensions du mipmap précédent, jusqu’à k = 0 ou l = 0. À ce stade, les mipmaps suivants ont la dimension 1x2l1 ou 2k1x1 jusqu’au mipmap final, qui a la dimension 1x1. Les Mipmaps sont définis à l’aide de glTexImage1D ou glTexImage2D avec l’argument de niveau de détail indiquant l’ordre des mipmaps. Le niveau 0 est la texture d’origine ; level bold max(n, m) est le dernier 1x1 mipmap.
GL_TEXTURE_MAG_FILTER	La fonction d’agrandissement de texture est utilisée lorsque le pixel texturé est mappé à une zone inférieure ou égale à un élément de texture. Il définit la fonction d’agrandissement de texture sur GL_NEAREST ou GL_LINEAR.
GL_TEXTURE_WRAP_S	Définit le paramètre wrap pour les coordonnées de texture sur GL_CLAMP ou GL_REPEAT. GL_CLAMP permet de serrer les coordonnées s à la plage [0,1] et est utile pour empêcher l’encapsulage d’artefacts lors du mappage d’une seule image sur un objet. GL_REPEAT entraîne l’ignorer de la partie entière de la coordonnée s ; OpenGL utilise uniquement la partie fractionnaire, créant ainsi un modèle répétiteur. Les éléments de texture de bordure sont accessibles uniquement si le wrapping est défini sur GL_CLAMP. Initialement, GL_TEXTURE_WRAP_S est défini sur GL_REPEAT.
GL_TEXTURE_WRAP_T	Définit le paramètre wrap pour la coordonnée de texture t sur GL_CLAMP ou GL_REPEAT. Voir la discussion sous GL_TEXTURE_WRAP_S. Initialement, GL_TEXTURE_WRAP_T est défini sur GL_REPEAT

param

Valeur de pname.

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 .

Notes

Le mappage de textures est une technique qui applique une image à la surface d’un objet comme si l’image était un réducteur-wrap decal ou cellophane. L’image est créée dans l’espace de texture, avec un système de coordonnées (s, t). Une texture est une image à une ou deux dimensions et un ensemble de paramètres qui déterminent la façon dont les exemples sont dérivés de l’image.

La fonction glTexParameter affecte la ou les valeurs en paramètres au paramètre de texture spécifié sous la forme pname. Le paramètre cible définit la texture cible, GL_TEXTURE_1D ou GL_TEXTURE_2D.

À mesure que plus d’éléments de texture sont échantillonnées dans le processus de minification, moins d’artefacts d’aliasing sont apparents. Bien que les fonctions de minification GL_NEAREST et GL_LINEAR puissent être plus rapides que les quatre autres, elles échantillonnent seulement un ou quatre éléments de texture pour déterminer la valeur de texture du pixel affiché et peuvent produire des modèles moire ou des transitions en lambeaux. La valeur par défaut de GL_TEXTURE_MIN_FILTER est GL_NEAREST_MIPMAP_LINEAR.

Supposons que la texturation soit activée (en appelant glEnable avec l’argument GL_TEXTURE_1D ou GL_TEXTURE_2D) et que GL_TEXTURE_MIN_FILTER soit défini sur l’une des fonctions qui nécessitent un mipmap. Si les dimensions des images de texture actuellement définies (avec les appels précédents à glTexImage1D ou glTexImage2D) ne suivent pas la séquence appropriée pour les mipmaps, ou s’il y a moins d’images de texture définies que nécessaire, ou si l’ensemble d’images de texture a différents nombres de composants de texture, c’est comme si le mappage de texture était désactivé. Le filtrage linéaire accède aux quatre éléments de texture les plus proches uniquement dans les textures 2D. Dans les textures 1D, le filtrage linéaire accède aux deux éléments de texture les plus proches. La fonction suivante récupère des informations relatives à glTexParameterf, glTexParameteri, glTexParameterfv et glTexParameteriv :

glGetTexParameter

Spécifications

Voir aussi

glBegin

glBindTexture

glCopyPixels

glCopyTexImage1D

glCopyTexImage2D

glCopyTexSubImage2D

glDrawPixels

glEnd

glGetTexParameter

glPixelStore

glPixelTransfer

glPrioritizeTextures

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexSubImage1D

glTexSubImage2D