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 |
|
| Bibliothek |
|
| DLL |
|