DDFCreator ProcCode
aus dem DMXControl-Wiki
Inhaltsverzeichnis |
Code und Initsequence im DDF eintragen
Überblick
Um komplexere Funktionen im DDF zu realisieren, besteht die Möglichkeit sog. Procedures zu programmieren, die beim Verändern eines DMX Kanals oder eines Steuerelementes aufgerufen werden. Eine Beschreibung der Programmiersprache finden Sie im DDF-Tutorial auf der Homepage. Um diese Procedures im Editor zu hinterlegen, gibt es das DDF Procedures Fenster. In diesem Fenster kann auch die Initsequence eingegeben werden. Öffnen Sie das Fenster über DDF-Eigenschaften -> DDF Procedures.
Auf der linken Seite sehen Sie eine Liste der vorhandenen Procedures. Mit Neu fügen Sie ein neues Procedure hinzu. Mit Löschen entfernen Sie ein vorhandenes. Auf der rechten Seite können Sie im Codefenster den Procedurecode eintragen, oder über Rechtsklick auf das Fenster aus der Codebibliothek holen. Wenn Sie Änderungen im Code vornehmen, werden diese zwischen gespeichert. Sie können also ein Procedure bearbeiten und dann ein anderes auswählen und dieses ändern. Erst wenn Sie auf OK drücken werden die Änderungen für alle Procedures ins DDF geschrieben. Genauso ist es mit der Initsequence. Sie können diese Manuell eintragen oder per Rechtsklick über die Bibliothek holen. Mehr über die Bibliothek in 6.2.
Die Codebibliothek
Ein sehr nützliches Feature in DDFCreator ist eine vorhandene leicht erweiterbare Codebibliothek. Diese ermöglicht es Sequences und Procedures auf Abruf schnell einzufügen, und sich so die Programmierung und Fehler zu vermeiden. Die Elemente aus der Bibliothek sind allgemeine Codebausteine, die auf jeden Fall noch an das entsprechende DDF angepasst werden müssen. Die Bibliothek enthält verschiedenen Procedures, die oft in ähnlicher Art und Weise verwendet werden, und von daher leicht anzupassen sind. Genauso ermöglicht es die Bibliothek eigenen Code einzuspeichern, um diesen zukünftig bei DDFs zu nutzen.
Die Codebibliothek aufrufen
Sie können die Codebibliothek von jedem Textfeld aus aufrufen, in das Sie eine Sequence oder ein Procedure einfügen können, indem Sie rechts auf das Feld klicken und dann im folgenden Kontextmenu auf Code aus der Bibliotek einfügen.
Eigene Bausteine einfügen
Die Bausteine werden in der Datei code.xcq im DDFCreator Verzeichnis gespeichert. Diese Datei kann von ihnen nach belieben geändert werden, um neue Codebausteine hinzuzufügen. Die Bibliothek unterstützt mehrsprachige Kommentare. Dazu wird einfach für jede Sprache ein eigener <description> Block angelegt. Das Attribut lang entscheidet welche Sprache es ist. Dabei ist der Aufbau wie folgt:
<library>
<procedure name=“Hier steht der Name des Procedures“>
Hier kommt der Code rein, auch Mehrzeilig
<description lang=“german“>
Hier kommt der Kommentar oder die Beschreibung des Bausteins rein
</description>
</procedure>
<sequence name=“Hier steht der Name der Sequenz“>
Hier kommt der Code rein, auch Mehrzeilig
<description lang=“german“>
Hier kommt der Kommentar oder die Beschreibung des Bausteins rein
</description>
<description lang=“english“>
Here is the English description stored.
</description>
</sequence>
</library>
Ein Baustein besteht immer aus einem äußeren Tag (procedure oder sequence) der beschreibt, ob es sich bei dem Baustein um ein Procedure oder um eine Sequence handelt. Der äußere Tag enthält dann zwei innere Tags, einen für den Code, den anderen für die Beschreibung. Die Reihenfolge der Bausteine ist egal, DDFCreator wählt je nachdem, ob ein Procedure oder eine Sequence eingefügt werden soll die entsprechenden Elemente aus. Natürlich muss erst ein Baustein abgeschlossen sein, bevor der nächste anfangen darf, wie folgendes falsche Beispiel zeigt:
<library>
<procedure name=“Hier steht der Name des Procedures“>
Hier kommt der Code rein, auch Mehrzeilig
<sequence name=“Hier steht der Name der Sequenz“>
Hier kommt der Code rein, auch Mehrzeilig
<description lang=“german“>
Hier kommt der Kommentar oder die Beschreibung des Bausteins rein
</description>
</sequence>
<description lang=“german“>
Hier kommt der Kommentar oder die Beschreibung des Bausteins rein
</description>
</procedure>
</library>
Nach einer Änderung von code.xcq steht nach einem Neustart von DDFCreator der Baustein ganz normal zur Verfügung. Achten Sie darauf, vor einer Aktualisierung von DDFCreator ihre code.xcq zu sichern, da diese sonst überschrieben werden kann.
