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 verfügbar: 
  #PB_Image_FloydSteinberg: wendet ein Floyd-Steinberg Dithering an
Wenn ein 32-Bit-Bild in einer geringeren Tiefe (24 Bit oder weniger) gespeichert wird, stehen die folgenden Flags zur Verfügung, um die Farbe zu ändern, mit der der transparente Bereich gefüllt wird: 
  #PB_Image_WhiteAlphaBackground: das resultierende Bild verwendet die Farbe Weiß, wenn ein transparenter Bereich gefunden wird (Standard)
  #PB_Image_BlackAlphaBackground: das resultierende Bild verwendet die Farbe Schwarz, wenn ein transparenter Bereich gefunden wird
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.

Beispiel

  UsePNGImageEncoder()
  
  If CreateImage(0, 33, 33)
    If StartDrawing(ImageOutput(0))
      DrawingMode(#PB_2DDrawing_Transparent)
        Box(0, 0, 33, 33, $FF0000) ; zeichnet eine blaue Box und speichert diese nachfolgend als PNG-Bilddatei
      StopDrawing()
    EndIf
    file$ = SaveFileRequester("Select file to save", GetCurrentDirectory(), "*.png|*.png", 0)
    If file$
      If GetExtensionPart(file$) = ""
        file$ + ".png"  ; Dateiendung hinzufügen wenn nötig
      EndIf
      If SaveImage(0, file$, #PB_ImagePlugin_PNG)
        MessageRequester("File created", file$)
      Else
        MessageRequester("Error", "Failed to save file")
      EndIf
    EndIf
    FreeImage(0)
  EndIf

Siehe auch

ImageDepth(), ImagePlugin Bibliothek

Unterstützte OS

Alle

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