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_JPEG2000 : Speichert das Bild als JPEG2000 (der Befehl UseJPEGImage2000Encoder() 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).

Unterstützte OS

Alle