fonction glGetTexLevelParameteriv

Les fonctions glGetTexLevelParameterfv et glGetTexLevelParameteriv retournent des valeurs de paramètre de texture pour un niveau de détail spécifique.

Syntaxe

void WINAPI glGetTexLevelParameteriv(
   GLenum target,
   GLint  level,
   GLenum pname,
   GLint  *params
);

Paramètres

cible

Nom symbolique de la texture cible : GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D.

level

Numéro de niveau de détail de l’image souhaitée. Le niveau 0 est le niveau de l’image de base. Le niveau n est la nièmeimage de réduction de mipmap.

pname

Nom symbolique d’un paramètre de texture. Les noms de paramètres suivants sont acceptés.

Valeur	Signification
GL_TEXTURE_WIDTH	Le paramètre params retourne une valeur unique contenant la largeur de l’image de texture. Cette valeur inclut la bordure de l’image de texture.
GL_TEXTURE_HEIGHT	Le paramètre params retourne une valeur unique contenant la hauteur de l’image de texture. Cette valeur inclut la bordure de l’image de texture.
GL_TEXTURE_INTERNAL_FORMAT	Le paramètre params retourne une valeur unique qui décrit le format texel de la texture.
GL_TEXTURE_BORDER	Le paramètre params retourne une valeur unique : la largeur en pixels de la bordure de l’image de texture.
GL_TEXTURE_RED_SIZE	Résolution de stockage interne du composant rouge d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_GREEN_SIZE	Résolution de stockage interne du composant vert d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_BLUE_SIZE	Résolution de stockage interne du composant bleu d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_ALPHA_SIZE	Résolution de stockage interne du composant alpha d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_LUMINANCE_SIZE	Résolution de stockage interne du composant de luminance d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_INTENSITY_SIZE	Résolution de stockage interne du composant d’intensité d’un texel. La résolution choisie par OpenGL correspondra étroitement à la résolution demandée par l’utilisateur avec l’argument de composant glTexImage1D ou glTexImage2D.
GL_TEXTURE_COMPONENTS	Le paramètre params retourne une valeur unique : le nombre de composants dans l’image de texture.

params

Retourne les données demandées.

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
GL_INVALID_ENUM	target ou pname n’était pas une valeur acceptée.
GL_INVALID_VALUE	level est inférieur à zéro ou supérieur à log2*(max)*, où max est la valeur retournée de GL_MAX_TEXTURE_SIZE.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glGetTexLevelParameter retourne dans params les valeurs des paramètres de texture pour une valeur de niveau de détail spécifique, spécifiée en tant que niveau. Le paramètre cible définit la texture cible, GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D ou GL_PROXY_TEXTURE_2D pour spécifier une texturation unidimensionnelle ou bidimensionnelle. Le paramètre pname spécifie le paramètre de texture dont la ou les valeurs seront retournées.

Si une erreur est générée, aucune modification n’est apportée au contenu des paramètres.

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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter