SaveBrush(id, f$[, t])

SaveBrush(id, f$[, transcolor, fmt, table])

SaveBrush() unterstützt mehrere optionale Argumente. Vor Hollywood 9.0 mussten diese als optionale Parameter übergeben werden (siehe oben). Seit Hollywood 9.0 wird jedoch empfohlen, die neue Syntax zu verwenden, die ein einzelnes optionales Tabellenargument hat, mit dem ein oder mehrere optionale Argumente an SaveBrush() übergeben werden können.

Die folgenden Tabellenfelder werden von diesem Befehl erkannt:

Format:

Setzen Sie diesen Tag auf das Bildformat, das verwendet werden soll. 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 SaveBrush() 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 Palettenpinsel 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)

Voreingestellt ist #IMGFMT_BMP.

Dither:

Wenn Sie diesen Tag auf True setzen, wird Dithering angewendet. Dieser Tag wird nur verarbeitet, wenn das Zielformat Paletten unterstützt und die Quelldaten sind im RGB-Format. Der Standardwert ist False, was kein Dithering bedeutet.

Depth:

Gibt die gewünschte Bildfarbtiefe an. Dies wird nur berücksichtigt, wenn das Format palettenbasiert ist und die Quelldaten im RGB-Format vorliegen. 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 angeben, wie viele Farben das Bild verwenden soll. Auch dies wird nur berücksichtigt, wenn das Format palettenbasiert ist und die Quelldaten im RGB-Format vorliegen. 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 Qualität, 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 bedeutet.

FillColor:

Beim Speichern eines RGB-Bildes mit transparenten Pixeln können Sie hier eine RGB-Farbe angeben, die in alle transparenten Pixel geschrieben werden soll. Dies ist wahrscheinlich von wenig praktischem Nutzen. Der Standardwert ist #NOCOLOR, was bedeutet, dass transparente Pixel so belassen werden, wie sie sind. (V9.0)

Adapter:

Mit diesem Tag können Sie einen oder mehrere Dateiadapter angeben, die überprüfen werden, ob sie die angegebene Datei speichern können. Wenn Sie diesen Tag verwenden, müssen Sie ihn auf eine Zeichenkette setzen, die den Namen eines oder mehrerer Adapter enthält. Standardmäßig wird der mit SetDefaultAdapter() eingestellte Adapter verwendet. Siehe Lade- und Adaptermodule für Details. (V10.0)

UserTags:

Dieser Tag kann verwendet werden, um zusätzliche Daten anzugeben, die an den 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 der Felder über die unterstützten Formate:

Siehe auch @BRUSH, LoadBrush(), CopyBrush(), FreeBrush() und MoveBrush().

id

ID des Pinsels, der gespeichert werden soll

f$

Dateiname

t

optional: Tabelle mit weiteren Optionen (siehe oben) (V9.0)

SaveBrush(1, "test.jpg", {Format = #IMGFMT_JPEG, Quality = 80})