Partager via


Fonction gluBuild2DMipmaps

La fonction gluBuild2DMipmaps crée des mipmaps 2D.

Syntaxe

void WINAPI gluBuild2DMipmaps(
         GLenum target,
         GLint  components,
         GLint  width,
         GLInt  height,
         GLenum format,
         GLenum type,
   const void   *data
);

Paramètres

cible

Texture cible. Doit être GL_TEXTURE_2D.

components

Nombre de composants de couleur dans la texture. Doit être 1, 2, 3 ou 4.

width

Largeur de l’image de texture.

height

Hauteur de l’image de texture.

format

Format des données de pixels. Doit être l’une des suivantes : GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE ou GL_LUMINANCE_ALPHA.

type

Type de données pour les données. Doit être l’une des suivantes : GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.

data

Pointeur vers les données d’image en mémoire.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La fonction gluBuild2DMipmaps obtient l’image d’entrée et génère toutes les images mipmap (à l’aide de gluScaleImage) afin que l’image d’entrée puisse être utilisée comme image de texture mipmapped. Pour charger chacune des images, appelez glTexImage2D. Si les dimensions de l’image d’entrée ne sont pas des puissances de deux, l’image est mise à l’échelle de sorte que la largeur et la hauteur soient toutes deux de deux puissances avant la génération des mipmaps.

Une valeur de retour égale à zéro indique la réussite. Sinon, un code d’erreur GLU est retourné (voir gluErrorString).

Pour obtenir une description des valeurs acceptables pour le paramètre de format , consultez glTexImage2D. Pour obtenir une description des valeurs acceptables pour le type, consultez glDrawPixels.

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

Voir aussi

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage