SaveImage

SaveImage()

Syntax

Ergebnis = SaveImage(#Image, Dateiname$ [, ImagePlugin [, Flags [, Tiefe]]])

Beschreibung

Speichert das angegebene Bild auf Disk.

Parameter

#Image Das zu speichernde Bild.

Dateiname$ Die Datei, in die gespeichert werden soll. Wenn der Dateiname keinen vollständigen Pfad beinhaltet, wird dieser relativ zum aktuellen Verzeichnis interpretiert.
ImagePlugin (optional)
Das Format, in welchem das Bild gespeichert werden soll. Dies kann einer der folgenden Werte sein:
  #PB_ImagePlugin_BMP      : Speichert das Bild als BMP (Standard)
  #PB_ImagePlugin_JPEG     : Speichert das Bild als JPEG (der Befehl UseJPEGImageEncoder() muss verwendet werden).
  #PB_ImagePlugin_JPEG2000 : Speichert das Bild als JPEG2000 (der Befehl UseJPEG2000ImageEncoder() muss verwendet werden).
  #PB_ImagePlugin_PNG      : Speichert das Bild als PNG  (der Befehl UsePNGImageEncoder() muss verwendet werden).
Flags (optional)
Optionale Parameter für das Image-Plugin. Zurzeit wird nur die Einstellung der Bildqualität unterstützt: ein Wert von 0 (schlechteste Qualität) bis 10 (maximale Qualität). Nur die JPEG und JPEG 2000 Plugins unterstützen dies derzeit (standardmäßig ist die Qualität auf '7' festgelegt, wenn keine Flags angegeben werden).

Wenn ein Bild mit einer Farbpaletten-Tiefe (englisch "palettized depth" - 1, 4 bzw. 8) gespeichert wird, dann ist der folgende Flag als Kombination verfügbar:
  #PB_Image_FloydSteinberg: wendet ein Floyd-Steinberg Dithering an
Tiefe (optional) Die Tiefe, in welcher das Bild gespeichert wird. Gültige Werte sind 1, 4, 8, 24 und 32. Der Standard-Wert ist die originale Bild-Tiefe.
Derzeit unterstützen nur BMP- und PNG-Kodierer das Bildformat mit Farbpaletten-Tiefe (1, 4 bzw. 8 Bit).

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn die Operation erfolgreich war, und Null bei einem Fehler.

Siehe auch

ImageDepth(), ImagePlugin Bibliothek

Unterstützte OS

Alle

<- ResizeImage() - Image Inhaltsverzeichnis - SetImageFrame() ->

#Image	Das zu speichernde Bild.
Dateiname$	Die Datei, in die gespeichert werden soll. Wenn der Dateiname keinen vollständigen Pfad beinhaltet, wird dieser relativ zum aktuellen Verzeichnis interpretiert.
ImagePlugin (optional)	Das Format, in welchem das Bild gespeichert werden soll. Dies kann einer der folgenden Werte sein: #PB_ImagePlugin_BMP : Speichert das Bild als BMP (Standard) #PB_ImagePlugin_JPEG : Speichert das Bild als JPEG (der Befehl UseJPEGImageEncoder() muss verwendet werden). #PB_ImagePlugin_JPEG2000 : Speichert das Bild als JPEG2000 (der Befehl UseJPEG2000ImageEncoder() muss verwendet werden). #PB_ImagePlugin_PNG : Speichert das Bild als PNG (der Befehl UsePNGImageEncoder() muss verwendet werden).
Flags (optional)	Optionale Parameter für das Image-Plugin. Zurzeit wird nur die Einstellung der Bildqualität unterstützt: ein Wert von 0 (schlechteste Qualität) bis 10 (maximale Qualität). Nur die JPEG und JPEG 2000 Plugins unterstützen dies derzeit (standardmäßig ist die Qualität auf '7' festgelegt, wenn keine Flags angegeben werden). Wenn ein Bild mit einer Farbpaletten-Tiefe (englisch "palettized depth" - 1, 4 bzw. 8) gespeichert wird, dann ist der folgende Flag als Kombination verfügbar: #PB_Image_FloydSteinberg: wendet ein Floyd-Steinberg Dithering an
Tiefe (optional)	Die Tiefe, in welcher das Bild gespeichert wird. Gültige Werte sind 1, 4, 8, 24 und 32. Der Standard-Wert ist die originale Bild-Tiefe. Derzeit unterstützen nur BMP- und PNG-Kodierer das Bildformat mit Farbpaletten-Tiefe (1, 4 bzw. 8 Bit).