gluScaleImage-Funktion

Artikel
06/13/2023

Die gluScaleImage-Funktion skaliert ein Bild auf eine beliebige Größe.

Syntax

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

Parameter

format: Das Format der Pixeldaten. Die folgenden symbolischen Werte sind gültig: 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 und GL_LUMINANCE_ALPHA.
widthin: Die Breite des Quellimages, das skaliert wird.
höhein: Die Höhe des Quellimages, das skaliert wird.
typein: Der Datentyp für datain. Muss eine der folgenden Sein: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT oder GL_FLOAT.
datain: Ein Zeiger auf das Quellimage.
widthout: Die Breite des Zielbilds.
heightout: Die Höhe des Zielimages.
typeout: Der Datentyp für dataout. Muss eine der folgenden Sein: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT oder GL_FLOAT.
dataout: Ein Zeiger auf das Zielimage.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein GLU-Fehlercode (siehe gluErrorString).

Bemerkungen

Die gluScaleImage-Funktion skaliert ein Pixelbild mit den entsprechenden Pixelspeichermodi, um Daten aus dem Quellbild zu entpacken und Daten in das Zielbild zu packen.

Beim Verkleinern eines Bilds verwendet gluScaleImage einen Boxfilter, um das Quellbild zu beispielen und Pixel für das Zielbild zu erstellen. Beim Vergrößern eines Bilds werden die Pixel aus dem Quellbild linear interpoliert, um das Zielbild zu erstellen.

Eine Beschreibung der zulässigen Werte für die Parameter format, typein und typeout finden Sie unter glReadPixels.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Glu.h
Bibliothek	Glu32.lib
DLL	Glu32.dll

Weitere Informationen

glDrawPixels
glReadPixels
gluBuild1DMipmaps
gluBuild2DMipmaps
gluErrorString

Freigeben über