Bezeichnung
SaveIcon -- speichert ein Piktogramm in einer Datei (V8.0)
Übersicht
SaveIcon(id, f$[, fmt, t])
Beschreibung
Dieser Befehl speichert das durch id angegebene Piktogramm in der durch f$ angegebenen Datei. Standardmäßig wird das Piktogramm in Hollywoods benutzerdefiniertem Piktogrammformat gespeichert, das auf PNG basiert. Sie können dies ändern, indem Sie eine andere Piktogrammformatkonstante im Argument fmt übergeben. Das einzige von Hollywood intern unterstützte Piktogrammformat ist #ICNFMT_HOLLYWOOD, welches auf PNG basiert. Zusätzliche Piktogrammformate können durch Hollywood-Plugins verfügbar gemacht werden.

Beachten Sie, dass Hollywoods benutzerdefiniertes Piktogrammformat zwar Piktogramme als scheinbar normale PNG-Bilder speichert, aber zusätzliche Metadaten enthält, weshalb Sie sie nicht mit Ihrem bevorzugten Bildbearbeitungsprogramm bearbeiten sollten, da dies zum Verlust dieser Metadaten führen könnte. Hollywood-Piktogramme sollten immer nur mit dem Befehl SaveIcon() erstellt werden.

Beachten Sie auch, dass bei Verwendung des benutzerdefinierten Piktogrammformats von Hollywood das in id angegebene Piktogramm keine Vektorgrafiken enthalten darf. Hollywood-Piktogramme unterstützen nur Rastergrafiken, da sie auf PNG basieren. Wenn Sie Vektorgrafiken in einem Piktogramm verwenden möchten, können Sie solche Piktogramme mit dem Befehl CreateIcon() und der Präprozessor-Anweisung @ICON erstellen.

Schließlich dürfen Piktogramme in Hollywoods eigenem Piktogramm-Format auch keine Palettengrafiken enthalten. Aus diesem Grund schlägt SaveIcon() fehl, wenn das durch id angegebene Piktogramm Palettenbilder enthält.

Ab Hollywood 9.0 akzeptiert SaveIcon() ein optionales Tabellenargument, das die folgenden Optionen enthalten kann:

Compression:
Bei Piktogrammformaten, die Komprimierung unterstützen, können Sie diesen Tag auf True oder False setzen, um die Komprimierung zu aktivieren oder zu deaktivieren. Voreingestellt ist True. (V9.0)

Adapter:
Mit diesem Tag können Sie einen oder mehrere Dateiadapter angeben, die zum Speichern der angegebenen Datei benutzt werden sollen. Dies muss auf eine Zeichenkette gesetzt werden, 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 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)

Eingaben
id
Identifikator des zu speichernden Piktogrammes
f$
Zieldatei
fmt
optional: gewünschtes Piktogrammformat (Voreingestellt ist #ICNFMT_HOLLYWOOD) (V9.0)
t
optional: Tabelle mit weiteren Argumenten (V9.0)
Navigation zeigen