Version vom 1. Juli 2018, 17:16 Uhr

Einführung (DDF-Syntax) DMXC3

Artikel beschreibt
DMXControl 3.1.2

Dieser Artikel oder Abschnitt wird gerade durch den User Skistner bearbeitet. Um Bearbeitungskonflikte zu vermeiden, warte bitte mit Änderungen, bis diese Markierung entfernt ist, oder wende dich an den Bearbeiter.

Seite zuletzt bearbeitet von Skistner vor: 2335 Tagen

Inhaltsverzeichnis

Teil 1: Grundlagen
Allgemeine Einführung (Wofür benötigt man ein DDFs in DMXC3?)	Grundaufbau eines DDFs (Struktur) Funktionselemente	Grundregeln (Welche Dinge sind bei der Erstellung zu beachten?)

Teil 2: Funktionen
Intensität Position Farbe Matrix	Radix Gobo Linse Blendenschieber	Effektrad Bühneneffekte Freie Funktionen

Teil 3: Procederes
Funktionen	Beispiele

Teil 4: Beispiele
LED-Scheinwerfer	4er-Bar	Moving Head

Einleitung

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.

Der zweite Punkt 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^[1]) 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.

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 Priortiä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

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.

Fußnoten

↑ Unterschiedliche Anzahl und Belegung der DMX-Kanäle, einstellbar am Gerät selbst

[1] Unterschiedliche Anzahl und Belegung der DMX-Kanäle, einstellbar am Gerät selbst

[1]

@@ Zeile 20: / Zeile 20: @@
 =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 besitzen. Über die Icons ist im Dialog '''''Add Device''''' eine entsprechende Zuordnung möglich, zu welcher Kategorie ein DDF gehört.
+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.
+==DDF-Kategorien==
 {| class="wikitable toptextcells"
 |-
@@ Zeile 27: / Zeile 27: @@
 |-
 !style="width: 10em"| Projekt-DDF
-|style="width: 5em"|
+|style="width: 5em; text-align: center"| [[Datei:Icon_Project-DDF.png]]
-|style="width: 20em"| Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuell geladenen Projekts benötigt werden.
+|style="width: 20em"| Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuellen Projekts benötigt werden
 |style="width: 35em"| <code>[PROJEKT-ZIP]/LibDevices</code>
 <code>[PROJEKT-ZIP]/UserDevices</code>
-|style="width: 20em"| Höchste Priorität im aktuellen Projekt
+|style="width: 20em"| Höchste Priorität im aktuellen Projekt,
+bei neuen Projekten nicht vorhanden
 |-
 ! User-DDFs
-|
+|style="text-align: center"| [[Datei:Icon_User-DDF.png]]
 | Eigene, vom Benutzer selbst erstelle DDFs
 | <code>[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\</code>
-| Mittlere Priorität
+| Mittlere Priorität im aktuellen Projekt,
+bei neuen Projekten höchste Priortiät
 |-
 ! Lib-DDFs
-|
+|style="text-align: center"| [[Datei:Icon_Lib-DDF.png]]
 | Vom Installer mitgelieferte Standard-DDFs
-| <code>[INSTALLATIONSVERZEICHNIS]\Kernel\LibDevices\</code>
+| <code>[PROGRAMMVERZEICHNIS]\Kernel\LibDevices\</code>
-| Niedrigste Priorität
+| Niedrigste Priorität im aktuellen Projekt,
+bei neuen Projekten mittlere Priorität
 |}
-In allen Ordnern gibt es jeweils zwei Unterordner:
+==Verzeichnisse==
-* '''Images''': Bild für das Icon des Geräts in der Stage View
+'''[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
-* '''Icons''': Icons für das Gobo
-[Installationsverzeichnis] 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
 <br />
 <source lang="xml">
 C:\Programme (x86)\DMXControl3\
 </source>
+Das Verzeichnis '''[APPDATA]''', in dem verschiedene benutzerdefinierte Einstellungen von vielen Programmen abgespeichert werden, ist unter folgendem Pfad zu finden
 <br />
-Das Bild für das Icon des Geräts in der Stage View liegt immer im Verzeichnis
+<source lang="xml">
+C:\Users\[BENUTZERNAME]\AppData\Roaming\DMXControl Projects e.V\DMXControl\
+</source>
+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
 <br />
 <source lang="xml">
-[Installationsverzeichnis]\kernel\devices\images\
+C:\Users\[BENUTZERNAME]\Documents\DMXControl Projects e.V\DMXControl
 </source>
+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
-{{BoxWichtig|Text=Das alte Verzeichnis <code>[Installationsverzeichnis]\kernel\devices\</code> 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 <code>UserDevices</code> verschoben werden. Der Installer hat hier auch eine Verknüpfung angelegt.}}
+{{BoxWichtig|Text=Das alte Verzeichnis <code>[Installationsverzeichnis]\Kernel\Devices\</code> 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 <code>UserDevices</code> verschoben werden. Der Installer hat hier auch eine Verknüpfung angelegt.}}
 '''Fußnoten'''
 <references/>