gluScaleImage-Funktion

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 Quellbilds, das skaliert wird.

heightin

Die Höhe des Quellbilds, das skaliert wird.

typein

Der Datentyp für datain. Folgendes muss 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 Quellbild.

widthout

Die Breite des Zielbilds.

heightout

Die Höhe des Zielbilds.

Typeout

Der Datentyp für dataout. Folgendes muss 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 mithilfe der entsprechenden Pixelspeichermodi, um Daten aus dem Quellbild zu entpacken und Daten in das Zielbild zu packen.

Beim Verkleinern eines Bilds verwendet gluScaleImage einen Feldfilter, um das Quellbild zu beproben 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.

Requirements (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