SaveImage()

Syntax

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

Speichert das angegebene Bild '#Image' in die angegebene Datei 'DateiName$'. Standardmäßig wird das Bild im BMP-Format gespeichert. Wenn die Funktion fehlschlägt, wird 0 zurückgegeben, andernfalls ist alles in Ordnung.

'ImagePlugin' ist ein optionaler Parameter und kann eine der folgenden Konstanten sein:

  #PB_ImagePlugin_BMP      : Speichert das Bild als BMP.
  #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' ist ein optionaler Parameter abhängig vom verwendeten 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).

'Tiefe' ist ein optionaler Parameter, um die Tiefe festzulegen, welche beim Speichern des Bildes verwendet wird. Gültige Werte sind 1, 4, 8, 24 und 32. Der Standard-Wert ist die originale Bild-Tiefe. Wenn ein Bild mit einer Farbpaletten-Tiefe (englisch "palettized depth" - 1, 4 bzw. 8) gespeichert wird, dann ist der folgende Flag verfügbar:

  #PB_Image_FloydSteinberg: wendet ein Floyd-Steinberg Dithering an

Derzeit unterstützen nur BMP- und PNG-Kodierer das Bildformat mit Farbpaletten-Tiefe (1, 4 bzw. 8 Bit).

Unterstützte OS

Alle