Name
GetScript -- convert custom file to Hollywood script (V5.0)
Synopsis
STRPTR buf = GetScript(STRPTR file);
Function
This function must examine the file that is passed to this function and if it is in a format that the plugin can handle, it must convert the file to a Hollywood script and return this script as a null-terminated string. Hollywood will then skip loading this file and it will run the script that it has received from GetScript() instead.

If GetScript() does not want to handle the file it is passed, it must return NULL.

For compatibility reasons, the returned script is expected to be in ISO 8859-1 encoding. You can change this by including the magic phrase ::utf8 in the very first 5 bytes that your GetScript() implementation returns. In that case, Hollywood will assume UTF-8 encoding for your script.

Inputs
file
path to a file that the user wants Hollywood to run
Results
buf
null-terminated string containing a Hollywood script or NULL

Show TOC