Einführung (DDF-Syntax) DMXC3

Einführung (DDF-Syntax) DMXC3

Artikel beschreibt DMXControl 3.2.0

Das Device Definition File (kurz DDF) ist eine XML-Datei, in der für DMXControl 3 alle erforderlichen Informationen hinterlegt sind, um ein Gerät wie Moving-Head, Scanner oder LED-PAR intelligent ansteuern können. Es sagt DMXControl 3, dass bei einem LED-PAR zum Beispiel die Farben rot, grün und blau auf den Kanälen 2, 3 und 4 sowie Dimmer und Strobe auf den Kanälen 1 und 5 liegen. Darüber hinaus bringt ein DDF für DMXControl 3 alle Informationen mit, mit deren Hilfe die GUI automatisch die für DMXControl 3 typische einheitliche Bedienoberfläche für alle alle Arten von DDFs erstellt.

Einleitung

Damit DMXControl 3 überhaupt ein angeschlossenes Gerät richtig und mit allen in DMXControl 3 zur Verfügung stehenden Features ansteuern kann, müssen im zugehörigen Projekt genau diese Informationen hinterlegt sein. Diese Informationen, welche Funktionen ein Gerät mitbringt, sind in einem DDF abgespeichert. Da sich diese Funktionen von Gerät zu Gerät unterscheiden, benötigt jedes Gerät sein eigenes DDF. Die zweite Aufgabe des DDFs ist, dass mit den Informationen im DDF der Inhalt des Device Controls sowie der Funktionsumfang der einzelnen Controls für Color, Gobo, Intensity und ggf. weitere Controls selbstständig automatisch dargestellt wird. Eine Gestaltung der Bedienoberfläche für die DDFs so wie bei DMXControl 2 ist bei DMXControl 3 nicht mehr erforderlich.

Sobald sich die Funktionen der Geräte ändern, muss ein neues DDF angelegt werden. Das bedeutet, dass für 20 gleiche Dimmer (klassische PAR-Kannen an Dimmerpacks) das gleiche DDF verwendet werden kann, wohingegen Moving-Heads mit verschiedenen Kanalbelegungen (DMX-Modi) auch getrennte DDFs benötigt werden. Bei letzterem Punkt ist wichtig, dass das DDF zum ausgewählten DMX-Modus passen muss, damit eine ordnungsgemäße Ansteuerung möglich ist.

Die DDF-Dateien für DMXControl 3 haben einen bestimmten Syntax. Eine Verwendung von XML-Dateien aus anderen Anwendungen, insbesondere aus DMXControl 2, ist nicht möglich.

Speicherort

Die DDFs von DMXControl 3 sind grundsätzlich in drei Kategorien aufgeteilt, die auf Grund ihrer Definition jeweils einen anderen Speicherort und eine andere Priorität beim Laden und Verwenden in den Projekten besitzen. Über die Icons ist im Dialog Add Device eine entsprechende Zuordnung möglich, zu welcher Kategorie ein DDF gehört.

Alle vom Installer ausgelieferten und im Verzeichnis "[PROGRAMMVERZEICHNIS]\Kernel\LibDevices\" abgelegten DDFs werden bei jedem Update oder bei jeder Neuinstallation vollständig überschrieben. Für eure eigenen DDFs nutzt bitte das Verzeichnis "UserDevices", welches ihr über die Verknüpfung « Eigene DDFs » im Startmenü von Windows erreicht.

DDF-Kategorien

Kategorie	Icon	Beschreibung	Speicherort	Priorität
Projekt-DDF	Datei:Icon Project-DDF.png	Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuellen Projekts benötigt werden	"[PROJEKT-ZIP]\LibDevices" "[PROJEKT-ZIP]\UserDevices"	Höchste Priorität im aktuellen Projekt, bei neuen Projekten nicht vorhanden
User-DDFs	Datei:Icon User-DDF.png	Eigene, vom Benutzer selbst erstelle DDFs	"[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\"	Mittlere Priorität im aktuellen Projekt, bei neuen Projekten höchste Priorität
Lib-DDFs	Datei:Icon Lib-DDF.png	Vom Installer mitgelieferte Standard-DDFs	"[PROGRAMMVERZEICHNIS]\Kernel\LibDevices\"	Niedrigste Priorität im aktuellen Projekt, bei neuen Projekten mittlere Priorität
		Über die DDF Libary nachträglich heruntergeladene DDFs	"[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\LibDevices\"

Verzeichnisse

"[PROGRAMMVERZEICHNIS]" steht hierbei für das Verzeichnis, in dem DMXControl 3 installiert wurde. Wurde dies beim Installieren von DMXControl 3 nicht geändert, lautet der Pfad üblicherweise
"C:\Programme (x86)\DMXControl3\"

Das Verzeichnis "[APPDATA]", in dem verschiedene benutzerdefinierte Einstellungen von vielen Programmen abgespeichert werden, ist unter folgendem Pfad zu finden
"C:\Users\[BENUTZERNAME]\AppData\Roaming\DMXControl Projects e.V\DMXControl\"

Dieses Verzeichnis lässt sich auch direkt über eine Verknüpfung im Startmenü finden. Auf Wunsch kann dieses Verzeichnis durch das Definieren einer Umgebungsvariablen selbst mit dem Namen DMXC3_PROFILE in den Einstellungen von Windows an einen beliebigen anderen Ort auf dem PC verschoben werden. In dem Wert der Umgebungsvariable wird der neue Ort für den Inhalt des Ordners DMXControl angegeben. So kann ein eigener Pfad zu den Benutzerdaten von DMXControl 3 wie folgt lauten, wenn die Umgebungsvariable gesetzt ist
"C:\Users\[BENUTZERNAME]\Documents\DMXControl Projects e.V\DMXControl"

In allen Ordnern gibt es jeweils zwei Unterordner:

• "Images": Bild für das Icon des Geräts in der Stage View, zum Beispiel ein Produktbild vom Hersteller
• "Icons": Icons für die Gobos der Geräte

Das alte Verzeichnis "[Installationsverzeichnis]\Kernel\Devices\" wird seit der Version 3.1.2 nicht mehr vom Dialog Add Device berücksichtigt. Alle vom Anwender erstellen oder angepassten DDFs inklusive der zugehörigen Images oder Icons müssen daher manuell in das Verzeichnis "UserDevices" verschoben werden. Der Installer hat hier auch eine Verknüpfung angelegt. Alternativ ist das neue Verzeichnis über die Verknüpfung « Eigene DDFs » im Startmenü zu erreichen.

Fußnoten