[id] = LoadIcon(id, filename$[, table])

In Hollywood ist ein Piktogramm eine Sammlung desselben Bildes in verschiedenen Größen. Durch die Verwendung individuell entworfener Bilder für jede Größe, anstatt nur ein und dasselbe Bild für jede Größe zu skalieren, wird eine bessere Qualität erzielt. Dies trifft insbesondere bei kleineren Bildgrößen zu, die viel besser aussehen, wenn sie speziell für ihre Auflösung ausgelegt sind. Darüber hinaus kann jedes Bild innerhalb eines Piktogrammsatzes zwei verschiedene Status haben: Normal und Ausgewählt. Normalerweise benötigen Sie immer nur den normalen Status, aber bei AmigaOS und kompatiblen Systemen wird manchmal auch der ausgewählte Status verwendet. Typische Größen für die einzelnen Bilder innerhalb eines Piktogrammes sind 16x16, 24x24, 32x32, 48x48, 64x64, 96x96, 128x128, 256x256 und 512x512. Sie können jedoch auch völlig willkürlich sein. Der Vorteil, dass ein Bild in verschiedenen Größen in einem Piktogramm angezeigt wird, besteht darin, dass Hollywood in Abhängigkeit von der Bildschirmauflösung eine geeignete Größe auswählen kann.

Das in filename$ übergebene Piktogramm muss das benutzerdefinierten PNG-Piktogrammformat von Hollywood vorliegen. Sie können SaveIcon() verwenden, um solche Piktogramme zu erstellen. Obwohl Hollywood-Piktogramme normale PNG-Bilder sind, enthalten sie zusätzliche Metadaten. Aus diesem Grund dürfen Sie sie nicht mit Ihrem bevorzugten Bildbearbeitungswerkzeug bearbeiten, da dies zum Verlust der Metadaten führen kann. Hollywood-Piktogramme sollten immer nur mit dem Befehl SaveIcon() erstellt werden.

Wenn Sie das benutzerdefinierte Piktogrammformat von Hollywood nicht verwenden möchten, können Sie auch Piktogramme aus Pinseln oder normalen Bildern mit dem Befehl CreateIcon() oder dem Präprozessor-Anweisung @ICON erstellen. Diese Befehle haben auch den Vorteil, dass Sie Vektorpinsel verwenden können, die verlustfrei auf jede Größe skaliert werden können, was zu einem absolut gestochen scharfen Aussehen in allen möglichen unterschiedlichen Auflösungen führt.

Das dritte Argument ist optional. In dieser Tabelle können Sie weitere Optionen für den Ladevorgang festlegen. Die folgenden Felder der Tabelle können verwendet werden:

Loader:

Mit diesem Tag können Sie ein oder mehrere Formatlademodule angeben, die zum Laden dieses Piktogrammes benutzt werden sollen. Dies muss als eine Zeichenkette festgelegt werden, die den Namen eines oder mehrerer Formatlademodulen enthält. Standardmäßig wird der mit SetDefaultLoader() eingestellte Lader verwendet. Siehe Lade- und Adaptermodule für Details.

Adapter:

Mit diesem Tag können Sie einen oder mehrere Dateiadapter angeben, die zum Öffnen 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.

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)

Dieser Befehl ist auch als Präprozessor-Anweisung verfügbar: Verwenden Sie @ICON, um die Piktogramme vorab zu laden.

id

ID des Piktogrammes oder Nil für die automatische ID-Zuweisung

filename$

zu ladende Datei

table

optional: weitere Optionen (siehe oben)

id

optional: Identifikator des Piktogrammes; wird nur zurückgegeben werden, wenn Sie Nil als Argument 1 angegeben haben (siehe oben)

LoadIcon(1, "test.png")