1.1 Introduction

Welcome to the Hollywood Software Development Kit (SDK). This package contains all the necessary information and files to write your own Hollywood plugins. Plugins can greatly enhance Hollywood's functionality. They can provide load and save support for additional video, audio, image, icon, and sample formats, they can extend the command set of the Hollywood language as well as enable Hollywood to use real vector graphics and it is even possible to write plugins which replace core parts of Hollywood like its inbuilt display and audio driver with custom implementations provided by plugins. It is also possible to write plugins which convert project files of other applications like Scala or PowerPoint into Hollywood scripts so that Hollywood can run these project files directly although they are not in the *.hws format.

Hollywood plugins use the file extension *.hwp. The location where Hollywood plugins must be installed differs from platform to platform. Here is a breakdown of the different search paths that Hollywood will scan for plugins:

• – AmigaOS and compatibles: Plugins can either be stored in a directory named Plugins that is in the same directory as the Hollywood interpreter or they can be installed globally in LIBS:Hollywood. Hollywood will first look for plugins in the Plugins directory in its program directory, then it will scan LIBS:Hollywood.

• – Android: The Android version of Hollywood also supports Hollywood plugins. You have to copy them to the directory Hollywood/Plugins on your SD card. Hollywood will scan this location on every startup and load all plugins from there.

• – Linux: Plugins must be stored in a directory named Plugins (case sensitive!) that is in the same directory as the Hollywood interpreter.

• – macOS: ~/Library/Application Support/AirsoftSoftwair/Hollywood/Plugins is the directory that should be used for storing plugins. If it doesn't exist, just create it. Alternatively, you can also store plugins inside Hollywood's app bundle in Hollywood.app/Contents/Resources/Plugins but this isn't recommended because it requires you to modify the Hollywood distribution and it might also require administrator privileges.

• – Windows: C:\Users\...\AppData\Local\AirsoftSoftwair\Hollywood\Plugins is the directory that should be used for storing plugins. If it doesn't exist, just create it. Alternatively, you can also store plugins in the Plugins directory in Hollywood's installation directory, e.g. in C:\Program Files\Hollywood\Plugins but this isn't recommended because it requires you to modify the Hollywood distribution and it might also require administrator privileges to write to Hollywood's installation directory.

When distributing a compiled Hollywood program, plugins required by your program must simply be put into the same directory as your program. The only exception is when compiling application bundles for macOS: In the case of macOS app bundles, plugins need to be put into the Resources directory of the application bundle, i.e. in MyProject.app/Contents/Resources.