@REQUIRE plugin$[, table]

Bitte beachten Sie, obwohl Hollywood alle Plugins beim Start automatisch geladen werden, viele Plugins den Aufruf von @REQUIRE benötigen, bevor sie verwendet werden können. Diese Plugins benötigen einen benutzerdefinierten Initialisierungscode, der nur ausgeführt wird, wenn Sie explizit @REQUIRE aufrufen. Zum Beispiel, Plugins die ein Display-Adaptermodul installieren, nicht aktiviert werden, es sei denn, Sie rufen @REQUIRE auf. Plugins, die nur für zusätzliche Dateiformate laden oder speichern, werden jedoch automatisch aktiviert, auch wenn Sie @REQUIRE nicht für diese aufrufen.

Dieser Präprozessor-Anweisung kann auch zum Laden von Plugins verwendet werden, die vom automatischen Laden beim Start ausgeschlossen wurden. Plugins können vom automatischen Laden ausgeschlossen werden, indem Sie dem Dateiname einen Unterstrich ('_') voranstellt oder Sie das Konsolenargument ‘-skipplugins’ verwenden. Wenn Sie ein Plugin laden möchten, das vom automatischen Laden übersprungen wurde, rufen Sie einfach @REQUIRE in Ihrem Skript auf und es wird vom Präprozessor geladen. Alternativ können Sie diese Plugins auch mit dem Befehl LoadPlugin() laden.

Ab Hollywood 6.0 akzeptiert diese Präprozessor-Anweisung ein optionales Tabellenargument table, mit dem Sie zusätzliche Parameter an die Initialisierungsroutine des Plugins übergeben können. Die hier akzeptierten Parameter variieren von Plugin zu Plugin. Bitte benutzen Sie die Dokumentation des Plugins, um herauszufinden, ob es zusätzliche Parameter akzeptiert, die an @REQUIRE übergeben werden können. Die folgenden beiden Parameter werden für jedes Plugin unterstützt:

Version:

Minimale Plugin-Version erforderlich. Hollywood scheitert, wenn das installierte Plugin nicht mindestens diese Versionsnummer hat. Die Voreinstellung ist 0, was bedeutet, dass jede Version funktioniert (V6.0)

Revision:

Minimale Plugin-Revision erforderlich. Hollywood scheitert, wenn das installierte Plugin nicht mindestens diese Revisionsnummer hat. Die Voreinstellung ist 0, was bedeutet, dass jede Revision funktioniert. (V6.0)

Link:

Wenn dieses Feld auf True gesetzt ist, wird das angegebene Plugin bei der Kompilierung Ihres Skripts in Ihre ausführbare Datei eingebunden. Dies funktioniert nur, wenn Sie die Plugin-Linker-Infrastruktur korrekt eingerichtet haben. Siehe Einbinden von Plugins für Details. Achten Sie darauf, die Lizenzen aller Plugins sorgfältig zu lesen, die Sie in Ihre ausführbaren Datei einbinden, weil Lizenzen wie LGPL Ihr Projekt beeinflussen, wenn Sie sich statisch mit LGPL-Software verknüpfen. Dieses Feld ist standardmäßig auf False gesetzt, was bedeutet, dass das Plugin nicht eingebunden wird. (V7.0)

Bitte beachten Sie, dass Sie keinen absoluten Pfad im plugin$ angeben müssen. Geben Sie einfach den Namen des Plugins an.

Siehe Plugins für mehr Informationen über Plugins.

plugin$

Name des benötigten Plugins

table

optional: Tabelle, die weitere Optionen enthält, die an das Plugin übergeben werden sollen (V6.0)

@REQUIRE "xml"

@REQUIRE "myplugin", {Version = 2, Revision = 1, User = "John"}