@APPICON table
@APPICON f$     (V8.0)

Ab Hollywood 8.0 gibt es zwei verschiedene Möglichkeiten, diese Präprozessor-Anweisung zu verwenden: Sie können entweder einzelne Bilder für die verschiedenen Piktogrammgrößen in einer Tabelle angeben (siehe unten) oder Sie können einfach ein Hollywood-Piktogramm dieser Präprozessor-Anweisung übergeben, welches mit dem Befehl SaveIcon() erstellt wurde. In diesem Fall muss das Piktogramm im Parameter f$ übergeben werden. Die Angabe eines einzelnen Piktogramme anstelle einer ganzen Tabelle führt zu Code, der besser lesbar ist, aber natürlich erfordert es, dass Sie das Piktogramm zuerst mit dem Befehl SaveIcon() erzeugen.

Wenn Sie einzelne Bilder für die verschiedenen Piktogrammgrößen übergeben wollen, müssen Sie dieser Präprozessor-Anweisung eine Tabelle im Argument table übergeben. Die Tabelle kann eines oder mehrere der folgenden Tags enthalten:

Ic16x16:

Benutzerdefiniertes Piktogramm in der Auflösung von 16x16 Pixel.

Ic16x16s:

Ausgewähltes Zustandspiktogramm in der Größe 16x16. (V6.0)

Ic24x24:

Benutzerdefiniertes Piktogramm in der Auflösung von 24x24 Pixel.

Ic24x24s:

Ausgewähltes Zustandspiktogramm in der Größe 24x24. (V6.0)

Ic32x32:

Benutzerdefiniertes Piktogramm in der Auflösung von 32x32 Pixel.

Ic32x32s:

Ausgewähltes Zustandspiktogramm in der Größe 32x32. (V6.0)

Ic48x48:

Benutzerdefiniertes Piktogramm in der Auflösung von 48x48 Pixel.

Ic48x48s:

Ausgewähltes Zustandspiktogramm in der Größe 48x48. (V6.0)

Ic64x64:

Benutzerdefiniertes Piktogramm in der Auflösung von 64x64 Pixel.

Ic64x64s:

Ausgewähltes Zustandspiktogramm in der Größe 64x64. (V6.0)

Ic96x96:

Benutzerdefiniertes Piktogramm in der Auflösung von 96x96 Pixel.

Ic96x96s:

Ausgewähltes Zustandspiktogramm in der Größe 96x96. (V6.0)

Ic128x128:

Benutzerdefiniertes Piktogramm in der Auflösung von 128x128 Pixel.

Ic128x128s:

Ausgewähltes Zustandspiktogramm in der Größe 128x128. (V6.0)

Ic256x256:

Benutzerdefiniertes Piktogramm in der Auflösung von 256x256 Pixel.

Ic256x256s:

Ausgewähltes Zustandspiktogramm in der Größe 256x256. (V6.0)

Ic512x512:

Benutzerdefiniertes Piktogramm in der Auflösung von 512x512 Pixel.

Ic512x512s:

Ausgewähltes Zustandspiktogramm in der Größe 512x512. (V6.0)

Ic1024x1024:

Benutzerdefiniertes Piktogramm in der Auflösung von 1024x1024 Pixel. (V7.0)

Ic1024x1024s:

Ausgewähltes Zustandspiktogramm in der Größe 1024x1024. (V7.0)

DefaultIcon:

Mit diesem Tag können Sie angeben, welches Piktogramm das Standardpiktogramm sein soll. Sie müssen eine Zeichenfolge übergeben, die eine Piktogrammgröße aus den oben aufgeführten Größen beschreibt, z.B. "64x64" kennzeichnet das in dem Tag Ic64x64 als das Standardpiktogramm. Das Standardpiktogramm ist das Piktogramm, welches Hollywood in AmiDock auf AmigaOS 4 anzeigen wird, wenn der Tag RegisterApplication in @OPTIONS auf True gesetzt ist. So hat derzeit der Tag DefaultIcon nur eine Wirkung unter AmigaOS 4. (V6.0)

Der Grund, warum diese Präprozessor-Anweisung nicht einfach nur ein einziges 512x512-Piktogramm akzeptiert und es dann auf alle anderen Auflösungen skaliert, ist, dass sehr kleine Piktogramme wie 16x16 oder 24x24 nicht wirklich gut aussehen, wenn sie von einem größeren Piktogramm aus verkleinert werden. Sie sehen viel besser aus, wenn Sie für jede Größe handgefertigt werden. Deshalb akzeptiert diese Präprozessor-Anweisung so viele verschiedene Tags.

Bitte beachten Sie, dass derzeit nicht alle Größen auf allen Plattformen unterstützt werden. Trotzdem sollten Sie sicherstellen, für alle Größen Piktogramme bereitzustellen. Wenn Sie eine Größe auslassen, könnte Hollywood für diese oder gar alle Größen auf das Standard-Piktogramm (Filmklappe) zurück greifen. Also, wenn Sie beabsichtigen, Ihre eigenen Piktogramme zu verwenden, stellen Sie sicher, dass Sie immer in allen oben aufgeführten Größen verfügbar sind.

Die Bilddatei, die als Parameter von den oben aufgeführten Tags benötigt wird, sollte ein PNG-Bild mit Alphakanal sein. Bilder ohne Alphakanal werden auch unterstützt, aber wird nicht empfohlen, weil sie nicht gut aussehen.

Bitte beachten Sie, dass wenn Sie unter AmigaOS 4 ein Piktogramm im AmiDock verwenden möchten, müssen Sie mit dem Tag DefaultIcon die Größe des Piktogramme angeben. Wenn Sie den Tag DefaultIcon nicht übergeben, wird Hollywood sein Standard-Piktogramm im AmiDock anzeigen (die Filmklappe). Wenn Sie ein Piktogramm im AmiDock anzeigen möchten, welches eine nicht aufgeführte benutzerdefinierte Größe verwendet, können Sie den Tag DockyBrush von der Präprozessor-Anweisung @OPTIONS verwenden. Siehe OPTIONS für Details. Bitte beachten Sie, dass Hollywood zwei verschiedene Docky-Typen unter AmigaOS 4 unterstützt: Standard-Dockies und App-Dockies. Siehe Informationen über AmiDock für mehr Infos über die Unterschiede der beiden Dockies.

Ab Hollywood 6.0 können Sie für jede Piktogrammgröße zwei Bilder angeben, da auf AmigaOS und kompatiblen Plattformen Piktogramme in der Regel zwei verschiedene Zustände enthalten, während auf allen anderen Systemen Piktogramme nur einzelne statische Bilder haben. Wenn nur Nicht-Amiga-Systeme Ihr Ziel sind, müssen Sie keine Piktogramme für den ausgewählten Status bereitstellen, da sie ohnehin nicht verwendet werden.

Alternativ können Sie anstatt @APPICON auch eine der Konsolenargumente -iconXXX verwenden.

Beachten Sie, dass diese Präprozessor-Anweisung derzeit keine Auswirkungen auf Amiga-Systeme hat. Wenn Sie das Piktogramm ändern möchten, das Hollywood anzeigt, wenn es auf der Workbench minimiert wird, verwenden Sie den Befehl SetWBIcon().

Siehe auch @APPAUTHOR, @APPCOPYRIGHT, @APPDESCRIPTION, @APPIDENTIFIER, @APPTITLE, und APPVERSION.

f$

Name eines Hollywood-Piktogramme ODER

table

eine Tabelle mit einem oder mehreren der unterstützten Tags (siehe oben)

@APPICON "icon.png"

@APPICON {Ic16x16 = "my16x16icon.png",
Ic24x24 = "my24x24icon.png",
Ic32x32 = "my32x32icon.png",
Ic48x48 = "my48x48icon.png",
Ic64x64 = "my64x64icon.png",
Ic96x96 = "my96x96icon.png",
Ic128x128 = "my128x128icon.png",
Ic256x256 = "my256x256icon.png",
Ic512x512 = "my512x512icon.png",
Ic1024x1024 = "my1024x1024icon.png"}