Fonction gluScaleImage

Article
06/13/2023

La fonction gluScaleImage met à l’échelle une image à une taille arbitraire.

Syntaxe

int WINAPI gluScaleImage(
         GLenum format,
         GLint  widthin,
         GLint  heightin,
         GLenum typein,
   const void   *datain,
         GLint  widthout,
         GLint  heightout,
         GLenum typeout,
         void   *dataout
);

Paramètres

format: Format des données de pixels. Les valeurs symboliques suivantes sont valides : GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE et GL_LUMINANCE_ALPHA.
widthin: Largeur de l’image source mise à l’échelle.
heightin: Hauteur de l’image source mise à l’échelle.
typein: Type de données pour datain. Doit être l’un des éléments suivants : GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.
datain: Pointeur vers l’image source.
widthout: Largeur de l’image de destination.
heightout: Hauteur de l’image de destination.
typeout: Type de données pour dataout. Doit être l’un des éléments suivants : GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.
dataout: Pointeur vers l’image de destination.

Valeur retournée

Si la fonction aboutit, la valeur de retour est égale à zéro.

Si la fonction échoue, la valeur de retour est un code d’erreur GLU (voir gluErrorString).

Notes

La fonction gluScaleImage met à l’échelle une image de pixel à l’aide des modes de magasin de pixels appropriés pour décompresser les données de l’image source et emballer les données dans l’image de destination.

Lors de la réduction d’une image, gluScaleImage utilise un filtre de zone pour échantillonner l’image source et créer des pixels pour l’image de destination. Lorsque vous agrandissez une image, les pixels de l’image source sont interpolés de manière linéaire pour créer l’image de destination.

Pour obtenir une description des valeurs acceptables pour les paramètres de format, de typein et de typeout , consultez glReadPixels.

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
glReadPixels
gluBuild1DMipmaps
gluBuild2DMipmaps
gluErrorString

Partager via