Einführung (DDF-Syntax) DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Zur Navigation springen Zur Suche springen
(Anpassung an DMXControl 3.1.2)
Zeile 10: Zeile 10:
  
  
==Hintergrund: Wofür werden DDFs benötigt?==
+
=Einleitung=
 
Das [[Glossar_DMXC2#DDF|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.
 
Das [[Glossar_DMXC2#DDF|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.
  
Zeile 17: Zeile 17:
 
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<ref>Unterschiedliche Anzahl und Belegung der DMX-Kanäle, einstellbar am Gerät selbst</ref>) 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.
 
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<ref>Unterschiedliche Anzahl und Belegung der DMX-Kanäle, einstellbar am Gerät selbst</ref>) 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.
  
{{BoxWichtig|Text=Die DDF-Dateien für DMXControl 3 haben einen bestimmten Syntax. Eine Verwendung von XML-Dateien aus anderen Anwendungen ist nicht möglich. }}
+
{{BoxWichtig|Text=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: Wo sind die DDFs zu finden?==
+
=Speicherort=
Die DDFs von DMXControl 3 sind lokal auf dem PC in folgendem Verzeichnis zu finden:
+
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.
<br />
+
 
<source lang="xml">
+
{| class="wikitable toptextcells"
[Installationsverzeichnis]\kernel\devices\
+
|-
</source>
+
! Kategorie !! Icon !! Beschreibung !! Speicherort !! Priorität
<br />
+
|-
[Installationsverzeichnis] steht hierbei für das Verzeichnis, in dem DMXControl 3 installiert wurde. Wurde dies beim Installieren nicht geändert, lautet der Pfad üblicherweise
+
!style="width: 10em"| Projekt-DDF
 +
|style="width: 5em"|
 +
|style="width: 20em"| Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuell geladenen 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
 +
|-
 +
! User-DDFs
 +
|
 +
| Eigene, vom Benutzer selbst erstelle DDFs
 +
| <code>[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\</code>
 +
| Mittlere Priorität
 +
|-
 +
! Lib-DDFs
 +
|
 +
| Vom Installer mitgelieferte Standard-DDFs
 +
| <code>[INSTALLATIONSVERZEICHNIS]\Kernel\LibDevices\</code>
 +
| Niedrigste Priorität
 +
|}
 +
 
 +
In allen Ordnern gibt es jeweils zwei Unterordner:
 +
* '''Images''': Bild für das Icon des Geräts in der Stage View
 +
* '''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 />
 
<br />
 
<source lang="xml">
 
<source lang="xml">
Zeile 37: Zeile 61:
 
[Installationsverzeichnis]\kernel\devices\images\
 
[Installationsverzeichnis]\kernel\devices\images\
 
</source>
 
</source>
<br />
 
und die Icons der Gobos unter
 
<br />
 
<source lang="xml">
 
[Installationsverzeichnis]\kernel\icons
 
</source>
 
  
 +
 +
{{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'''
 
'''Fußnoten'''
 
<references/>
 
<references/>

Version vom 1. Juli 2018, 16:26 Uhr

Books.png Einführung (DDF-Syntax) DMXC3 Artikel beschreibt
DMXControl 3.1.2
VLC icon.png 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.


Grundaufbau eines DDFs Arrow forw.png
Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


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.


 Wichtiger Hinweis 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 besitzen. Über die Icons ist im Dialog Add Device eine entsprechende Zuordnung möglich, zu welcher Kategorie ein DDF gehört.

Kategorie Icon Beschreibung Speicherort Priorität
Projekt-DDF Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuell geladenen Projekts benötigt werden. [PROJEKT-ZIP]/LibDevices

[PROJEKT-ZIP]/UserDevices

Höchste Priorität im aktuellen Projekt
User-DDFs Eigene, vom Benutzer selbst erstelle DDFs [APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\ Mittlere Priorität
Lib-DDFs Vom Installer mitgelieferte Standard-DDFs [INSTALLATIONSVERZEICHNIS]\Kernel\LibDevices\ Niedrigste Priorität

In allen Ordnern gibt es jeweils zwei Unterordner:

  • Images: Bild für das Icon des Geräts in der Stage View
  • 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

C:\Programme (x86)\DMXControl3\


Das Bild für das Icon des Geräts in der Stage View liegt immer im Verzeichnis

[Installationsverzeichnis]\kernel\devices\images\


 Wichtiger Hinweis 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

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