16.1 AmiDock information

Hollywood has native support for AmigaOS 4's AmiDock system. You can make your script appear in AmiDock by setting the RegisterApplication tag in the @OPTIONS preprocessor command to True. See OPTIONS for details.

By default, Hollywood will show the icon obtained from the script's or application's *.info file in AmiDock. If you want Hollywood to show a custom icon in AmiDock, you can do so by specifying a number of icons using the @APPICON preprocessor command and then you have to tell Hollywood which icon to show by setting the DefaultIcon tag. See APPICON for details. Alternatively, you can use the DockyBrush tag with the @OPTIONS preprocessor command.

There are two different types of dockies that Hollywood supports:

1. Standard docky: This is the default docky type. Your application will appear in AmiDock as an icon that has two different states. The icon's second state will be shown every time the user clicks on it. Standard dockies have the disadvantage that they cannot have a context menu associated with them and it also takes a lot of time to change the standard docky icon at runtime using ChangeApplicationIcon(). There will be a clearly noticeable relayout if you change the icon of a standard docky. If you do not need a context menu and you never need to update your docky icon, however, standard dockies are the best choice.

2. App docky: App dockies are more flexible than standard dockies as they can have a context menu associated with them and it is also possible to change their icons really quickly using ChangeApplicationIcon(). This makes it possible to show animations in AmiDock, for example. The downside of app dockies is that app docky icons can only have a single state, i.e. it is impossible to associate a second icon that is to be shown whenever the user clicks on the docky with app dockies.

By default, Hollywood will create a standard docky for you. App dockies are only created if you attach a context menu to your docky by specifying the DockyContextMenu tag in @OPTIONS or if you call ChangeApplicationIcon() and pass only one instead of two images to the function. An alternative way to make your application start up as an app docky is to use the DockyBrush tag with the @OPTIONS preprocessor command.

If you want to have your script registered as an OS4 application without an icon in AmiDock, you will have to set the NoDocky tag to True with the @OPTIONS preprocessor command.