glTexParameterf, fonction

Définit les paramètres de texture.

Syntaxe

void WINAPI glTexParameterf(
   GLenum  target,
   GLenum  pname,
   GLfloat 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 minimisation de texture est utilisée chaque fois que le pixel en cours de texture est mappé à une zone supérieure à un élément de texture. Six fonctions de minimisation sont 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 de 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’à ce que 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 mipmap 1x1 final.
GL_TEXTURE_MAG_FILTER	La fonction d’agrandissement de texture est utilisée lorsque le pixel en cours de texture 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 fait que les coordonnées de s sont limitées à la plage [0,1] et est utile pour empêcher l’encapsulation 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 l’habillage 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. Consultez 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 s’il s’agissait d’une vignette ou d’un wrap réducteur de 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 échantillons 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é en tant que 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 minimisation, moins d’artefacts d’alias sont visibles. Bien que les fonctions GL_NEAREST et GL_LINEAR de minification puissent être plus rapides que les quatre autres, elles échantillonnent un ou quatre éléments de texture uniquement 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écessite 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 un nombre différent de composants de texture, le mappage de textures est 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.

Spécifications

Voir aussi

glBegin

glBindTexture

glCopyPixels

glCopyTexImage1D

glCopyTexImage2D

glCopyTexSubImage2D

glDrawPixels

glEnd

glGetTexParameter

glPixelStore

glPixelTransfer

glPrioritizeTextures

glTexEnv

glTexGen

glTexImage1D

glTexImage2D

glTexSubImage1D

glTexSubImage2D