SaveSprite()

Syntax

Ergebnis = SaveSprite(#Sprite, DateiName$ [, ImagePlugin [, Flags]])

Speichert das angegebene '#Sprite' auf Disk. Standardmäßig wird es im 24Bit BMP-Format gespeichert. Sehr nützlich für "Screenshots" (Schnappschüsse vom Bildschirminhalt) in Zusammenspiel mit dem GrabSprite() Befehl.

Ist das 'Ergebnis' gleich 0, dann konnte das Sprite nicht gespeichert werden (Disk voll, ungültiger Dateiname, etc.).

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

  #PB_ImagePlugin_BMP  : Speichert das Bild als BMP. (Standard-Format)
  #PB_ImagePlugin_JPEG : Speichert das Bild als JPEG (der Befehl UseJPEGImageEncoder() 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 das JPEG Plugin unterstützt dies derzeit (standardmäßig ist die Qualität auf '7' festgelegt, wenn beim JPEG-Encoder keine Flags angegeben wurden).

Unterstützte OS

Windows, Linux, MacOS X