30.1 Overview

DOSBase contains commands for working with files and directories. As Hollywood can deal with virtual files as well as with files linked into other files like applets or executables you must make sure that you only use IO functions provided by Hollywood in the DOSBase pointer to deal with files. If you use functions like fopen() from the ANSI C library instead, your plugin will only work with normal files that are physically existent on a system drive.

For example, when writing plugins that provide loaders for additional file formats like images, sounds, or videos it can often happen that the filename that is passed to your plugin is a specially formatted specification that Hollywood uses to load files that have been linked to applets or executables. If you do not use Hollywood's IO functions to open this file, your plugin won't be able to load files that have been linked to applets or executables. This can be quite annoying for the end-user because the ability to link data files into applets and executables is a key functionality of Hollywood and thus your plugin should strive to be compatible with it. If you use fopen() instead, it will just fail whenever your function is passed a specially formatted specification to open one of Hollywood's virtual files.

DOSBase is available since Hollywood 5.0.

Show TOC