SaveSnapshot(f$[, mode, fmt, table])

#SNAPWINDOW:

Erfasst das komplette Hollywood-Display, d.h. mit Fensterrahmen. Dies ist die Standardeinstellung.

#SNAPDISPLAY:

Erfasst nur den Inhalt des Displays, d.h. ohne Fensterrahmen.

#SNAPDESKTOP:

Erfasst den gesamten Host-Bildschirm.

Beachten Sie, dass Sie #SNAPDISPLAY verwenden müssen, wenn das Display im Palettenmodus ist und Sie möchten, dass die Bilddatei ebenfalls palettenbasiert ist, da dies der einzige Fangmodus ist, der außer dem Inhalt des Displays keine anderen Grafiken enthält.

Das Argument fmt gibt das gewünschte Ausgabebildformat an. Dies kann entweder eine der folgenden Konstanten oder ein von einem Plugin bereitgestelltes Bildformat sein:

#IMGFMT_BMP:

Windows-Bitmap. Hollywood unterstützt beim BMP-Format RGB- und Palettenbilder. #IMGFMT_BMP ist das von SaveSnapshot() verwendete Standardformat.

#IMGFMT_PNG:

PNG-Format. Hollywood unterstützt beim PNG-Format RGB- und Palettenbilder. RGB-Bilder können auch einen Alphakanal und Palettenbilder können einen transparenten Stift haben. (V2.5)

#IMGFMT_JPEG:

JPEG-Format. Beachten Sie, dass das JPEG-Format keine Alphakanäle oder palettenbasierte Grafiken unterstützt. Im Feld Qualität (siehe unten) können Sie die Qualitätsstufe für das JPEG-Bild festlegen (gültige Werte sind 0 bis 100, wobei 100 die beste Qualität ist). (V4.0)

#IMGFMT_GIF:

GIF-Format. Da GIF-Bilder immer palettenbasiert sind, müssen RGB-Grafiken quantisiert werden, bevor sie als GIF exportiert werden können. Sie können die Tags Colors und Dither (siehe unten) verwenden, um entweder die Farbtiefe oder die Anzahl Farben in der Palette festzulegen, die dem Bild zugewiesen werden sollen und ob Dithering angewendet werden soll oder nicht. Wenn #IMGFMT_GIF mit einem Palettenmodus-Display verwendet wird, erfolgt keine Quantisierung. #IMGFMT_GIF unterstützt auch Palettenbilder mit einem transparenten Stift. (V4.5)

#IMGFMT_ILBM:

IFF-ILBM-Format. Hollywood unterstützt beim IFF-ILBM-Format RGB- und Palettenbilder. Palettenbilder können auch einen transparenten Stift haben, allerdings werden Alphakanäle für dieses Ausgabeformat nicht unterstützt. (V4.5)

Mit der optionalen Tabelle table können Sie weitere Parameter konfigurieren:

Dither:

Um Dithering zu aktivieren, setzen Sie dies auf True. Dieser Tag wird nur berücksichtigt, wenn das Zielformat palettenbasiert ist und die Quelldaten RGB sind. Der Standardwert ist False, was bedeutet, dass kein Dithering erfolgt.

Depth:

Gibt die gewünschte Farbtiefe des Bildes an. Dies wird nur berücksichtigt, wenn das Format palettenbasiert ist und die Quelldaten RGB sind. Gültige Werte liegen zwischen 1 (= 2 Farben) und 8 (= 256 Farben). Die Voreinstellung ist 8. (V9.0)

Colors:

Dies ist eine Alternative zum Tag Depth. Anstelle einer Bittiefe können Sie hier die Anzahl Farben für das Bild angeben. Auch dies wird nur für palettenbasierte Formate berücksichtigt, wenn die Quelldaten RGB sind. Gültige Werte liegen zwischen 1 und 256. Die Voreinstellung ist 256.

Quality:

Hier können Sie einen Wert zwischen 0 und 100 für die Komprimierungsqualität bei verlustbehafteten Kompressionsformate angeben. Ein Wert von 100 bedeutet beste, 0 hingegen schlechteste Qualität. Dies wird nur bei Bildformaten berücksichtigt, die verlustbehaftete Kompression unterstützen. Der Standardwert ist 90, welcher eine ziemlich gute Qualität liefert.

Adapter:

Mit diesem Tag können Sie ein oder mehrere Dateiadapter angeben, die die angegebene Datei speichern sollen. Dies muss als eine Zeichenkette festgelegt werden, die den/die Namen eines oder mehreren Adaptermodulen enthält. Standardmäßig wird der Adapter verwendet, der mit SetDefaultAdapter() gesetzt wurde. Siehe Lade- und Adaptermodule für Details. (V10.0)

UserTags:

Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an Lader und Adapter übergeben werden sollen. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Tabelle mit Schlüssel-Wert-Paaren setzen, die die zusätzlichen Daten enthalten, die an Plugins übergeben werden sollen. Siehe Benutzer-Tags für Details. (V10.0)

Hier ist eine Übersicht, die zeigt, welche Formate welche Tags unterstützen:

Siehe auch GrabDesktop().

f$

Datei für den Schnappschuss

mode

optional: Bereich, der berücksichtigt wird (voreingestellt ist #SNAPWINDOW)

fmt

optional: Bildformat: #IMGFMT_BMP (2.0), #IMGFMT_PNG (V2.5), #IMGFMT_JPEG (V4.0), #IMGFMT_GIF oder #IMGFMT_ILBM (voreingestellt ist #IMGFMT_BMP)

table

optional: Tabelle für weitere Optionen (V4.5)

SaveSnapshot("Snap.bmp")