Name
LoadPlugin -- load a plugin at runtime (V6.0)
Synopsis
LoadPlugin(name$[, table])
Function
This function can be used to load and initialize the specified plugin at runtime. LoadPlugin() does basically the same as @REQUIRE but can be called while your script is already running while @REQUIRE is executed by the preprocessor. As LoadPlugin() is a runtime function you cannot load certain plugins which require lowlevel initialization from this function, e.g. it is not possible to runtime-load plugins which install display adapters because Hollywood has already setup its inbuilt display driver by then. Runtime loading plugins which just install loaders or savers of additional file formats works fine, though.

LoadPlugin() accepts an optional table argument which can contain the following tags:

Version:
Minimum plugin version required. Hollywood will fail if the installed plugin does not have at least this version number. This defaults to 0 which means that any version will do.

Revision:
Minimum plugin revision required. Hollywood will fail if the installed plugin does not have at least this revision number. This defaults to 0 which means that any revision will do.

SkipRequire:
Set this tag to True if you want Hollywood to skip calling the plugin's require initialization code. This is only useful for some advanced debugging purposes and should normally not be touched. Defaults to False.

Additionally, the optional table argument can contain an unlimited number of additional tags to be passed directly to the plugin's initialization routine exactly in the same way as done by the @REQUIRE preprocessor command. The additional argument acceptable here depend on the respective plugin. Please consult the documentation of the plugin to find out if it accepts any additional parameters that can be passed here.

See REQUIRE for details.

Inputs
name$
plugin to load
table
optional: table containing further parameters (see above)
Show TOC