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

"{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\"

AppData

Standard-Verzeichnis unter AppData

Das Verzeichnis "{APPDATA}", in dem verschiedene benutzerdefinierte Einstellungen von vielen Programmen abgespeichert werden, ist unter folgendem Pfad zu finden, wobei "{BENUTZERNAME}" durch den Namen des aktuellen Benutzers des PCs zu ersetzen ist:

"C:\Users\{BENUTZERNAME}\AppData\Roaming\DMXControl Projects e.V\DMXControl\"

Als Kurzbebefehl kann man das Verzeichnis ebenfalls erreichen, wenn man in die Adressleiste des Windows Explorers den Pfad "%AppData%\Roaming\DMXControl Projects e.V\DMXControl\" eingibt. Für das komfortablere Aufrufen des Verzeichnisses legt das Installationsprogramm von DMXControl 3 auch diee Verknüpfung Eigene DDFs im Startmenü an.

Eigenes Verzeichnis mit Umgebungsvariable

Auf Wunsch kann dieses Verzeichnis durch das Definieren einer Umgebungsvariablen 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"

Die Umgebungsvariable DMXC3_PROFILE ist dabei die allgemeine Umgebungsvariable für alle Versionen für DMXControl 3. Möchte man auch zwischen den Versionen unterscheiden, gibt es die Möglichkeit, die Benutzerdaten inkl. DDFs entsprechend der folgenden Tabelle auch feiner gegliedert auf dem PC zu hinterlegen.

Umgebungsvariable	DMXC-Version	Beschreibung
DMXC3_PROFILE	3.X.X	Allgemeine Umgebungsvariable für alle Installationen von DMXControl 3 auf dem PC.
DMXC3_PROFILE_3_2	3.2.X	Umgebungsvariable für alle Major-Versionen von DMXControl 3.2.
DMXC3_PROFILE_3_2_0	3.2.0	Spezifische Umgebungsvariable für DMXControl 3.2.0.
DMXC3_PROFILE_3_2_1	3.2.1	Spezifische Umgebungsvariable für DMXControl 3.2.1.

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

Projekt-Zip

Dieses Verzeichnis bezieht sich auf die Verzeichnisse, die innerhalb der Projektdatei angelegt werden. Um den Inhalt dieser Verzeichnisse zu sehen, muss die Projektdatei mit einem beliebigen Komprimierungsprogramm geöffnet werden.

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