Die Druckversion wird nicht mehr unterstützt und kann Darstellungsfehler aufweisen. Bitte aktualisiere deine Browser-Lesezeichen und verwende stattdessen die Standard-Druckfunktion des Browsers.

Artikel beschreibt
DMXControl 3.2.3

Grundaufbau (DDF-Syntax) DMXC3

Allgemeine Einführung

Funktionselemente

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

Grundaufbau der DDF

Das DDF für DMXControl 3 besteht aus vier Teilen:

Basisangaben mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
Informationen mit Angaben zum Gerät, Hersteller, Autor sowie DMX-Modus
Funktionen mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
Procedures für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten

<?xml version="1.0" encoding="utf-8"?>
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3.2.3" ddfversion="1.0.0" subdevice="no">
  <information>
     ...
  </information>
  <functions>
     ...
  </functions>
  <procedures>
    ...
  </procedures>
</device>

Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die Bedienoberfläche (GUI), damit alle Steuerelemente wie die Gerätesteuerung (Device Control) und die Steuerungsfenster (Control Panel) richtig dargestellt werden. Des Weiteren greift der Hardware Abstraction Layer (HAL) auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den Szenen (Cues) eines Projekts abzuspeichern.

Funktionsteile

Basisinformationen

Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element device enthalten. Der Tag device umfasst folgende Attribute:

Attribut	Beschreibung	Standard-Wert	Zulässige Werte	Optional
`image`	Bild-Datei des DDFs	Nicht vorhanden	Dateiname des Bilds als *.png-Datei
`type`		`DMXDevice`	DMXDevice
Allgemeine Informationen zum DDF
`dmxaddresscount`	Gesamtzahl der DMX-Kanäle des Geräts	Nicht vorhanden	Ganze Zahlen von 1 bis 512	X
`dmxcversion`	Erforderliche Programmversion zur Verwendung des DDFs	`3.0.0`	`3.0.2`, `3.1.3`, `3.2.0` und alle zukünftigen Programmversion
`ddfversion`	Version des DDFs	Nicht vorhanden	`1.0.0`, `1.1.0`, `1.2.0` usw.
`subdevice`	Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer	`no`	`no` oder `yes`	X
Steuerung der Anzeige in der Bühnenansicht (Stage View)
`defaultdisplaystyle`	Standart Anzeige-Modus in der Bühnenansicht	`preview`	`custom`, `image` ober `preview`	X
`defaultdisplaycolor`	Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes	`#ffffff`	Jede HTML-Farbe (`#000000` - `#ffffff`)	X
Attribute zum Ansprechen der RGB+-Farben
`whitechanneldefaultmode`	Das Verhalten, wie der Weiß-Kanal (White channel) angesprochen wird	`onlywhite`	`none`, `addwhite` oder `onlywhite`	X
`amberchanneldefaultmode`	Das Verhalten, wie der Amber-Kanal angesprochen wird	`onlyamber`	`none`, `add` oder `only`	X

Das Element device umklammert alle Informationen des DDFs. Angaben außerhalb des Tags führen zu Fehlern beim Einfügen des DDFs in ein Projekt.

Beim Eintragen des Dateinamens für Icon in der Bühnenansicht ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.

Arbeitsweise der zusätzlichen LED-Farben

Alle zusätzlichen LED-Farben wie weiß, amber, uv etc., die neben den RGB-LEDs im Gerät verbaut sind, werden nach dem Hinzufügen des Geräts zu einem Projekt standardmäßig erst einmal nicht angesteuert. In den Eigenschaften des Geräts, aufzurufen zum Beispiel über die Bühnenansicht, kann unter dem Eintrag Automix Mode das Verhalten für jedes Gerät einzeln angepasst werden, hier am Beispiel der weißen LED:

None: Keine Ansteuerung der weißen LED (Standard-Einstellung)
Add white: Alle vier LEDs bei 100% für die Farbe weiß
Only white: Nur weiße LEDs bei 100% für die Farbe weiß

Geräteinformation

Im Informationsteil werden alle grundlegenden Informationen zum Gerät hinterlegt, für dies das DDF erstellt wurde. Mit Hilfe dieser Informationen erfolgt auch die Einsortierung des neuen DDFs im Dialog Geräte hinzufügen (Add Device). Alle Angaben werden durch das Element <information> ... </information> eingeklammert.

Tag	Beschreibung	Optional
`model`	Bezeichnung des Geräts gemäß Bedienungsanleitung
`vendor`	Hersteller des Geräts gemäß vorgegebener Herstellerliste
`author`	Autor des DDFs
`mode`	DMX-Modus bzw. Kanalbelegung	X
`electrical`	Elektrische Leistungsaufnahme des Geräts	X
`comment`	Kommentar zum DDF oder Gerät	X

Elektrische Leistungsaufnahme

Der Tag electrical in dem Block <information> ermöglicht die optionale Angabe der elektrischen Leistungsaufnahme durch das Gerät. Diese Informationen verwendet DMXControl 3 für das Lastmanagement, um die theoretische Gesamtleistung der am Veranstaltungsort verfügbaren Stromquellen zu berechnen. Es gibt zwei Arten der Leistungsaufnahme, mit denen DMXControl 3 arbeitet:

Konstante (statische) Leistungsaufnahme
Dynamische Leistungsaufnahme

Die konstante (statischen) Leistungsaufnahme ist über das Tag static definiert. Zu der konstanten Leistungsaufnahme zählen insbesondere Moving-Heads oder Scanner mit einer Entladungslampe als Leuchtmittel. Hier ändert sich die Leistungsaufnahme nämlich nicht, egal ob der Shutter und der Dimmer des Geräts geöffnet sind oder nicht. Zu der konstanten Leistungsaufnahme gehört aber auch der Stromverbrauch der Elektronik selbst, wenn das Gerät eingeschaltet und betriebsbereit ist.

Die dynamische Leistungsaufnahme korrespondiert mit dem Wert des Dimmers des Geräts. Diese Konstellation ist vor allem bei klassischen Halogenscheinwerfern anzutreffen, die an Dimmpacks angeschlossen sind. Darüber hinaus kann DMXControl 3 die theoretische Leistungsaufnahme beim Dimmen von LED-Scheinwerfern und Moving-Heads berechnen, wenn die Werte ebenfalls im Tag dimmer gepflegt sind.

Variante	Code
PAR-Scheinwerfer mit einem 1.000 Watt Leuchtmittel	<electrical> <dimmer>1000</dimmer> </electrical> Zunehmende Leistungsaufnahme des Geräts mit maximal 1.000 Watt bei voller Helligkeit (Dimmer 100%).
Moving-Head mit Entladungslampe	<electrical> <static>450</static> </electrical> Konstante Leistungsaufnahme des Geräts von 450 Watt.
LED-Scheinwerfer	<electrical> <static>20</static> <dimmer>145</dimmer> </electrical> Nach dem Einschalten hat das Gerät eine konstante Leistungsaufnahme von 20 Watt. Die LEDs sind aus (Dimmer 0%). Die LEDs haben bei voller Helligkeit eine Leistungsaufnahme von 145 Watt. Insgesamt besitzt das Gerät eine Leistungsaufnahme von 165 Watt.

Funktionen

Im Funktionsteil werden die eigentlichen Funktionen des Geräts eingetragen, wie beispielsweise Pan und Tilt, Dimmer, Farbrad, Strobe etc. Welche Funktionen aktuell unterstützt werden, sind im Syntax: die möglichen Funktions-Bausteine im Detail inklusive Code-Beispielen aufgelistet. Alle Angaben werden durch das Element <functions> ... </functions> eingeklammert.

Unterfunktionen eines DMX-Kanals

Jede einzelne Funktion eines DMX-Kanals kann durch eine Unterfunktion erweitert werden. Prominentestes Beispiel ist der Goboshake, welcher sich jeweils zu dem aktuell ausgewählten Gobo zusätzlich aktiviert lässt. Diese Funktion liegt meist auf dem gleichen DMX-Kanal wie die Funktion zum Auswählen des Gobos, in der Regel aber in einem anderen Wertebereich.

Ergänzende Funktionen für einen DMX-Kanal

Neben den Unterfunktionen gibt es noch ergänzende Funktionen Diese können entweder auf dem gleichen DMX-Kanal liegen, wie zum Beispiel das kontinuierliche Drehen des Farbrads in einem Moving-Head oder Scanner. Im Falle der Goborotation liegt die ergänzende Funktion auf einem getrennten DMX-Kanal. Hier wird über den ersten DMX-Kanal das Gobo ausgewählt und über den zweiten DMX-Kanal bestimmt, wie schnell sich das Gobo in welche Richtung drehen soll.

Procedures

Procedures werden nur eingesetzt, um selten benutzte Funktionen am Gerät zu aktivieren, die für den Live-Betrieb in der Regel nicht erforderlich sind. Üblicherweise verfügen insbesondere Moving-Heads oder Scanner über Funktionen zur Durchführung eines Resets oder zum Ein- bzw. Ausschalten des Leuchtmittels. Alle diese Funktionen werden ausgeführt, wenn ein bestimmter DMX-Wert auf dem zugehörigen DMX-Kanal für eine bestimmte Zeit gehalten wird. Procedures können nicht in Szenen abgespeichert werden und lassen sich entweder über

die Bühnenansicht (Stage View) oder
das Procedure-Node in der Eingangszuweisung (Input Assignment) aufrufen.