Deutsches DMXC-Wiki - Benutzerbeiträge [de]

Bitmap from Ressource (Input Assignment) DMXC3

2019-12-09T12:10:11Z

Pgrote:

Dier Node wandelt einen Dateinamen eines Bildes in eine Bitmap um.

[Bild]

=Eingänge=
{| class="wikitable toptextcells"
|-
! style="width: 8em" | Name !! style="width: 12em" | Zulässige Werte !! style="width: 8em" | Datentyp !! Beschreibung
|-
| Resource Name || beliebig, wie z. B. <code>IMG-000401.png</code>, <code>Icon-2.png</code> || String || Eingang für die Ressourcen-Namen.
|-
|}
=Ausgänge=
{| class="wikitable toptextcells"
|-
! style="width: 8em" | Name !! style="width: 12em" | Ausgebende Werte !! style="width: 8em" | Datentyp !! Beschreibung
|-
| bmp || Grafik || Bild || Gibt ein Bild aus.
|-
|}
=Anwendungsbeispiel=

Bitmap from Ressource (Input Assignment) DMXC3

2019-12-09T12:09:27Z

Pgrote:

Bitmap from Ressource (Input Assignment) DMXC3

2019-12-09T12:08:21Z

Pgrote:

Programmer (Input Assignment) DMXC3

2019-11-03T09:39:07Z

Pgrote: Datatyp ist Double

Mit diesem Node können sowohl einzelne Devices als auch Device Groups über das {{Manual_Windowcaption|[[Softdesk_DMXC3|Softdesk]]}} oder via DMX-In angesprochen werden. Der Programmer Node ist dabei der Ersatz für die direkte Ansteuerung von Devices, die bis zu DMXControl 3.1.3 im alten Input Assignment existierte.
[Bild]

=Eingänge=
{| class="wikitable toptextcells"
|-
! style="width: 8em" | Name !! style="width: 12em" | Zulässige Werte !! style="width: 8em" | Datentyp !! Beschreibung
|-
| Device or Group ID || ID, Device-Nummer, Group-Nummer || String || Eingang unter anderem Device-Nummer oder Gruppennummer, auch über ein Format-Node als “Aufzählung” / Liste zum direkten Auswählen von mehreren unterschiedlichen Geräten gleichzeitig
|-
| Output Mode || colspan="2" | || Ändert den Output Mode für den Programmer
|-
| Lumos || rowspan="4" | <code>1</code> oder <code>true</code> || rowspan="5" | Bool || Leert den Programmer
|-
| Clear Undo || Macht das Leeren des Programmers rückgängig
|-
| Lumos || Setzt die Helligkeit auf 100% und öffnet ggf. einen vorhandenen Shutter
|-
| Nox || Setzt die Helligkeit auf 0% und schließt ggf. einen vorhandenen Shutter
|-
| Shutter || <code>0</code> oder <code>1</code> bzw. <code>true</code> oder <code>false</code> || Öffnet oder schließt des Shutter
|-
| Intensity || rowspan="4" | <code>0.0</code> - <code>1.0</code> || rowspan="4" | Double|| Setzt die Helligkeit des Dimmers im Bereich von <code>0%</code> bis </code>100%</code>
|-
| Strobe || Setzt die gewünschte Strobe-Frequenz
|-
| Pan || Position der Pan-Achse
|-
| Tilt || Position der Tilt-Achse
|-
| Color || Farbe als RGB-Wert || String || Input zum Festlegen der Farbe
|-
| Colortemp || <code>0.0</code> - <code>1.0</code> || Double|| Bestimmt die Farbtemperatur
|-
| Gobo || colspan="2" | || Auswahl des Gobos
|-
| Goboindex || <code>0.0</code> - <code>1.0</code> || rowspan="7" | Double|| Positionierung des Gobos in einem bestimmten Winkel
|-
| rowspan="2" | Goborotation || <code>0.0</code> - <code>0.5</code> || Kontinuierliche Drehung des gewählten Gobos im Uhrzeigersinn (CW)
|-
| <code>0.5</code> - <code>1.0</code> || Kontinuierliche Drehung des gewählten Gobos entgegen des Uhrzeigersinns (CCW)
|-
| Zoom || rowspan="4" | <code>0.0</code> - <code>1.0</code> || Bestimmt den Öffnungswinkel (Zoom) des Lichtkegels
|-
| Fokus || Legt die Schärfe der Projektion fest
|-
| Frost || Fährt den Frostfilter ein, um den Lichtstrahl (zunehmend) weichzuzeichnen
|-
| Iris || Schließt oder öffnet die Iris linear zum anliegenden Wert
|-
| Prisma || colspan="2" | || Auswahl und Aktivierung des Prismas
|-
| Prismaindex || <code>0</code> - <code>1</code> || rowspan="3" | Double|| Positioniert das aktive Prisma in einem vorgegebenen Winkel
|-
| rowspan="2" | Prismarotation ||<code>0.0</code> - <code>0.5</code> || Kontinuierliche Drehung des gewählten Primas im Uhrzeigersinn (CW)
|-
| <code>0.5</code> - <code>1.0</code> || Kontinuierliche Drehung des gewählten Prisma entgegen des Uhrzeigersinns (CCW)
|-
|}

{{BoxWichtig | Text= Durch die zulässigen Werte von <code>0</code> - <code>1</code> bei den regelbaren Eingängen ist der Programmer Node universell nutzbar und auch für mehrere Geräte gleichzeitig. Die Zuordnung der tatsächlichen Werte, wie zum Beispiel der maximale Schwenkbereich für die Pan- und Tilt-Achse kann nur im Vorfeld im Softdesk mit einem vorgeschalteten Rule of Three Node erfolgen, welcher die vom Softdesk gesendeten Werte auf die zulässigen Werte am Eingang des Programmer Nodes herunterskaliert.}}

=Ausgänge=
{| class="wikitable toptextcells"
|-
! style="width: 8em" | Name !! style="width: 12em" | Ausgebende Werte !! style="width: 8em" | Datentyp !! Beschreibung
|-
| Output Mode || <code>All</code> || String || Gibt den zusammengesetzten oder formatierten Text aus, um hiermit einen Button oder ein Label im Softdesk dynamisch zu beschriften.
|-
|}

=Anwendungsbeispiel=

Open Function (DDF-Syntax) DMXC3

2019-11-03T02:06:53Z

Pgrote: FALSCH!

{{Kapitelüberschrift|Version=DMXControl 3.2.0}}

{{DMXC3_Manual-Navigation_DDF
|zurückLink = DDF-Syntax_Bühneneffekte_DMXC3
|zurückText = Bühneneffekte
|vorLink =
|vorText =
}}

Sollte eine Funktion eines Geräts nicht nativ über eine der spezifischen Funktionen wie zum Beispiel <code>goborotation</code> für die Goborotation für ein Goborad oder <code>strobe</code> für das (einfach ausgedrückt) Blitzen des Geräts abzubilden sein, kann man im DDF so genannte allgemeine Funktionen oder vollständig freie Funktionen definieren.

=Allgemeine Funktionen=
==Index==
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes in einem bestimmten Winkel positionieren lassen.

{{BoxHinweis|Text=Für die Indizierung von Gobos sollte die Funktion <code>index</code> nicht verwendet werden. Der Slider Goboindex im Fenster Gobo lässt sich nur über die Funktion <code>goboindex</code> nutzen.}}

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>index</code>
|style="width: 10em"| Standard
|style="width: 60em"| <syntaxhighlight lang="xml">
<index dmxchannel="0">
<range range="60" mindmx="0" maxdmx="127" minval="0" maxval="60" />
</index>
</syntaxhighlight>
Index auf DMX-Kanal 1:
* Ausrichtung der Linse o. ä. in einem Winkel zwischen 0° bei DMX-Wert 0 und 60° bei DMX-Wert 127.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Maximaler Drehwinkel für die Linse
|style="width: 10em"| DMX-Wert für die Start-Position
|style="width: 10em"| DMX-Wert für die End-Position
|style="width: 10em"| Start-Position der Linse
|style="width: 10em"| End-Position der Linse
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>0° bis 720°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 720°</code>
| <code>0° bis 720°</code>
|}

==Rotation==
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes drehen lassen oder um die Drehung eines Spiegelkugelmotors steuern zu können.
{{BoxHinweis|Text=Für die Rotation von Gobos sollte die Funktion <code>rotation</code> nicht verwendet werden. Der Slider Goborotation im Fenster Gobo lässt sich nur über die Funktion <code>goborotation</code> nutzen.}}

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>rotation</code>
|style="width: 10em"| Standard
|style="width: 60em"| <syntaxhighlight lang="xml">
<rotation dmxchannel="0">
<step type="stop" mindmx="191" maxdmx="192" />
<range type="cw" mindmx="190" maxdmx="128" minval="0.05" maxval="5" />
<range type="ccw" mindmx="193" maxdmx="255" minval="0.05" maxval="5" />
</rotation>
</syntaxhighlight>
Rotation auf DMX-Kanal 1:
* Keine Rotation bei zwischen DMX-Wert 191 und DMX-Wert 192.
* Rotation im Uhrzeigersinn mit 5 1/s bei DMX-Wert 128, abnehmend bis 0,05 1/s bei DMX-Wert 190.
* Rotation gegen den Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl
|style="width: 10em"| Maximale Drehzahl
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 10 1/s</code>
| <code>0.01 1/s bis 10 1/s</code>
|}

=Freie Funktionen=
Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur im Device Control ausgegeben. Auch die Vorteile der HAL lassen sich auf diese frei definierten Funktionen anwenden.

Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:
* <code>rawstep</code>: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
* <code>raw</code>: Generiert einen einfachen Schieberegler.
* <code>const</code>: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.

{{BoxWichtig|Text=Alle oben genannten Elemente sind vollständig gerätespezifisch. Die HAL kann in Cuelists etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist. }}

==rawstep==
Über das Element <code>rawstep</code> wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:
* Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
* Einfügen und Entfernen einer Animationsscheibe in einem Moving-Head
* Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus

Im Gegensatz zu den fest definierten Funktionen muss beim <code>rawstep</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes <code>step</code> kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise der HAL.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>rawstep</code>
|style="width: 10em"| Standard
|style="width: 60em"| <syntaxhighlight lang="xml">
<rawstep dmxchannel="0" name="Mode">
<step caption="DMX" mindmx="0" maxdmx="9" />
<step caption="Auto" mindmx="10" maxdmx="199" />
<step caption="Music" mindmx="200" maxdmx="255" />
</rawstep>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal 1:
* Aktivierung des DMX-Modus bei DMX-Wert zwischen 0 und 9.
* Aktivierung der Automatik-Modus bei DMX-Wert zwischen 10 und 199.
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen 200 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! caption !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Beschreibung der Funktion
|style="width: 10em"| Minimaler DMX-Wert zur Aktivierung der der Funktion
|style="width: 10em"| Maximaler DMX-Wert zur Aktivierung der der Funktion
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>Text</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

{{BoxWichtig|Text=Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }}

==raw==
Das Element <code>raw</code> erzeugt im Device Control einen einzigen Schieberegler. Typische Anwendungsfälle sind hierfür:
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Einstellung der Mikrofon-Empfindlichkeit für die Sound-to-Light-Steuerung
* Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
* Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
* Nutzung für weitere Bewegungsachsen
* Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern

{{BoxHinweis|Text=Können über einen DMX-Kanal des vorliegenden Geräts zum Beispiel mehrere interne Programme ausgewählt und in ihrer Ablaufgeschwindigkeit verändert werden, sollten diese mit Hilfe des Elements <code>rawranges</code> implemeniert werden.}}

Im Gegensatz zu den fest definierten Funktionen muss beim <code>raw</code> neben dem DMX-Kanal im Attribut <code>name</code>e auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>raw</code>
|style="width: 10em"| Geschwindigkeitsregler für Automatikprogramme
|style="width: 60em"| <syntaxhighlight lang="xml">
<raw dmxchannel="0" name="Macro speed" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</raw>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:
* Geschwindigkeit der Automatikprogramme zunehmend von DMX-Wert 0 bis DMX-Wert 255.
|-
| Vorlage für Animationsscheibe
| <syntaxhighlight lang="xml">
<raw dmxchannel="0" name="Animation disk rotation" >
<step type="stop" mindmx="125" maxdmx="130"/>
<range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
<range type="ccw" mindmx="124" maxdmx="0" maxval="-0.05" minval="-2" />
</raw >
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal 1:
* Animationsscheibe statisch bei DMX-Wert zwischen 125 und 130.
* Rotation der Animationsscheibe im Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 131, schneller werdend bis 2 1/s bei DMX-Wert 255.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/s bei DMX-Wert 124, abnehmend bis -0,05 1/s bei DMX-Wert 0.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für die Funktion
|style="width: 10em"| Maximaler DMX-Wert für die Funktion
|style="width: 10em"| Kleinster Wert
|style="width: 10em"| Größter Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code> 
<code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
|}

==rawranges==

{{BoxHinweis|Text=Die Funktion <code>rawranges</code> wird erst ab DMXControl 3.2 unterstützt.}}
Das Element <code>rawranges</code> erzeugt im Device Control einen Schieberegler für mehrere verschiedene Funktionen mit einem variablen Wertebereich. Die Funktionen können über das zugehörige, automatisch generierte Dropdown-Menü ausgewählt werden. Typische Anwendungsfälle sind hierfür:
* Ändern der Abspielgeschwindigkeit von internen Programmen

Für eine eindeutige Zuordnung im Device Control muss beim Element neben dem <code>dmxchannel</code> ebenfalls im Attribut <code>nam</code>e auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die grundlegende Definition unterscheidet sich vom Element <code>raw</code> nicht, sondern wird nur um das Attribut <code>type</code> ergänzt, in dem die Beschreibung der jeweiligen Funktion auf dem DMX-Kanal erfolgt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" | <code>rawranges</code>
|style="width: 10em"| Auswahl und Abspielgeschwindigkeit für Automatikprogramme
|style="width: 60em"| <syntaxhighlight lang="xml">
<rawranges dmxchannel="0" name="Auto show" >
<range type="Show 1" mindmx="0" maxdmx="63" minval="0" maxval="100" />
<range type="Show 2" mindmx="64" maxdmx="127" minval="0" maxval="100" />
<range type="Show 3" mindmx="128" maxdmx="191" minval="0" maxval="100" />
<range type="Show 4" mindmx="192" maxdmx="255" minval="0" maxval="100" />
</raw>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Auto show" auf DMX-Kanal 1:
* Aktivierung der Show 1 und Festlegung der Geschwindigkeit von 0% bei DMX-Wert 0 bis 100% bei DMX-Wert 63.
* Aktivierung der Show 2 und Festlegung der Geschwindigkeit von 0% bei DMX-Wert 64 bis 100% bei DMX-Wert 127.
* ...
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für die Funktion
|style="width: 10em"| Maximaler DMX-Wert für die Funktion
|style="width: 10em"| Kleinster Wert
|style="width: 10em"| Größter Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| Kurz-Beschreibung der Funktion
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
|}

==const==
Das Element <code>const</code> wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.

Für das Element const ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.

Im Gegensatz zu den fest definierten Funktionen muss beim <code>const</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut <code>val</code> wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>const</code>
|style="width: 10em"| Standard
|style="width: 60em"| <syntaxhighlight lang="xml">
<const dmxchannel="0" name="Macro Effects" val="0" />
</syntaxhighlight>
Makroeffekte auf DMX-Kanal 1:
* Dauerhaft gesetzter DMX-Wert 0.
|}

[[Kategorie: DDF DMXControl 3]]

Input Assignment DMXC3

2019-10-14T14:20:09Z

Pgrote:

{{Kapitelüberschrift|Version=DMXControl 3.2.0}}
{{DMXC3_Manual-Navigation_Hauptprogramm}}

Das {{Manual_Windowcaption|Input Assignment}} ist die zentrale Schnittstelle, um DMXControl 3 mit beliebigen Eingabegeräten zu bedienen und Signale zu verteilen. Eingabegeräte und -möglichkeiten sind zum Beispiel eine Tastatur, das {{Manual_Windowcaption|[[Softdesk_DMXC3|Softdesk]]}}, DMX-In oder ein MIDI-Controller. Mit dem {{Manual_Windowcaption|Input Assignment}} können Verbindungen der so genannten In- und Outputs zu programminternen Eigenschaften und Funktionen von DMXControl 3 wie {{Manual_Windowcaption|[[Cuelist_DMXC3|Cuelist]]}}, {{Manual_Windowcaption|[[Executor_DMXC3|Executoren]]}} etc. angelegt werden.

=Überblick=

{{BoxHinweis|Text=Im {{Manual_Windowcaption|Input Assignment}} wird wie auch im {{Manual_Windowcaption|[[Project_Explorer_DMXC3|Project Explorer]]}} sehr viel mit ''Drag & Drop'' gearbeitet, sowohl beim Erstellen eines neuen Connectionsets als auch beim Ändern eines Connectionsets in der Graphenansicht.}}

Der Grundgedanke im {{Manual_Windowcaption|Input Assignment}} ist, dass man nahezu jede Eingabemöglichkeit zur Steuerung einer oder mehreren beliebigen programminternen Funktion von DMXControl 3 nutzen kann. Dabei sind diese Connectionsets nicht als klassische 1:1-Verbindungen zu sehen. Mit dem {{Manual_Windowcaption|Input Assignment}} kann man Werte innerhalb eines Connectionsets an jeder Stelle manipulieren und beliebig viele zusätzliche Steuermöglichkeiten und -abhängigkeiten schaffen. Durch den standardisierten Datenaustausch zwischen vielen Elementen gibt es nahezu keine Einschränkungen. So erhält man besonders flexible und auch universelle Steuerungsmöglichkeiten, die je nach Aufbau sogar unabhängig von dem aktuellen Projekt, das heißt als ein Bestandteil eines eigenen Vorlage-Projekts genutzt werden können.

Neben dem Ansprechen von programminternen Funktionen {{Manual_Windowcaption|Cuelist}}, {{Manual_Windowcaption|Executoren}}, {{Manual_Windowcaption|Master}} etc. bietet das {{Manual_Windowcaption|Input Assignment}} auch die Möglichkeit, euch die verschiedensten Informationen zum Beispiel im {{Manual_Windowcaption|Softdesk}} zu visualisieren. Das schließt nicht nur das Ändern des Status eines Buttons ein, ob dieser gedrückt oder nicht gedrückt ist, sondern man kann sich auch Informationen auf Textbasis wie den Namen einer aktuell aktiven Cuelist oder die BPM-Werte aller im Projekt genutzten Speed Master anzeigen lassen. Eine Variante ist ein Feedback zu einem MIDI-Controller mit Motorfadern, dessen Position und Wert parallel im Softdesk visualisiert wird.

=Wichtige Merkmale=
==Grundkonzept des Input Assignments==

{{BoxWichtig|Text=Jede Zeile in der Tabelle ist ein Connectionset, welches mindestens aus zwei Knoten (Nodes) besteht, die wiederum mit mindestens einer Verbindung (Link) verknüpft sind.}}

Das bedeutet, ein Connectionset lässt sich beliebig weit ausbauen und "aufmotzen". Auch ist es zulässig, dass mehrere Graphen parallel in einem Connectionset existieren, solange keine Nodes einzeln im Graph platziert sind.

===Input vs. Output vs. Node===
Im Rahmen einem tiefergehenden Einstieg sprechen wir über die drei, im folgendenen genannten Arten von Objekten, mit denen man regelmäßige Berührungspunkte hat:
* '''Inputs''' sind alle Werte und Befehle, die in die Software hineingeschickt werden. Diese kommen beispielsweise von einer Tastatur, dem Softdesk oder einem anderen Eingabegerät.
* '''Outputs''' empfangen bestimmte Werte und visualisieren diesen Wert in Form eines Feedbacks. Das ist zum einen beispielsweise das Rückmelden des Status an einen Button, der daraufhin seine Farbe ändert. Eine andere Variante kann aber auch das Positionieren des Motorfaders auf einem MIDI-Controller sein. Eine Cuelist, ein Speed Master etc. ist gemäß unserer Definition dagegen kein Output (mehr) sondern ein Node.
* '''Nodes''' haben sowohl einen Input Hub auf der linken Seite und Output Hub auf der rechten Seite (Ein- und Ausgang), die auch alle gleichzeitig verwendet werden können bzw. zum Teil auch verwendet werden müssen. Worin die Unterschiede der Converter-, Logic- und Wrapper-Nodes liegen, ist unter dem Abschnitt Nodes nachzulesen.

===ID vs. Nummer vs. Name===
Die funktionsspezifischen Nodes, das heißt die Nodes aus dem Wrapper-Bereich, lassen sich auf drei Wege mit der zugehörigen Cuelist, Exectur, Speedmaster etc. verknüpfen.

{| class="wikitable toptextcells"
|-
! style="width: 5em" | Verknüpfung !! style="width: 40em" | Beschreibung !! style="width: 40em" | Anwendungsbeispiel
|-
| ID || Einmalige und eindeutige interne ID eines Elements innerhalb eines Projekts, der in so bis zum Löschen des Elements unverändert bleibt. || Wer mit vielen Cuelists arbeitet und diese auch regelmäßig umbenennt, kann auf diesem Wege sicher gehen, dass die Verbindungen weiterhin funktionieren.
|-
| Name || Selbst vergebener Name des Elements wie zum Beispiel ''Cuelist Show 1'' oder ''Ambiente 2''. || Lauten die Namen einer Cuelists immer gleich, kann man sich ein Vorlageprojekt erstellen, in dem die Verbindungen bereits enthalten sind. Die Verbindung funktioniert dann sofort, sobald man (wieder) eine Cuelist mit dem Namen ''Cuelist Show 1'' oder ''Ambiente 2'' in seinem Projekt angelegt hat.
|-
| Nummer || Automatisch vergebene, fortlaufende Nummer, die aber geändert werden kann. || Die Zuordnung über die Nummer kann dann genutzt werden, wenn man zum Starten einer Cuelist immer nur eine Taste drücken möchte, die zugeordnete Cuelist aber über zwei andere Tasten live geändert werden soll.
|}

==Begriffe und Funktionen==
Alle Begriffe, die im Zusammenhang mit dem Input Assignment genutzt werden, erläutern wir mit Hilfe der folgenden Bilder der Standardansicht im {{Manual_Windowcaption|Input Assignment}}, der Tabellenansicht sowie anhand eines Connectionsets, der gerade in der Graphenansicht geöffnet ist.

=Nutzung=
==Aufruf==
Das {{Manual_Windowcaption|Input Assignment}} kann man über drei verschiedene Wege aufrufen:
* direkt über den Weg {{Manual_MenuText|Windows|Input Assignment}},
* über den {{Manual_Windowcaption|[[Project_Explorer_DMXC3|Project Explorer]]}} und zwar unter dem Eintrag {{Manual_Fields|Settings}} oder
* ein weiteres Mal über Menü, hier jedoch über die Einträge {{Manual_MenuText|Settings|Settings}}, wo man in dem sich öffnenden Fenster ebenfalls den Eintrag {{Manual_Windowcaption|Input Assignment}} findet.

Auch dieses Fenster lässt sich über das [[Panelkonzept_DMXC3|Panelsystem]] frei in DMXControl positionieren und kann so bei genügend Platz auf dem Bildschirm die ganze Zeit geöffnet bleiben.

==Aufbau der Oberfläche==
Das Fenster des {{Manual_Windowcaption|Input Assignment}} ist in zwei Bereiche aufgeteilt. Es besteht aus den beiden Verzeichnisbäumen für die Inputs (Input-Baum) und Outputs (Output-Baum) sowie aus der Bereich mit Tabellen- bzw. Graphenansicht.

===Input und Output-Bäume===
Im linken Verzeichnisbaum sind alle Inputs aufgeführt. Der rechte Baum zeigt alle Outputs, an die Informationen und Aktionsaufforderungen geschickt werden können. Mit den Textfeldern oberhalb der Verzeichnisbäume für die Inputs und Outputs können bestimmte Inputs bzw. Outputs gesucht und aus dem Baum herausgefiltert werden.

===Tabellenansicht===
Die Tabelle listet alle angelegten Verbindungen zwischen Inputs und Outputs auf. Über der Tabelle befinden sich die Schnellzugriffe zum Bearbeiten von Verbindungen und Bänken. In der Tabelle gibt es bis zu vier Spalten:

{| class="wikitable toptextcells"
|-
! style="width: 5em" | Name !! style="width: 40em" | Beschreibung !! style="width: 40em" | Hinweis
|-
| '''Active''' || Deaktiviert oder aktiviert ein Connectionset dauerhaft innerhalb einer Bank. || Einzelne Connectionsets können nur manuell deaktiviert und aktiviert werden.
|-
| '''Name''' || Freie Beschreibung des Connectionset. || Es empfiehlt sich, für jedes Connectionset einen eindeutigen Namen zu vergeben, um mit Hilfe der Log-Dateien des Kernels eventuelle Fehler identifizieren zu können.
|-
| '''Input''' || Auflistung der verwendeten Inputs.
|-
| '''Node''' ||
|-
| '''Output''' || Auflistung der verwendeten Outputs.
|}

Sollte eine Verbindung orange markiert werden, so ist beim Anlegen ein Fehler aufgetreten. Das bedeutet, dass der Eingang mit dem Ausgang nicht direkt verbunden werden kann. Um den Fehler zu korrigieren, muss man in die Graphenansicht wechseln und die Verbindung ggf. unter Verwendung zusätzlicher Nodes manuell hinzufügen.

[Screenshot IA]

Die oberhalb der Tabelle befindliche Menüleiste hat folgende Einträge und Funktionen:

{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
! style="width: 15em" | Befehl / Menüeintrag !! style="width: 5em" | Icon !! Beschreibung
|- class="hintergrundfarbe5"
| colspan="3" | '''Bank'''
|-
| {{Manual_MenuText|Add}} || || Fügt eine neue Bank hinzu.
|-
| {{Manual_MenuText|Delete}} || || Löscht die ausgewählte Bank.
|-
| {{Manual_MenuText|Rename}} || || Benennt die aktuelle Bank um.
|-
| {{Manual_MenuText|Active}} || || Aktiviert / deaktiviert die akutelle Bank.
|- class="hintergrundfarbe5"
| colspan="3" | '''Connectionset'''
|-
| {{Manual_MenuText|Add}} || || Legt in der aktuellen Tabelle ein neue Verbindung mit den links im Baum ausgewählten Input und Output an.
|-
| {{Manual_MenuText|Add empty}} || || Legt in der aktuellen Tabelle ein neue leere Verbindung an.
|-
| {{Manual_MenuText|Delete}} || || Löscht die selektierte Verbindung.
|-
| {{Manual_MenuText|Move}} || || Verschiebt die selektierte Verbindung zur ausgewählten Bank.
|-
| {{Manual_MenuText|Clone}} || || Löscht die selektierte Verbindung.
|- class="hintergrundfarbe5"
| '''Show graph''' || || Schaltet von der Tabellenansicht in die Graphenansicht des selektierten Graphens.
|}

==Graphenansicht==
Die Graphenansicht ist zur Anpassung und Erweiterung von Verbindungen. Um diese aufzurufen, selektiert man die zu bearbeitende Zeile und klickt oben in der Menüleiste auf {{Manual_Buttons|Show Graph}} oder macht einen Doppelklick auf das graue Feld der Zeile.

In der Graphenansicht wird nun die automatisch generierte Funktion angezeigt, die meist aus den Eingang, ggf. einem Converter und einem Ausgang besteht. Alle Elemente sind durch eine Linie, dem Link verbunden. Natürlich sind die Elemente nur zu sehen, wenn in die zugehörige Zeile in der Tabellenansicht bereits mit Inhalt gefüllt ist. Sollte ein leeres Connectionset angelegt worden sein, findet man natürlich eine leere Graphenansicht vor.

Egal, ob ein Connectionset (weitestgehend) automatisch erzeugt wurde oder ob man direkt mit einem leeren Connectionset startet und sich dieses in der Graphenansicht anschaut: man kann jederzeit weitere Nodes hinzufügen. Welche Nodes euch DMXControl 3 zur Verfügung stellt und welche Funktion diese haben, findet man im nächsten Kapitel.

==Arbeitsweise des Input Assignment==
===Anlegen einer neuen Verbindung===
Zuerst muss im In- und Output-Baum die das entsprechende Node gesucht werden. Ein Node kann ein Button, ein Fader, oder auch ein Eigenschaft einer Cuelist wie zum Beispiel Go sein. Jedes Node hat am Anfang einen blauen Pfeil. Um eine Verbindung anzulegen, muss nun ein Input Node auf ein Output Node per ''Drag & Drop'' gezogen werden. In der geöffneten Bank wird nun die neue Verbindung angezeigt.

===Ändern einer vorhandenen Verbindung===
Möchte man ein vorhandenes Conncectionset ändern, muss man in die Graphenansicht wechseln. Dort besteht die Möglichkeit, per ''Drag & Drop'' aus dem Input-Baum heraus direkt einen anderen Input in die Graphenansicht zu ziehen, wie zum Beispiel einen anderen Button, und auf dem bereits vorhandenen Button ablegen. Es wird daraufhin sofort der neue Name des Inputs angezeigt. Gleichermaßen geht man vor, wenn man einen Output ersetzen möchte.

{{BoxHinweis|Text=Man kann nicht nur einen Button durch einen Button, sondern auch einen Button durch einen Fader ersetzten. In diesem Fall muss man unter Umständen den nachfolgenden Node wie den Rule of Three oder den Binary Switcher anpassen, damit das Connectionset weiterhin funktioniert.}}

Anders verhalten sich die Nodes auf dem Bereich-Wrapper, das heißt Nodes wie Cuelist, Speedmaster oder Executor. Hier ändert man in den Einstellung das verlinkte Element. Dies ist besonders von Vorteil, wenn man einen Node mit vielen Ein- und Ausgängen korrigieren möchte. Die Verbindungen auf der Seite des Input Hubs und des Output Hubs bleiben erhalten.

Eine letzte Möglichkeit ist, den neuen Input, Output oder Node in der Tabellenansicht auf die entsprechende Zeile zu ziehen und dann in die Graphenansicht zu wechseln. Die zusätzlichen Elemente sind dann frei in der Graphenansicht platziert und müssen dann verknüpft werden. Nicht verwendete Elemente am besten wieder aus dem Connectionset löschen.

===Duplizieren (klonen) einer Verbindung===
Das Kopieren und Einfügen von Verbindungen ist nicht vorgesehen. Stattdessen dupliziert bzw. klont man eine vorhandene Verbindung. Diese Funktion ist über das Kontextmenü zu der zuvor ausgewählten Verbindung erreichbar. Die duplizierte (geklonte) Verbindung erkennt man an dem Zusatz im Namen "Copy of".

{{BoxHinweis|Text=Um ungewollte Seiteneffekte nach dem Duplizieren einer Verbindung zu vermeiden, ist jede duplizierte Verbindung zu erst einmal deaktiviert. Bei deaktivierten Verbindungen arbeitet auch die Vorschau der Werte an den Ein- und Ausgängen nicht.}}

=Funktionen=
==Bänke==
In einer Bank können Verbindungen gruppiert werden. Dies hat folgende Vorteile:
* die Übersicht bleibt vor allem in wachsenden Projekt erhalten
* jede Bank kann mit allen Verbindung sowohl direkt im {{Manual_Windowcaption|Input Assignment}}, aber auch über das Node [[Bank_(Input_Assignment)_DMXC3|Bank]] zum Beispiel über das {{Manual_Windowcaption|[[Softdesk_DMXC3|Softdesk]]}} aktiviert und deaktiviert werden.

Am Beispiel der Tastatursteuerung dürfte der Vorteil eines systematischen Aufteilens von Connectionsets auf verschiedene Bänke deutlich werden. Man hat diverse Tasten auf bestimmte Funktionen gelegt und möchte aber eine Cue beschriften. Beim Tippen würden zunächst die Funktionen ausgeführt werden, die vorher festgelegt wurden sind. Dies könnte in einer laufenden Show stören. Hier kommt nun die Bank zum Einsatz. Hat man alle Tastaturbefehle in einer Bank mit dem Titel "Tastatur" abgelegt, könnte diese per {{Manual_Windowcaption|Softdesk}} oder einer bestimmten Tastenkombination nun aktiviert oder deaktiviert werden, um seine Eingaben durchführen zu können, ohne dabei die Live-Show zu stören.

==Nodes==
===Converter===
{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
! style="width: 10em" | Node !! style="width: 5em" | DMXC-Version !! Kurzbeschreibung
|- class="hintergrundfarbe5"
| colspan="3" | '''Nicht weitergehend kategorisiert'''
|-
| [[Beat_to_Bool_(Input_Assignment)_DMXC3|Beat to Bool]] || 3.2.0
| Wandelt das Beat Signal (zum Beispiel des Manual Beat) in ein binäres Signal.
|-
| [[Bitmap_from_Ressource_(Input_Assignment)_DMXC3|Bitmap from Ressource]] || 3.2.0
| Lädt eine Bitmap-Datei (*.bmp-Datei) aus dem Ordner Files im Project Explorer.
|-
| [[Color_to_RGB_(Input_Assignment)_DMXC3|Color to RGB]] || 3.2.0
| Wandelt einen Farbwert in einzelne RGB-Werte um.
|-
| [[Draw_Bitmap_(Input_Assignment)_DMXC3|Draw Bitmap]] || 3.2.0
| Generiert ein Bitmap.
|-
| [[Format_(Input_Assignment)_DMXC3|Format]] || 3.2.0
| Formatiert einzelne Werte oder setzt einen Text aus mehreren Bausteinen zusammen.
|-
| [[HSV_to_Color_(Input_Assignment)_DMXC3|HSV to Color]] || 3.2.0
| Wandelt die drei Eingänge für Hue, Saturation und Value in einen Farbwert um.
|-
| [[Position_to_Pan/Tilt_(Input_Assignment)_DMXC3|Position to Pan/Tilt]] || 3.2.0
| Wandelt den Position-Eingang in ein getrenntes Pan- und ein Tilt-Signal um.
|-
| [[Split_(Input_Assignment)_DMXC3|Split]] || 3.2.0
| Teilt einen beliebigen Eingangswert die RGB oder Position in seine Einzelteile auf.
|}

===Logic===
{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
! style="width: 10em" | Node !! style="width: 5em" | DMXC-Version !! Kurzbeschreibung
|- class="hintergrundfarbe5"
| colspan="3" | '''Flip-Flop'''
|-
| [[RS-Flip-Flop_(Input_Assignment)_DMXC3|RS-Flip-Flop]] || 3.2.0
|
|-
| [[T-Flip-Flop_(Input_Assignment)_DMXC3|T-Flip-Flop]] || 3.2.0
|
|- class="hintergrundfarbe5"
| colspan="3" | '''Nicht weitergehend kategorisiert'''
|-
| [[Binary_Switcher_(Input_Assignment)_DMXC3|Binary Switcher]] || 3.2.0
|-
| [[Compare_(Input_Assignment)_DMXC3|Compare]] || 3.2.0
|-
| [[Counter_(Input_Assignment)_DMXC3|Counter]] || 3.2.0
|-
| [[Delay_(Input_Assignment)_DMXC3|Delay]] || 3.2.0
|-
| [[Draw_Bitmap_(Input_Assignment)_DMXC3|Draw Bitmap]] || 3.2.0
|-
| [[Input_Selector_(Input_Assignment)_DMXC3|Input Selector]] || 3.2.0
|-
| [[Logic_(Input_Assignment)_DMXC3|Logic]] || 3.2.0
|-
| [[Math_(Input_Assignment)_DMXC3|Math]] || 3.2.0
|-
| [[Output_Selector_(Input_Assignment)_DMXC3|Output Selector]] || 3.2.0
|-
| [[Rule_of_Three_(Input_Assignment)_DMXC3|Rule of Three]] || 3.2.0
|-
| [[Schmittrigger_(Input_Assignment)_DMXC3|Schmittrigger]] || 3.2.0
|-
| [[Selector_(Input_Assignment)_DMXC3|Selector]] || 3.2.0
|}

===Wrapper===
Die angezeigten Informationen erhalten sie aus dem zugeordneten Element selbst, welche somit vor allem in Hinblick auf den Output Hub ein echtes Feedback darstellen. Die Zuordnung zu einer Cuelist oder einem Executor (also alle Nodes aus dem Bereich Wrapper) können zusätzlich zur Laufzeit geändert werden.

{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
! style="width: 10em" | Node !! style="width: 5em" | DMXC-Version !! Kurzbeschreibung
|- class="hintergrundfarbe5"
| colspan="3" | '''Cuelists'''
|-
| [[Cue_(Input_Assignment)_DMXC3|Cue]] || 3.2.0
| Liest die Eigenschaften der parametrierten Cue aus.
|-
| [[Cuelist_(Input_Assignment)_DMXC3|Cuelist]] || 3.2.0
| Triggern der parametrierten Cuelist und auslesen dessen Zustände.
|- class="hintergrundfarbe5"
| colspan="3" | '''Devices'''
|-
| [[Device_(Input_Assignment)_DMXC3|Device]] || 3.2.0
| Geräte selektieren und dessen Eigenschaften abgefragen.
|-
| [[Device_Group_(Input_Assignment)_DMXC3|Device Group]] || 3.2.0
| Gerätegruppen selektieren und dessen Eigenschaften abgefragen.
|-
| [[Selected_Device_Group_DMXC3|Selected Device Group]] || 3.2.0
| Ausgabe des aktuell selektierten Geräts oder der selektierten Gruppe.
|- class="hintergrundfarbe5"
| colspan="3" | '''Executors'''
|-
| [[Dynamic_Executor_(Input_Assignment)_DMXC3|Dynamic Executor]] || 3.2.0
| Executor der aktuell ausgewählten Executor Page steuern und die anliegenden Zustande auslesen.
|-
| [[Executor_(Input_Assignment)_DMXC3|Executor]] || 3.2.0
| Steuern eines bestimmten Executors bzw. dessen aktuelle Zustände auslesen.
|-
| [[Executor_Page_(Input_Assignment)_DMXC3|Executor Page]] || 3.2.0
| Ausgabe der aktuellen Zustände der parametrierten Executor Page.
|-
| [[Selected_Executor_Page_(Input_Assignment)_DMXC3|Selected Executor Page]] || 3.2.0
| Auswählen oder umschalten einer Executor Page ausgewählt und es wird die aktuell selektierte Page ausgegeben.
|- class="hintergrundfarbe5"
| colspan="3" | '''Generals'''
|-
| [[Blackout_(Input_Assignment)_DMXC3|Blackout]] || 3.2.0
| Aktivieren und deaktivieren des [[Blackout_DMXC3|Blackouts]] und Ausgabe des aktuellen Zustands.
|-
| [[Freeze_(Input_Assignment)_DMXC3|Freeze]] || 3.2.0
| Aktivieren und deaktivieren des [[Freeze_DMXC3|Freeze]] und Ausgabe des aktuellen Zustands.
|-
| [[Highlight_(Input_Assignment)_DMXC3|Highlight]] || 3.2.0
| Aktivieren und deaktivieren der [[Highlight_DMXC3|Highlight]]-Funktion und Ausgabe des aktuellen Zustands.
|- class="hintergrundfarbe5"
| colspan="3" | '''Masters'''
|-
| [[Grand_Master_(Input_Assignment)_DMXC3|Grand Master]] || 3.2.0
| Steuern des Grand Masters und abfragen seines Zustands.
|-
| [[Group_Master_(Input_Assignment)_DMXC3|Group Master]] || 3.2.0
| Steuern des eingestellten Group Masters und abfragen seines Zustands.
|-
| [[Parameter_Master_(Input_Assignment)_DMXC3|Parameter Master]] || 3.2.0
| Steuern des eingestellten Parameter Masters und abfragen seines Zustands.
|-
| [[Speed_Master_(Input_Assignment)_DMXC3|Speed Master]] || 3.2.0
| Steuern des eingestellten Speed Masters und abfragen seines Zustands.
|- class="hintergrundfarbe5"
| colspan="3" | '''Nicht weitergehend kategorisiert'''
|-
| [[Bank_(Input_Assignment)_DMXC3|Bank]] || 3.2.0
| Aktivieren und deaktivieren einer Bank bzw. auslesen der aktuellen Informationen der Bank.
|-
| [[Programmer_(Input_Assignment)_DMXC3|Programmer]] || 3.2.0
| Bedienen des Programmers und auslesen des Filter Modus.
|}

==Inputs & Outputs==
{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
! style="width: 10em" | Gruppe !! style="width: 10em" | Node !! style="width: 10em" | Wertebereich !! Beschreibung
|- class="hintergrundfarbe5"
| colspan="4" | '''Inputs'''
|-
| '''Electricity''' || Overload || low / high || Geht auf High, sobald ein Stromkreis im Electricity Management überlastet ist.
|-
| '''DMX In''' || 1 / 2 || 0 - 255 || Der Ordner 1 bzw. 2 gibt das Universum an und die 1.1 ist dann die DMX Adresse 1 im Universum 1.
|-
| '''Beat''' || Manual Beat || low / high || gibt den Beat aus dem Manual Beat an.
|-
| '''Keyboard'''
|-
| rowspan="4" | '''Softdesk''' || Buttons || low / high || Es wird der Zustand eines Buttons ausgegeben, wobei low für nicht gedrückt und high gedrückt steht.
|-
| Slider || 0-100 || Gibt die aktuelle Stellung des Faders als Wert aus.
|-
| ColorBar || HSV || Übergibt den Farbwert als RGB-Werte.
|-
| Position || Position ||
|-
| '''Bank'''
|-
| '''Dynamic Executor'''
|-
| '''Programmer'''
|-
| '''Master'''
|}

=Tipps und Trick=
==Programmer im Input Assignment==

=Beispiele=

DDF DMXC3

2018-01-06T16:21:40Z

Pgrote: /* Verfügbare Procedures */

{{Kapitelüberschrift|Version=DMXControl 3.1.1}} {{Inuse}}

{{NavigationTop-Man3
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}

==Hintergrund: Wofür werden DDFs benötigt?==
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.

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<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. }}

==Speicherort: Wo sind die DDFs zu finden?==
Die DDFs von DMXControl 3 sind lokal auf dem PC in folgendem Verzeichnis zu finden:
 
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\
</source>
 
[Installationsverzeichnis] steht hierbei für das Verzeichnis, in dem DMXControl 3 installiert wurde. Wurde dies beim Installieren nicht geändert, lautet der Pfad üblicherweise
 
<source lang="xml">
C:\Programme (x86)\DMXControl3\
</source>
 
Das Bild für das Icon des Geräts in der Stage View liegt immer im Verzeichnis
 
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\images\
</source>
 
und die Icons der Gobos unter
 
<source lang="xml">
[Installationsverzeichnis]\kernel\icons
</source>
 
==Struktur: Wie ist ein DDF aufgebaut?==
Das DDF für DMXControl 3 besteht aus vier Teilen:
* '''Basisteil''' mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
* '''Informationsteil''' mit Angaben zum Gerät, Hersteller, Autor sowie DMX-Modus
* '''Funktionsteil''' mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
* '''Procedures-Teil''' für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten
 
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3" ddfversion="1" subdevice="no">
<information>
...
</information>
<functions>
...
</functions>
<procedures>
...
</procedures>
</device>
</source>
 
Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die GUI, damit alle Steuerelemente wie das Device Control und die Controls richtig dargestellt werden. Des Weiteren greift die HAL auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den Cues eines Projekts abzuspeichern.

===Inhalt der vier Teile innerhalb des DDFs===
====Basisteil====
Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element <code>device</code> enthalten. Der Tag <code>device</code> umfasst folgende Attribute:

{| class="wikitable toptextcells"
|-
! Attribut !! Beschreibung !! Standard-Wert !! Zulässige Werte !! Optional
|-
|style="width: 10em"| <code>image</code>
|style="width: 30em"| Bild-Datei des DDFs
|style="width: 10em"| Nicht vorhanden
|style="width: 20em"| Dateiname des Bilds als *.png-Datei
|style="width: 10em"|
|-
| <code>type</code>
|
| <code>DMXDevice</code>
| DMXDevice
|
|-
| <code>dmxaddresscount</code>
| Gesamtzahl der DMX-Kanäle des Geräts
| Nicht vorhanden
| Ganze Zahlen von 1 bis 512
| X
|-
| <code>dmxcversion</code>
| Erforderliche Programmversion zur Verwendung des DDFs
| <code>3</code>
| 3, 3.0.1, 3.0.2, 3.1, 3.1.1 und alle zukünftigen Programmversion
|
|-
| <code>ddfversion</code>
| Version des DDFs
| Nicht vorhanden
| 1, 1.1, 1.2 usw.
|
|-
| <code>subdevice</code>
| Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer
| <code>No</code>
| No oder yes
| X
|-
| <code>defaultdisplaystyle</code>
| Standart Anzeige-Modus in der StageView
| <code>preview</code>
| custom, image ober preview
| X
|-
| <code>defaultdisplaycolor</code>
| Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes
| <code>#ffffff</code>
| Jede HTML-Farbe (#000000 - #ffffff)
| X
|-
| <code>whitechanneldefaultmode</code>
| Das Verhalten, wie der White-Kanal angesprochen wird
| <code>onlywhite</code>
| none, addwhite oder onlywhite
| X
|}

Das Element <code>device</code> 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 Stage View ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.

====Informationsteil====
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 Device Manager. Alle Angaben werden durch das Element <code><information> ... </information></code> eingeklammert.

{| class="wikitable toptextcells"
|-
! Tag !! Beschreibung !! Optional
|-
|style="width: 10em"| <code>model</code>
|style="width: 30em"| Bezeichnung des Geräts gemäß Bedienungsanleitung
|style="width: 10em"|
|-
| <code>vendor</code>
| Hersteller des Geräts gemäß vorgegebener Herstellerliste
|
|-
| <code>author</code>
| Autor des DDFs
|
|-
| <code>mode</code>
| DMX-Modus bzw. Kanalbelegung
| X
|-
| <code>comment</code>
| Kommentar zum DDF oder Gerät
| X
|}

====Funktionsteil====
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 <code><functions> ... </functions></code> 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 Cues abgespeichert werden und lassen sich nur über die Stage View aufrufen.

===Gemeinsamkeiten der Funktionen===
====Genauigkeit bzw. Auflösung von Funktionen====
Auf jedem DMX-Kanal können insgesamt 256 verschiedene Werte übertragen werden und zwar im Bereich von DMX-Wert 0 bis DMX-Wert 255. Dies beschreibt die klassische Auflösung bzw. Genauigkeit eines DMX-Kanals von 8 bit.
Um bei bestimmten Funktionen wie zum Beispiel bei Pan, Tilt oder beim Dimmer feine Auflösungen zu erzielen, werden weitere DMX-Kanäle hinzugezogen, um die Auflösung zu erhöhen. In diesem Fall spricht man dann von einer Auflösung mit 16 bit oder der zweite DMX-Kanal für die Pan-Funktion wird mit Pan fine bezeichnet.
DMXControl 3 unterstützt aktuell Auflösungen von Funktionen bis 32 bit. Für hierfür werden dann vier DMX-Kanäle zusammengefasst, um die Funktion in dieser Auflösung darzustellen. In den DDFs kommen dabei folgende Bezeichnungen zum Einsatz:
* <code>dmxchannel</code> für 8-bit-Auflösung
* <code>finedmxchannel</code> für 16-bit-Auflösung
* <code>ultradmxchannel</code> für 24-bit-Auflösung
* <code>ultrafinedmxchannel</code> für 32-bit-Auflösung
Es ist dabei zu beachten, dass bei der 32-bit-Auflösung auch alle vier DMX-Kanäle anzugeben sind. Es ist mitunter nicht unüblich, dass die vier DMX-Kanäle in der Belegung nicht direkt hintereinander angeordnet sind. Die folgende Tabelle zeigt die Definition der aktuell möglichen Auflösungen anhand des Dimmers.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
| style="width: 10em" rowspan="4" | <code>dimmer</code>
| style="width: 10em" | Dimmer mit 8-bit-Auflösung
| style="width: 60em" | <source lang="xml">
<dimmer dmxchannel="0" />
</source>
Dimmer auf DMX-Kanal 1
|-
| Dimmer mit 16-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" />
</source>
Dimmer mit 16-bit-Auflösung auf DMX-Kanal 1 und 2
|-
| Dimmer mit 24-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" />
</source>
Dimmer mit 24-bit-Auflösung auf DMX-Kanal 1, 2 und 3
|-
| Dimmer mit 32-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" ultrafinedmxchannel="3" />
</source>
Dimmer mit 32-bit-Auflösung auf DMX-Kanal 1, 2, 3 und 4
|}

====Aufbau einer Funktion auf einem DMX-Kanal====
Liegen auf einem DMX-Kanal wie beispielsweise beim Strobe, Shutter oder Goborad mehrere Funktionen, so werden diese in zwei Kategorien unterteilt:
* <code>step</code> für Funktionen, die immer nur umgeschaltet werden, zum Beispiel das Wechseln der Farbe auf einem Farbrad
* <code>range</code> für Funktionen, die parallel zum Umschalten auch noch in bestimmten Bereichen variiert werden können, wie zum Beispiel die Richtung und die Geschwindigkeit der Goborotation
Ein <code>step</code> besteht dabei immer aus dem eigentlichen Tag <code>step</code>, dem Attribut <code>type</code>, sowie den Attributen für den minimalen DMX-Wert <code>mindmx</code> und den maximalen DMX-Wert <code>maxdmx</code> für den <code>step</code>. Der Wert für das Attribut <code>type</code> ist immer abhängig von der Eigenschaft des DMX-Kanals, die abgebildet werden soll. Welche Werte zulässig sind, wird bei der Beschreibung der jeweiligen Eigenschaft angegeben.
 
<source lang="xml">
<step type="open" mindmx="225" maxdmx="255" />
</source>
 
Der Tag <code>range</code> ist ähnlich aufgebaut, wie der Tag <code>step</code>. Der wesentlichste Unterschied ist die Ergänzung der Attribute <code>minval</code> und <code>maxval</code>. Hier werden beispielsweise die minimale und maximale Drehzahl für die Goborotation angegeben.

Die Besonderheit ist an dieser Stelle, dass die DMX-Werte den Geschwindigkeiten zugeordnet werden. Das heißt, zur minimalen Drehzahl wird der DMX-Wert eingetragen, wo sich das Gobo am langsamsten dreht. Genauso verhält es sich mit der maximalen Drehzahl. Daher kann es vorkommen, dass die minimale Drehzahl nicht immer automatisch auch der niedrige DMX-Wert und die maximale Drehzahl beim größten DMX-Wert anliegt. Ein Code-Beispiel ist im Abschnitt Goborad zu finden.
 
<source lang="xml">
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
</source>
 
===Grundregeln bei der Erstellung eines DDFs===
Bei den DDFs sind folgende grundlegenden Regeln zu beachten:
* Die DMX-Kanäle werden in den DDFs immer bei 0 beginnend gezählt. Deswegen sind für einen LED-PAR mit 5 DMX-Kanälen im DDF auch die DMX-Kanäle 0 bis 4 angegeben, während die Funktionen in der Bedienungsanleitung von DMX-Kanal 1 bis 5 beschriftet sind.
* Die Bezeichnung der Geräte beschränkt sich nur auf die Bezeichnung selbst, wie sie auf dem Deckblatt des Handbuchs steht. Zusätzliche Angaben wie beispielsweise der DMX-Modus / Kanalbelegung oder sonstige Kommentare sind dort nicht zu hinterlegen.
* Die Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Goborotation etc. erfolgt ohne Einheiten. Die üblichen Einheiten für diese Werte sind in der nachfolgenden Tabelle aufgelistet.
* Die zugehörigen DMX-Werte zum Beispiel für die Drehzahl der Goborotation sind so einzutragen, dass von dem Punkt Goborotation stopp aus die Drehzahlen vor und entgegen des Uhrzeigersinns zunehmen.
* Bilder für das Geräte-Icon sowie für die Gobos sollen in einer Auslösung von 128 x 128 Pixeln und als *.png-Datei im DDF hinterlegt werden.
* Die DDFs werden üblicherweise in englischer Sprache verfasst.

{| class="wikitable toptextcells"
|-
! Wert !! Einheit !! Verwendung
|-
|style="width: 10em"| Drehzahl
|style="width: 10em"| <code>1/s</code> 
(Umdrehung pro Sekunde)
| Goborotation, Prismenrotation, kontinuierliche Drehung des Farbrads, kontinuierliche Drehung des Goborads
|-
| Farbtemperatur
| <code>K</code> 
(Kelvin)
| Farbtemperatur
|-
| Frequenz
| <code>Hz</code> 
(Hertz)
| Strobe-Frequenz, Goboshake-Geschwindigkeit
|-
| Winkel
| <code>°</code> 
(Grad)
| Pan- und Tilt-Schwenkbereich, Goboindizierung, Prismenindizierung, Zoom
|-
| Einheitslos
| <code>%</code> 
(Prozent)
| Dimmer, Iris
|}

==Syntax: die möglichen Funktions-Bausteine==
Nachfolgend sind alle aktuell unterstützten Funktionen aufgelistet, die von DMXControl direkt unterstützt werden. Jede Funktion ist mit einem Codebeispiel versehen, der wiederum in Klartext übersetzt ist.

===Dimmer===
Über den Dimmer-Kanal wird die Helligkeit eines Geräts gesteuert. LED-PAR-Scheinwerfer oder Moving-Heads haben meistens nur einen Dimmerkanal. Je nach Ausführung sind von der Standard-Auflösung mit 8 bit feiner Auflösung bis hin zu 32 bit möglich. Dazu wird das Element auf <code><dimmer dmxchannel="0" finedmxchannel="1" ultraddmxchannel="2" ultrafinedmxchannel="3" /></code> erweitert. Die entsprechende Berechnung, wie welcher DMX-Kanal anzusteuern ist, übernimmt DMXControl automatisch.

Dimmerpacks besitzen im Gegensatz zu LED-PARs, Scannern oder Moving-Heads mehrere Dimmer-Kanäle. Hier ist es aber nicht erforderlich, das Dimmerpack mit seinen vier, sechs oder zwölf Dimmer-Kanälen selbst abzubilden. Hilfreicher und einfacher ist es an dieser Stelle, die daran angeschlossenen Halogen-PAR-Scheinwerfer in entsprechender Anzahl dem Projekt hinzufügen.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
| style="width: 10em" rowspan="3" | <code>dimmer</code>
| style="width: 10em" | Standard
| style="width: 60em" | <source lang="xml">
<dimmer dmxchannel="0" />
</source>
Dimmer auf DMX-Kanal 1
|-
| Dimmer mit 16 bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" />
</source>
Dimmer mit 16-bit-Auflösungen auf DMX-Kanal 1 und 2
|-
| Einfacher Dimmer in bestimmtem DMX-Wertebereich
| <source lang="xml">
<dimmer dmxchannel="0">
<range type="linear" mindmx="0" maxdmx="127" minval="0" maxval="100" />
</dimmer>
</source>
Dimmer auf DMX-Kanal 1:
* Lineares Dimmverhalten von 0% Helligkeit (aus) bei DMX-Wert 0 bis maximale Helligkeit (100%) bei DMX-Wert 127
|}

===Switch===
Die Funktion <code>switch</code> wird immer dann eingesetzt, wenn es nur zwischen zwei Zuständen hin- und her geschaltet werden soll, beispielsweise der Zustand "Arbeitslicht an" und der Zustand "Arbeitslicht aus".

Bei diesem Element müssen abgesehen vom DMX-Kanal keine weiteren Angaben vorgenommen werden. DMXControl 3 gibt bei einem Helligkeitswert von kleiner 50% automatisch einen DMX-Wert von 0 aus und bei Helligkeitswerten über 50% automatisch einen DMX-Wert von 255.

Es empfiehlt sich, diese Funktion tatsächlich nur bei einem Switch-Pack einzusetzen. Zum Aktivieren eines weiteren Betriebsmodus, wie zum Beispiel die Sound-to-Light-Steuerung, ist das <code>rawstep</code>-Element besser geeignet.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>switch</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<switch dmxchannel="0" />
</source>
Switch auf DMX-Kanal 1
|}

===Shutter===
Der Shutter ist meistens bei Moving-Heads oder Scannern mit einer Entladungslampe zu finden. Hierbei werden mechanische Blenden in den Lichtstrahl geschoben, wenn das Gerät kein Licht ausgeben soll. Darüber hinaus wird über den Shutter der Strobe-Effekt erzeugt. Bei Moving-Heads oder Scannern mit LEDs als Lichtquelle wird dieses Verhalten über die Elektronik nachgestellt.

In der Regel sind beim Shutter-Kanal mehrere Funktionen zu hinterlegen, mindestens aber die Funktionen Shutter geschlossen und Shutter offen.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>shutter</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<shutter dmxchannel="0">
<step type="closed" mindmx="0" maxdmx="21" />
<step type="open" mindmx="234" maxdmx="255" />
</shutter>
</source>
Shutter auf DMX-Kanal 1:
* Shutter geschlossen bei DMX-Wert zwischen 0 und 21.
* Shutter geöffnet bei DMX-Wert zwischen 234 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Unterer DMX-Wert für den Zustand
|style="width: 10em"| Oberer DMX-Wert für den Zustand
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>closed</code> 
<code>open</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

===Strobe===
====Basis-Funktionen====
Beim Strobe-Kanal können beliebig viele Funktionen wie zum Beispiel verschiedene Strobe-Effekte hinterlegt werden. Folgende Strobe-Effekte sind hierbei üblich:
* <code>linear</code>: Strobe-Frequenz nimmt stetig zu bis hin zu einem fast dauerhaften Leuchten
* <code>pulse</code>: Pulsierender Strobe-Effekt
* <code>random</code>: Blitze werden in zufälligen Zeitabständen mit zunehmender Intensität erzeugt
* <code>ramp up</code>: Blitze werden zunehmen heller bis zum Maximalwert und gehen dann abrupt aus
* <code>spikes</code>: Es werden einzelne Blitze erzeugt

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>strobe</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="89" minval="1" maxval="12" />
<range type="pulse" mindmx="90" maxdmx="172" minval="0.5" maxval="6" />
<range type="random" mindmx="173" maxdmx="255" minval="1" maxval="12" />
</strobe>
</source>
Strobe auf DMX-Kanal 1:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe mit der Geschwindigkeit ansteigend von 1 Hz bei DMX-Wert 6 bis 12 Hz bei DMX-Wert 89.
* Pulsierender Strobe bei DMX-Wert zwischen 90 und 172 mit Geschwindigkeit von 0,5 Hz bis 6 Hz.
* Zufälliges Strobe bei DMX-Wert zwischen 173 und 255 mit Geschwindigkeit von 1 Hz bis 12 Hz.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Strobe-Frequenz
|style="width: 10em"| DMX-Wert für die maximale Strobe-Frequenz
|style="width: 10em"| Minimale Strobe-Frequenz
|style="width: 10em"| Maximale Strobe-Frequenz
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code> 
<code>pulse</code> 
<code>random</code> 
<code>ramp up</code> 
<code>ramp down</code> 
<code>ramp up/down</code> 
<code>lightning</code> 
<code>spikes</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 Hz bis 50 Hz</code>
| <code>0 Hz bis 50 Hz</code>
|}

====Unterfunktionen====
Für einzelne Funktionen des Strobe-Kanals sind folgende Unterfunktionen möglich:
* <code>strobetype</code>: Auswahl des Strobeeffekts über einen getrennten DMX-Kanal

=====Strobetype=====
Über den <code>strobetype</code> wird der Strobeeffekt über einen separaten DMX-Kanal ausgewählt. Diese Funktion steht meistens dann zur Verfügung, wenn das Gerät viele verschiedene Strobeeffekte erzeugen kann und in diesem Zusammenhang die Strobefrequenz weiterhin genau eingestellt werden soll.
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>strobe</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<strobetype dmxchannel="1" />
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
<step handler="strobetype" mindmx="6" maxdmx="42" />
</range>
<range type="random" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
<step handler="strobetype" mindmx="43" maxdmx="85" />
</range>
</strobe>
</source>
Strobe-Frequenz auf DMX-Kanal 1, Strobe-Effekt auf DMX-Kanal 2:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 0,5 Hz bis 25 Hz, bei einem DMX-Wert zwischen 6 und 42 auf DMX-Kanal 2.
* Zufälliger Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 0,5 Hz bis 25 Hz, bei einem DMX-Wert zwischen 43 und 85 auf DMX-Kanal 2.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert
|style="width: 10em"| Maximaler DMX-Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>strobetype</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

====Ergänzende Funktionen====
Für den gesamten Strobe-Kanal sind folgende ergänzende Funktionen möglich:
* <code>duration</code>: Einstellen der Leuchtdauer eines einzelnen Blitzes

=====Duration=====
Über die <code>durartion</code> wird die Länge der Leuchtdauer eines einzelnen Blitzes eingestellt. Die maximale Leuchtdauer korrespondiert dabei mit der Strobe-Frequenz. Bei bestimmten Kombinationen von Strobe-Frequenz und Leuchtdauer wird sofern technisch möglich ein Dauerleuchten erzeugt.
{| class="wikitable toptextcells"
|-
! Sub-Tag !! Variante !! Code
|-
|style="width: 10em"| <code>duration</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="255" minval="1" maxval="12" />
<duration dmxchannel="1" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="650" />
</duration>
</strobe>
</source>
Strobe-Frequenz auf DMX-Kanal 1, Blitzdauer auf DMX-Kanal 2:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 1 Hz bis 12 Hz. Blitzdauer von 0 ms bis 650 ms über DMX-Kanal 2 im Bereich zwischen den DMX-Werten 0 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die kürzeste Einschaltdauer
|style="width: 10em"| DMX-Wert für die längste Einschaltdauer
|style="width: 10em"| Kürzeste Einschaltdauer
|style="width: 10em"| Längste Einschaltdauer
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 ms bis 2000 ms</code>
| <code>0 ms bis 2000 ms</code>
|}

===Farbe===
Alle Kanäle können durch wie hier am Beispiel für rote LEDs von der Standart-Auflösung mit 8 bit <code><red dmxchannel="0" /></code> auf eine Auflösung mit bis zu 32 bit <code><red dmxchannel="0" finedmxchannel="1" ultraddmxchannel="2" ultrafinedmxchannel="3" /></code> erweitert werden. Die entsprechende Berechnung, wie welcher DMX-Kanal anzusteuern ist, übernimmt DMXControl automatisch.

Bei allen Farbmischungs-Systemen werden ausgenommen von den Farben amber und ultraviolett jeweils nur die DMX-Kanäle angeben, wo sich welche Farbe befindet. Weitere Angaben sind hier nicht erforderlich.

====RGB-Farbmischung====
Die RGB-Farbmischung ist eine so genannte additive Farbmischung. Hierbei werden bei der Farbmischung verschiedene Farben hinzugenommen, um die gewünschte Mischfarbe zu erhalten. Daher muss man die Farben rot, grün und blau jeweils auf die maximale Helligkeit stellen, um die Farbe Weiß zu erhalten.
In DMXControl 3 sind aktuell folgende Farben verfügbar, die direkt von der HAL ohne weitere Anpassungen in einer Standard-Konfiguration unterstützt werden:
* <code>red</code>
* <code>lime</code>
* <code>amber</code>
* <code>green</code>
* <code>cyan</code>
* <code>blue</code>
* <code>indigo</code>
* <code>uv</code>
* <code>white</code>

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="3"| <code>rgb</code>
|style="width: 10em"| RGB
|style="width: 60em"| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
</rgb>
</source>
RGB-Farbmischung auf den Kanälen 1 bis 3, wobei der DMX-Kanal
* 1 die roten LEDs steuert
* 2 die grünen LEDs steuert
* 3 die blauen LEDs steuert
|-
| RGBW
| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<white dmxchannel="3" />
</rgb>
</source>
|-
| RGBA
| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<amber dmxchannel="3" />
</rgb>
</source>
|}

=====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 Stage View, kann unter dem Eintrag ''White Automix Mode'' das Verhalten für jedes Gerät einzeln angepasst werden:
* ''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ß

=====Arbeitsbereiche für zusätzliche LED-Farben=====
In DMXControl sind für die Arbeitsbereite der zusätzlichen LED-Farben standardmäßig im Programm hinterlegt, können aber vom Nutzer in den jeweiligen DDFs angepasst werden. Der Arbeitsbereich gibt an, ab wann die HAL beginnt, die Farbe amber, indigo etc. in die Farbmischung einzuberechnen. Diese Angaben werden für jede Farbe separat jeweils über die folgenden vier Attribute definiert. Alle vier Attribute zusammen ergeben im Farbspektrum ein Trapez, sofern das linke und rechte Maximum zusammen auf einem Punkt liegen. In letzterem Fall ergibt sich dann ein Dreieck.
* <code>hueLeftBottom</code>: linker Nullpunkt des Trapezes
* <code>hueLeftTop</code>: linkes Maximum des Trapezes
* <code>hueRightTop</code>: rechtes Maximum des Trapezes
* <code>hueRightBottom</code>: rechter Nullpunkt des Trapezes
Die Standardwerte sind in der untenstehenden Tabelle notiert. Die Werte der Attribute sind in Grad angegeben.
{| class="wikitable toptextcells"
|-
! Farbe !! hueLeftBottom !! hueLeftTop !! hueRightTop !! hueRightBottom
|-
!style="width: 10em; vertical-align:top"| <code>lime</code>
|style="width: 10em"| <code>60</code>
|style="width: 10em"| <code>90</code>
|style="width: 10em"| <code>90</code>
|style="width: 10em"| <code>120</code>
|-
! <code>amber</code>
| <code>0</code>
| <code>45</code>
| <code>45</code>
| <code>60</code>
|-
! <code>cyan</code>
| <code>120</code>
| <code>180</code>
| <code>180</code>
| <code>240</code>
|-
! <code>indigo</code>
| <code>240</code>
| <code>255</code>
| <code>255</code>
| <code>300</code>
|}

Für die Farbe <code>amber</code> sieht die vollständige Definition bei einem RGBA-LED-Scheinwerfer dann wie folgt aus:
 
<source lang="xml"><rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<amber dmxchannel="4" hueLeftBottom="0" hueLeftTop="60" hueRightTop="60" hueRightBottom="120" />
</rgb>
</source>

====CMY-Farbmischung====
Die CMY-Farbmischung ist eine so genannte subtraktive Farbmischung. Hier werden ausgehen von der Farbe Weiß verschiedene durch drei Scheiben in den Farben Cyan, Magenta und Gelb Farbanteile abgezogen, um die gewünschte Mischfarbe zu erhalten. Die Scheiben sind dabei auf der einen Seiten transparent und auf der gegenüberliegenden Seite vollständig eingefärbt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>cmy</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<cmy>
<cyan dmxchannel="0" />
<magenta dmxchannel="1" />
<yellow dmxchannel="2" />
</cmy>
</source>
CMY-Farbmischung auf den Kanälen 1 bis 3, wobei der DMX-Kanal
* 1 die Intensität von Cyan steuert
* 2 die Intensität von Magenta steuert
* 3 die Intensität von Gelb steuert
|}

====HSV-Farbmischung====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>hsv</code>
|style="width: 10em"| Auflösung mit 16 bit
|style="width: 60em"| <source lang="xml">
<hsv>
<h dmxchannel="0" finedmxchannel="1"/>
<s dmxchannel="2" finedmxchannel="3"/>
<v dmxchannel="4" finedmxchannel="5"/>
</hsv>
</source>
HSV-Farbmischung auf den DMX-Kanälen 1 bis 6, wobei die DMX-Kanäle
* 1, 3 und 5 eine Auflösung von 8 bit und die DMX-Kanäle
* 2, 4 und 6 für die 16-bit-Auflösung zuständig sind.
|}

===Farbrad===
Ein Farbrad besteht aus mehreren im Kreis angeordneten, lichtdurchlässigen Elementen, die in verschiedenen Farben eingefärbt sind. Hierdurch erhält der Lichtstrahl eines Moving-Heads oder eines Scanners "seine" Farbe. Je nach Ausführung sind auch Halbfarben möglich, wo das Farbrad dann immer genau in der Mitte zwischen zwei benachbarten Farben im Lichtstrahl positioniert wird.

Die Anzahl der Farben für ein Farbrad ist effektiv gesehen nicht begrenzt. Allerdings sind technisch bedingt nur 255 verschiedene Farben zuzüglich Weiß möglich. Ein DMX-Kanal kann nur Werte zwischen 0 und 255 annehmen.

====Basis-Funktionen====
Beim Farbrad wird immer der Hexadizimal-Code der entsprechenden Farbe im Attribut <code>val</code> hinterlegt. Buttons mit den Farben erscheinen dann automatisch Color Control sowie im Device Control. Im Attribut <code>caption</code> wird der "Klarname" der Farbe eingetragen, der ebenfalls im Device Control ausgegeben wird.

Es ist zulässig, dass bei den Attributen <code>mindmx</code> und <code>maxdmx</code> die gleichen Werte eingetragen werden. Dies ist immer dann erforderlich, wenn das Farbrad keine feste Position für eine bestimmte Farbe besitzt und sich beliebig positionieren lässt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="9" caption="White" />
<step type="color" val="#e51e1a" mindmx="10" maxdmx="19" caption="Red" />
<step type="color" val="#79bd7f" mindmx="20" maxdmx="29" caption="Aquamarine" />
<step type="color" val="#018934" mindmx="30" maxdmx="39" caption="Green" />
...
</colorwheel>
</source>
Farbrad auf DMX-Kanal 1:
* Farbe Weiß (Farbcode #FFFFFF) zwischen DMX-Wert 0 und 9
* Farbe Rot (Farbcode #E51E1A) zwischen DMX-Wert 10 und 19
* Farbe Aquamarine (Farbcode #79BD7F) zwischen DMX-Wert 20 und 29
* Farbe Grün (Farbcode #018934) zwischen DMX-Wert 30 und 39
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! val !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Farbcode der Farbe im HEX-Formart
|style="width: 10em"| Unterer DMX-Wert für die Farbe
|style="width: 10em"| Oberer DMX-Wert für die Farbe
|style="width: 10em"| Name der Farbe
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>color</code>
| <code>#000000 bis #FFFFFF</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

Der Hexadezimal-Wert (HEX-Wert) kann aus allen anderen Farbsystemen umgerechnet werden. Aus je zwei Buchstaben ergibt sich immer ein Dezimal-Wert zwischen 0 und 255. Beispiele sind hierfür:

{| class="wikitable toptextcells"
|-
! Name !! RGB-Wert !! HEX-Wert !! CMY
|-
|style="width: 10em"| Weiß
|style="width: 10em"| <code>255; 255; 255</code>
|style="width: 10em"| <code>#FFFFFF</code>
|style="width: 10em"| <code> 0%; 0%; 0%</code>
|-
| Rot
| <code>255; 0; 0</code>
| <code>#FF0000</code>
| <code> 0%; 95%; 94%</code>
|-
| Gelb
| <code>255; 255; 0</code>
| <code>#FFFF00</code>
| <code> 9%; 0%; 93%</code>
|-
| Hellgrün
| <code>161; 195; 45</code>
| <code>#A1C32D</code>
| <code> 46%; 0%; 92%</code>
|-
| Schwarz
| <code> 0; 0; 0</code>
| <code>#000000</code>
| <code>100%; 100%; 100%</code>
|}

Im Internet gibt es unter dem Suchwort "''RGB zu HEX''" mehrere Konverter, mit deren Hilfe man die RGB-Farben in das HEX-Format umrechnen oder über einen Farbkreis direkt den HEX-Wert generieren kann.

====Ergänzende Funktionen====
Für den DMX-Kanal für das Farbrad sind folgende ergänzende Funktionen verfügbar, die in der Regel auf dem gleiche DMX-Kanal liegen:
* <code>wheelrotation</code>: Kontinuierliches Drehen des Farbrads
* <code>random</code>: Drehung des Farbrads auf zufällige Positionen

=====Wheelrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="0" caption="White" />
<step type="color" val="#e51e1a" mindmx="15" maxdmx="15" caption="Red" />
...
<wheelrotation>
<range type="cw" mindmx="219" maxdmx="199" minval="0.1" maxval="8" />
<range type="ccw" mindmx="220" maxdmx="240" minval="0.1" maxval="8" />
</wheelrotation>
</colorwheel>
</source>
Kontinuierliche Drehung des Farbrads zwischen DMX-Wert 199 und 240 auf DMX-Kanal 1
* Drehung des Farbrads im Uhrzeigersinn mit 8 1/s bei DMX-Wert 199, abnehmend bis 0,1 1/s bei DMX-Wert 219.
* Drehung des Farbrads gegen den Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 220, schneller werdend 8 1/s bei DMX-Wert 240.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Farbrad
|style="width: 10em"| Maximale Drehzahl des Farbrads
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 15 1/s</code>
| <code>0.01 1/s bis 15 1/s</code>
|}

=====Random=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="0" caption="White" />
<step type="color" val="#e51e1a" mindmx="15" maxdmx="15" caption="Red" />
...
<random>
<step type="fast" mindmx="241" maxdmx="245" />
<step type="medium" mindmx="246" maxdmx="250" />
<step type="slow" mindmx="251" maxdmx="255" />
</random>
</colorwheel>
</source>
Zufällige Farbe des Farbrads auf Kanal 1
* Schneller Farbwechsel bei einem DMX-Wert zwischen 241 und 245
* Farbwechsel mit mittlerer Geschwindigkeit bei einem DMX-Wert zwischen 246 und 250
* Langsamer Farbwechsel bei einem DMX-Wert zwischen 251 und 255
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"|
|style="width: 10em"|
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>fast</code> 
<code>medium</code> 
<code>slow</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

===Matrix===
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>matrix</code>
|style="width: 10em"| RGB-Matrix mit zwei Zeilen und drei Spalten
|style="width: 60em"| <source lang="xml">
<matrix rows="2" columns="3">
<rgb>
<red dmxchannel="1" />
<green dmxchannel="2" />
<blue dmxchannel="3" />
</rgb>
<rgb>
<red dmxchannel="4" />
<green dmxchannel="5" />
<blue dmxchannel="6" />
</rgb>
<rgb>
<red dmxchannel="7" />
<green dmxchannel="8" />
<blue dmxchannel="9" />
</rgb>
<rgb>
<red dmxchannel="10" />
<green dmxchannel="11" />
<blue dmxchannel="12" />
</rgb>
<rgb>
<red dmxchannel="13" />
<green dmxchannel="14" />
<blue dmxchannel="15" />
</rgb>
<rgb>
<red dmxchannel="16" />
<green dmxchannel="17" />
<blue dmxchannel="18" />
</rgb>
</matrix>
</source>
|}

===Farbtemperatur===
Mit der Farbtemperatur wird angegeben, wie warm oder kalt eine Farbe dargestellt werden soll. Ein warmes Weiß erzeugen klassische PAR-Scheinwerfer. Die Farbtemperatur liegt hier bei etwa 2.700 K. Entladungslampen in Moving-Head oder Scannern haben dagegen eine Farbtemperatur zwischen 7.000 K und 8.000 K, wodurch dieses Licht als kalt empfunden wird.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colortemp</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colortemp dmxchannel="0" >
<range minval="3200" maxval="7000" mindmx="0" maxdmx="255" />
</colortemp>
</source>
Farbtemperatur auf DMX-Kanal 1:
* Farbtemperatur von 3.200 K bei DMX-Wert zunehmend bis 7.000 K bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die wärmste Farbtemperatur
|style="width: 10em"| DMX-Wert für die kälteste Farbtemperatur
|style="width: 10em"| Wärmste Farbtemperatur
|style="width: 10em"| Kälteste Farbtemperatur
|-
!style="vertical-align:top"| Zulässiger Attributwert
| nicht vorhanden
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>2500 K bis 8000 K</code>
| <code>2500 K bis 8000 K</code>
|}

===Goborad===
Mit Hilfe eines Gobos projiziert ein Moving-Head oder Scanner verschiedene Figuren und Motive in den Raum bzw. auf die Tanzfläche.

Die Anzahl der Gobos für ein Goborad ist effektiv gesehen nicht begrenzt. Allerdings sind technisch bedingt nur 255 verschiedene Gobos zuzüglich offen (kein Gobo) möglich. Ein DMX-Kanal kann nur Werte zwischen 0 und 255 annehmen.

====Basis-Funktionen====
Beim Goborad wird immer der Dateiname des Icons eines Gobos im Attribut <code>val</code> hinterlegt. Die Icons erscheinen dann automatisch mit den Icons im Gobo Control sowie im Device Control. Im Attribut <code>caption</code> wird der "Klarname" des Gobos eingetragen, der ebenfalls im Device Control ausgegeben wird. Mit Hilfe des Icons der Gobos wählt die HAL von DMXControl 3 automatisch die Gobos von verschiedenen Geräten aus, die sich am ähnlichsten sind. Sind keine Icons der Gobos im DDF hinterlegt, kann das DDF zwar verwendet werden, jedoch ist die automatische Auswahl der ähnlichsten Gobos von unterschiedlichen Geräten in diesem Fall nicht verfügbar.

Es ist zulässig, dass bei den Attributen <code>mindmx</code> und <code>maxdmx</code> die gleichen Werte eingetragen werden. Dies ist immer dann erforderlich, wenn das Goborad keine feste Position für ein bestimmtes Gobo besitzt und sich beliebig positionieren lässt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1" />
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2" />
<step type="gobo" val="thinbars.png" mindmx="48" maxdmx="63" caption="Gobo 3" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1:
* Kein Gobo (offen) bei DMX-Wert zwischen 0 und 15.
* Gobo 1 bei DMX-Wert zwischen 16 und 31, Dateiname des Icons lautet „congostar.png“.
* Gobo 2 bei DMX-Wert zwischen 32 und 47, Dateiname des Icons lautet „sunburst.png“.
* Gobo 3 bei DMX-Wert zwischen 48 und 63, Dateiname des Icons lautet „thinbars.png“.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! val !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Dateiname des Icons für das Gobo
|style="width: 10em"| Unterer DMX-Wert für das Gobo
|style="width: 10em"| Oberer DMX-Wert für das Gobo
|style="width: 10em"| Beschreibung des Gobos
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>open</code> 
<code>gobo</code>
| <code>*.png-Dateien</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

====Zusätzliche Funktionen====
Für einzelne Funktionen des Kanals für das Goborad sind folgende zusätzliche Funktionen möglich:
* <code>goboindex</code>: Ausrichtung des Gobos in einem bestimmten Winkel, die so genannte Indizierung des Gobos
* <code>goborotation</code>: Kontinuierliches Drehen des Gobos in verschiedene Richtungen
* <code>goboshake</code>: Goboshake, das heißt hin- und herbewegen des Gobos mit verschiedenen Geschwindigkeiten auf dem gleichen DMX-Kanal
* <code>wheelrotation</code>: Kontinuierliches Drehen des Goborads

Diese zusätzlichen Funktionen ausgenommen der Rotation des gesamten Goborades können auf drei verschiedenen Wegen aufgerufen werden:
* Für die Ansteuerung der zusätzlichen Funktionen kommen ein oder mehrere separete DMX-Kanäle zum Einsatz.
* Die zusätzlichen Funktionen liegen auf dem gleichen DMX-Kanal wie das Goborad selbst.
* Die Steuerung der Funktionen liegt zwar auch auf einen separaten DMX-Kanal, sie werden in Abhängigkeit eines bestimmten Wertebereiches auf dem Goborad aktiviert. In diesem Fall sind die verfügbaren Gobos in der Übersicht mehrfach gelistet.

=====Goboindizierung=====
Die Goboindizierung dient dazu, das Gobo in einem bestimmten Winkel bzw. in einer bestimmten Position auszurichten. Eine Beschränkung des maximalen Drehwinkels für die Goboindizierung auf 360° ist in Bezug auf die möglichen Effekte manchmal nicht sinnvoll, weshalb der maximale zulässige Drehwinkel größer ausfällt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für Goboindizierung
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</goboindex>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboindizierung auf DMX-Kanal 2:
* Positionierung / Ausrichtung des Gobos in einem Winkel zwischen 0° bei DMX-Wert 0 und 360° bei DMX-Wert 127.
|-
| <code>gobowheel</code>
| Gleicher DMX-Kanal für Goboindizierung
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex />
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1">
<range range="360" handler="goboindex" mindmx="24" maxdmx="31" minval="0" maxval="360" />
</step>
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2">
<range range="360" handler="goboindex" mindmx="40" maxdmx="47" minval="0" maxval="360" />
</step>
...
</gobowheel>
</source>
Goborad und Goboindizierung auf DMX-Kanal 1:
* Positionierung / Ausrichtung des Gobo 1 in einem Winkel zwischen 0° bei DMX-Wert 24 und 360° bei DMX-Wert 31.
* Positionierung / Ausrichtung des Gobo 2 in einem Winkel zwischen 0° bei DMX-Wert 40 und 360° bei DMX-Wert 47.
|-
| <code>gobowheel</code>
| Aktivierung der Goboindizierung über bestimmten Wertebereich
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</goboindex>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="23" val="congostar.png" caption="Gobo 1">
<step for="goboindex" mindmx="24" maxdmx="31" />
</step>
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboindizierung auf DMX-Kanal 2:
* Aktivierung der Goboindizierung bei einem DMX-Wert auf DMX-Kanal 1 zwischen 24 und 31. Positionierung / Ausrichtung des Gobos über DMX-Kanal 2 in einem Winkel zwischen 0° bei DMX-Wert 0 und 360° bei DMX-Wert 127.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Maximaler Drehwinkel für die Goboindizierung
|style="width: 10em"| DMX-Wert für die Start-Position
|style="width: 10em"| DMX-Wert für die End-Position
|style="width: 10em"| Start-Position der Goboindizierung
|style="width: 10em"| End-Position der Goboindizierung
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>0° bis 720°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 720°</code>
| <code>0° bis 720°</code>
|}

=====Goborotation=====
Mit der Goborotation können die Gobos eines Goborades in verschiedene Richtungen mit unterschiedlichen Geschwindigkeiten kontinuierlich gedreht werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für die Goborotation
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goborotation dmxchannel="1">
<step type="stop" mindmx="192" maxdmx="192" />
<range type="cw" mindmx="191" maxdmx="128" minval="0.5" maxval="5" />
<range type="ccw" mindmx="193" maxdmx="255" minval="0.5" maxval="5" />
</goborotation>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goborotation auf DMX-Kanal 2:
* Keine Goborotation bei DMX-Wert 192.
* Goborotation im Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 191, zunehmend bis 5 1/s bei DMX-Wert 128.
* Goborotation gegen den Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255.
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Aktivierung der Goborotation über einen bestimmten Wertebereich
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goborotation dmxchannel="1">
<step type="stop" mindmx="192" maxdmx="192" />
<range type="cw" mindmx="191" maxdmx="128" minval="0.5" maxval="5" />
<range type="ccw" mindmx="193" maxdmx="255" minval="0.5" maxval="5" />
</goborotation>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="23" val="congostar.png" caption="Gobo 1">
<step for="goboindex" mindmx="24" maxdmx="31" />
</step>
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goborotation auf DMX-Kanal 2:
* Statisches Gobo bei einem DMX-Wert zwischen 16 und 23 auf DMX-Kanal 1.
* Aktvierung der Goborotation bei einem DMX-Wert zwischen 24 und 31 auf DMX-Kanal 1.
* Keine Goborotation bei DMX-Wert 192 auf DMX-Kanal 2.
* Goborotation im Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 191, zunehmend bis 5 1/s bei DMX-Wert 128 auf DMX-Kanal 2.
* Goborotation gegen den Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255 auf DMX-Kanal 2.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Gobos
|style="width: 10em"| Maximale Drehzahl des Gobos
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 10 1/s</code>
| <code>0.01 1/s bis 10 1/s</code>
|}

=====Goboshake=====
Das Goboshake muss für jedes Gobo einzeln eingerichtet werden. Das bedeutet, dass zum einen zu definieren ist, bei welchen DMX-Werten das Goboshake deaktiviert ist. Diese Werte entsprechen meistens den DMX-Werten, wo das Gobo ausgewählt wird. Als zweites muss definiert werden, bei welchen DMX-Werten das Goboshake aktiv ist. Hierbei sind auch die Geschwindigkeiten einzupflegen. Der dritte zu ergänzende Eintrag ist das Element <code><goboshake /></code> selbst, welches direkt als erstes Unterelement für das Element <code>gobowheel</code> aufgeführt wird. Hierüber wird angegeben, dass die Goboshake-Funktion auf dem gleichen DMX-Kanal liegt wie die eigentliche Basis-Funktion.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für Goboshake
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goboshake dmxchannel="1">
<range minval="0.1" maxval="10" mindmx="16" maxdmx="127" />
</goboshake>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboshake auf DMX-Kanal 2:
* Keine Bewegung des Gobos bei DMX-Wert zwischen 0 und 15 auf DMX-Kanal 2.
* Zunehmende Frequenz des Goboshake von 0,1 Hz bei DMX-Wert 16 auf maximal 10 Hz bei DMX-Wert 128 auf DMX-Kanal 2.
|-
| <code>gobowheel</code>
| Gleicher DMX-Kanal für Goboshake
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboshake />
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1">
<range handler="goboshake" mindmx="128" maxdmx="135" minval="0.4" maxval="5" />
</step>
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2">
<range handler="goboshake" mindmx="136" maxdmx="143" minval="0.4" maxval="5" />
</step>
</gobowheel>
</source>
Goborad mit Goboshake auf DMX-Kanal 1:
* Kein Gobo (offen) bei DMX-Wert zwischen 0 und 15.
* Gobo 1 bei DMX-Wert zwischen 16 und 31. Aktivierung des Goboshakes bei DMX-Wert 128 mit Frequenz 0,4 Hz, zunehmend bis 5 Hz bei DMX-Wert 135.
* Gobo 2 bei DMX-Wert zwischen 32 und 47. Aktivierung des Goboshakes bei DMX-Wert 136 mit Frequenz 0,4 Hz, zunehmend bis 5 Hz bei DMX-Wert 143.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Goboshake-Geschwindigkeit
|style="width: 10em"| DMX-Wert für die maximale Goboshake-Geschwindigkeit
|style="width: 10em"| Minimale Goboshake-Geschwindigkeit
|style="width: 10em"| Maximale Goboshake-Geschwindigkeit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>goboshake</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 Hz bis 20 Hz</code>
| <code>0 Hz bis 20 Hz</code>
|}

=====Wheelrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1" />
...
<wheelrotation>
<range type="cw" mindmx="223" maxdmx="192" minval="0.1" maxval="8" />
<range type="ccw" mindmx="224" maxdmx="255" minval="0.1" maxval="8" />
</wheelrotation>
</gobowheel>
</source>
Kontinuierliche Drehung des Goborads zwischen DMX-Wert 192 und 255 auf DMX-Kanal 1:
* Drehung des Goborads im Uhrzeigersinn mit 8 1/s bei DMX-Wert 192, abnehmend bis 0,1 1/s bei DMX-Wert 223.
* Drehung des Goborads gegen den Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 224, schneller werdend 8 1/s bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Goborad
|style="width: 10em"| Maximale Drehzahl des Goborad
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 15 1/s</code>
| <code>0.01 1/s bis 15 1/s</code>
|}

===Prisma===
Mit Hilfe eines Prismas wird der Lichtstrahl mehrfach geteilt. Diese Funktion ist meistens bei Moving-Heads und Scannern und in verschiedenen Ausbaustufen zu finden. Möglich ist ein einfaches statisches Prisma bis hin zu mehreren Prismen mit verschiedenen Anzahlen an Facetten, die sich wiederum rotieren und positionieren lassen.

====Basis-Funktionen====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
<step type="prism" mindmx="128" maxdmx="191" caption="6-facets linear prism" />
<step type="prism" mindmx="192" maxdmx="255" caption="8-facets radial prism" />
</prism>
</source>
Prisma auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 63.
* 3-Facetten-Prisma bei DMX-Wert zwischen 64 und 127.
* Lineares 6-Facetten-Prisma bei DMX-Wert zwischen 128 und 191.
* Radial 8-Facetten-Prisma bei DMX-Wert zwischen 192 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für zugehöriges Prisma
|style="width: 10em"| Maximaler DMX-Wert für zugehöriges Prisma
|style="width: 10em"| Beschreibung des Prismas
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>open</code> 
<code>prism</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

====Zusätzliche Funktionen====
Für einzelne Funktionen des Kanals für das Prisma sind folgende zusätzliche Funktionen möglich:
* <code>prismindex</code>: Positionierung des Prismas in einem beliebigen Winkel
* <code>prismrotation</code>: Kontinuierliches Drehen des Prismas in verschiedene Richtungen

Diese zusätzlichen Funktionen können auf zwei verschiedenen Wegen aufgerufen werden:
* Für die Ansteuerung der zusätzlichen Funktionen kommen ein oder mehrere separete DMX-Kanäle zum Einsatz.
* Die zusätzlichen Funktionen liegen auf dem gleichen DMX-Kanal wie das Prisma selbst.

=====Prismenindizierung=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Separater DMX-Kanal für Prismenindizierung
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<prismindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</prismindex>
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
...
</prism>
</source>
Prisma auf DMX-Kanal 1, Prismenindizierung auf DMX-Kanal 2:
* Kein Prisma bei DMX-Wert zwischen 0 und 63 auf DMX-Kanal 1.
* 3.Facetten-Prisma statisch bei DMX-Wert zwischen 64 und 127 auf DMX-Kanal 1.
* Indizierung / Positionierung des eingelegten Prismas in einem beliebigen Winkel zwischen 0° und 360° bei einem DMX-Wert zwischen 0 und 127.
|-
| <code>prism</code>
| Prismenindizierung auf gleichem DMX-Kanal
| <source lang="xml">
<prism dmxchannel="0">
<prismindex />
<step type="open" mindmx="0" maxdmx="31" caption="Open" />
<step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
<range range="360" handler="prismindex" mindmx="32" maxdmx="119" minval="0" maxval="360" />
</step>
…
</prism>
</source>
Prisma mit Prismenindizierung auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 31.
* Positionierung des 3-Facetten-Prismas in einem beliebigen Winkel zwischen 0° bei DMX-Wert 32 und 360° bei DMX-Wert 119.
* Basisposition des Prismas bei einem DMX-Wert zwischen 120 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Maximaler Drehwinkel für die Prismenindizierung
|style="width: 10em"| DMX-Wert für die Start-Position
|style="width: 10em"| DMX-Wert für die End-Position
|style="width: 10em"| Start-Position der Prismenindizierung
|style="width: 10em"| End-Position der Prismenindizierung
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>0° bis 360°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 360°</code>
| <code>0° bis 360°</code>
|}

=====Prismenrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Separeter DMX-Kanal für Prismenrotation
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<prismrotation dmxchannel="1">
<step type="stop" mindmx="191" maxdmx="192" />
<range type="cw" mindmx="193" maxdmx="255" minval="0.1" maxval="3.0" />
<range type="ccw" mindmx="190" maxdmx="128" minval="0.1" maxval="3.0" />
</prismrotation>
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
...
</prism>
</source>
Prisma auf DMX-Kanal 1, Prismenrotation auf DMX-Kanal 2:
* Prisma statisch bei DMX-Wert zwischen 191 und 192, statisch.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 193, schneller werdend bis 3 1/s bei DMX-Wert 255.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/s bei DMX-Wert 128, abnehmend bis 0,1 1/s bei DMX-Wert 190.
|-
| <code>prism</code>
| Prismenrotation auf gleichem DMX-Kanal
| <source lang="xml">
<prism dmxchannel="0">
<prismrotation />
<step type="open" mindmx="0" maxdmx="31" caption="Open" />
<step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
<step type="stop" handler="prismrotation" mindmx="120" maxdmx="127" />
<range type="ccw" handler="prismrotation" mindmx="191" maxdmx="128" minval="0.1" maxval="3" />
<range type="cw" handler="prismrotation" mindmx="192" maxdmx="255" minval="0.1" maxval="3" />
</step>
…
</prism>
</source>
Prisma mit Prismenrotation auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 31.
* 3-Facetten-Prisma bei DMX-Wert zwischen 32 und 127, statisch.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/s bei DMX-Wert 128, abnehmend bis 0,1 1/s bei DMX-Wert 191.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 192, schneller werdend bis 3 1/s bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Drehzahl des Prismas
|style="width: 10em"| DMX-Wert für die maximale Drehzahl des Prismas
|style="width: 10em"| Minimale Drehzahl des Prismas
|style="width: 10em"| Maximale Drehzahl des Prismas
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>prismrotation</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.05 1/s bis 5 1/s</code>
| <code>0.05 1/s bis 5 1/s</code>
|}

===Position===
In der Funktion Position werden die DMX-Kanäle für die Pan- und Tilt-Bewegung von Moving-Heads und Scannern im DDF hinterlegt, also das horizontale und vertikale Bewegen des Kopfs bzw. des Spiegels.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>position</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<position>
<pan dmxchannel="0" finedmxchannel="1">
<range range="540" />
</pan>
<tilt dmxchannel="2" finedmxchannel="3">
<range range="240" />
</tilt>
</position>
</source>
Pan- und Tilt-Bewegung mit Auflösung von 16 bit auf den DMX-Kanälen 1 bis 4:
* Pan-Bewegung mit einem Schwenkbereich von 540° auf den DMX-Kanälen 1 und 2.
* Tilt-Bewegung mit einem Kippbereich von 240° auf den DMX-Kanälen 3 und 4.
|}

===Pan-Tilt-Geschwindigkeit===
Mit der Funktion für die Pan-Tilt-Geschwindigkeit wird festgelegt, wie schnell ein Moving-Head oder Scanner bei seinen Fahrten fährt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>ptspeed</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<ptspeed dmxchannel="0">
<range type="linear" mindmx="255" maxdmx="0" minval="0" maxval="100" />
</ptspeed>
</source>
Pan-Tilt-Geschwindigkeit auf Kanal 1:
* Maximalwert der Pan-Tilt-Geschwindigkeit bei DMX-Wert 0, abnehmend auf geringsten Wert bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Pan-Tilt-Geschwindigkeit
|style="width: 10em"| DMX-Wert für maximale Pan-Tilt-Geschwindigkeit
|style="width: 10em"| Geringste Pan-Tilt-Geschwindigkeit
|style="width: 10em"| Maximale Pan-Tilt-Geschwindigkeit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Zoom===
Die Zoom-Funktion verändert den Abstrahlwinkel / Öffnungswinkel des Lichtstrahls des Geräts. Sie darf nicht mit der Iris verwechselt werden. Die Zoom-Funktion kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>zoom</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<zoom dmxchannel="0" >
<range mindmx="255" maxdmx="0" minval="14" maxval="30" />
</zoom>
</source>
Zoom auf DMX-Kanal 1:
* Lineare Verkleinerung des Lichtstrahls von 30° bei DMX-Wert 0 auf 14° bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für kleinsten Öffnungswinkel
|style="width: 10em"| DMX-Wert für größten Öffnungswinkel
|style="width: 10em"| Kleinster Öffnungswinkel
|style="width: 10em"| Größter Öffnungswinkel
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 90°</code>
| <code>0° bis 90°</code>
|}

===Iris===
Mit der Iris kann der Lichtstrahl in seiner Größe bzw. der Projektionsbereich variiert werden. Die Iris arbeitet dabei in der Lichttechnik genauso wie die Iris in einem Fotoapparat. Im Gegensatz zum Zoom ändert sich der Abstrahlwinkel mit dem Öffnen und Schließen der Iris nicht. Bei nahezu geschlossener Iris wird nur ein kleiner Anteil des Lichtstrahls durch die Blende gelassen.

Die Iris-Funktion kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>iris</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<iris dmxchannel="0">
<range type="linear" mindmx="0" maxdmx="128" minval="0" maxval="100" />
</iris>
</source>
Iris auf DMX-Kanal 1:
* Lineare Öffnen der Iris von geschlossen (0%) bei DMX-Wert 0 auf vollständig geöffnet (100%) bei DMX-Wert 128.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für kleinste Öffnungsweite
|style="width: 10em"| DMX-Wert für größte Öffnungsweite
|style="width: 10em"| Kleinste Öffnungsweite
|style="width: 10em"| Größte Öffnungsweite
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Fokus===
Die Fokus-Funktion dient insbesondere zum motorisierten „Scharf-Stellen“ von Gobo von Moving-Heads und Scannern und kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>focus</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<focus dmxchannel="0">
<range mindmx="255" maxdmx="0" minval="0" maxval="100" />
</focus>
</source>
Fokus auf DMX-Kanal 1:
* Lineare Einstellung des Fokus von nah bei DMX-Wert 255 bis weit bei DMX-Wert 0.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für Fokus nah
|style="width: 10em"| DMX-Wert für Fokus weit
|style="width: 10em"| Fokus nah
|style="width: 10em"| Fokus weit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Nebel===
Über die Nebel-Funktion wird die Intensität des Nebelausstoßes gesteuert, sowohl bei einfachen Nebelmaschinen als auch bei Hazern.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>fog</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<fog dmxchannel="0" />
</source>
|}

===Ventilator===
Die Ventilator-Funktion steuert die Fördermenge eines Ventilators. Dies kann zum einen der Ventilator in einem Hazer sein, zum anderen eine DMX-gesteuerte Windmaschine.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>fan</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<fan dmxchannel="0" />
</source>
|}

===Freie Funktionen===
Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur im Device Control ausgegeben. Auch die Vorteile der HAL lassen sich auf diese frei definierten Funktionen anwenden.

Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:
* <code>rawstep</code>: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
* <code>raw</code>: Generiert einen einfachen Schieberegler.
* <code>const</code>: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.

{{BoxWichtig|Text=Alle oben genannten Elemente sind vollständig gerätespezifisch. Die HAL kann in Cuelists etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist. }}

====rawstep====
Über das Element rawstep wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:
* Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
* Einfügen und Entfernen einer Animationsscheibe in einem Moving-Head
* Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus

Im Gegensatz zu den fest definierten Funktionen muss beim <code>rawstep</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes <code>step</code> kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise der HAL.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>rawstep</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<rawstep dmxchannel="0" name="Mode">
<step caption="DMX" mindmx="0" maxdmx="9" />
<step caption="Auto" mindmx="10" maxdmx="199" />
<step caption="Music" mindmx="200" maxdmx="255" />
</rawstep>
</source>
Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal 1:
* Aktivierung des DMX-Modus bei DMX-Wert zwischen 0 und 9.
* Aktivierung der Automatik-Modus bei DMX-Wert zwischen 10 und 199.
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen 200 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! caption !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Beschreibung der Funktion
|style="width: 10em"| Minimaler DMX-Wert zur Aktivierung der der Funktion
|style="width: 10em"| Maximaler DMX-Wert zur Aktivierung der der Funktion
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>Text</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

{{BoxWichtig|Text=Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }}

====raw====
Das Element raw erzeugt im Device Control einen Schieberegler. Typische Anwendungsfälle sind hierfür:
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Einstellung der Mikrofon-Empfindlichkeit für die Sound-To-Light-Steuerung
* Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
* Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
* Nutzung für weitere Bewegungsachsen
* Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern
* Motorisierte Schieberblenden

Im Gegensatz zu den fest definierten Funktionen muss beim <code>raw</code> neben dem DMX-Kanal im Attribut <code>nam</code>e auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>raw</code>
|style="width: 10em"| Geschwindigkeitsregler für Automatikprogramme
|style="width: 60em"| <source lang="xml">
<raw dmxchannel="0" name="Macro speed" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</raw>
</source>
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:
* Geschwindigkeit der Automatikprogramme zunehmend von DMX-Wert bis DMX-Wert 255.
|-
| Vorlage für Animationsscheibe
| <source lang="xml">
<raw dmxchannel="0" name="Animation disk rotation" >
<step type="stop" mindmx="125" maxdmx="130" minval="0" maxval=""/>
<range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
<range type="ccw" mindmx="124" maxdmx="0" maxval="-0.05" minval="-2" />
</raw >
</source>
Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal 1:
* Animationsscheibe statisch bei DMX-Wert zwischen 125 und 130.
* Rotation der Animationsscheibe im Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 131, schneller werdend bis 2 1/s bei DMX-Wert 255.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/s bei DMX-Wert 124, abnehmend bis -0,05 1/s bei DMX-Wert 0.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für die Funktion
|style="width: 10em"| Maximaler DMX-Wert für die Funktion
|style="width: 10em"| Kleinster Wert
|style="width: 10em"| Größter Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code> 
<code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
|}

====const====
Das Element const wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.

Für das Element const ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.

Im Gegensatz zu den fest definierten Funktionen muss beim <code>const</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut <code>val</code> wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>const</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<const dmxchannel="0" name="Macro Effects" val="0" />
</source>
Makroeffekte auf DMX-Kanal 1:
* Dauerhaft gesetzter DMX-Wert 0.
|}

==Procedures==
Mit Hilfe von Procedures werden Funktionen aufgerufen, die im Live-Betrieb in der Regel nicht benötigt werden. Auch ein Abspeichern dieser Funktionen in Cues ist im Normalfall nicht erforderlich.

Auf diese Funktionen wird nicht über das Device Control, sondern im Stage View über das Kontexmenü des jeweiligen Geräts, über das Untermenü Procedures zugegriffen.

===Aufbau===
Procedures in DDFs für DMXControl 3 besitzen alle den gleichen Aufbau, der meistens aus vier Elementen besteht:
* Name der Funktion für das zugehörige Procedure
* <code>set</code>: Festlegung des DMX-Kanals und dem DMX-Wert
* <code>hold</code>: Haltezeit für den DMX-Wert
* <code>restore</code>: Wiederherstellung des Ausgangszustands

Lässt man das Element <code>restore</code> in einem Procedure weg, bleibt der unter <code>set</code> eingetragene DMX-Wert gesetzt.

===Verfügbare Procedures===
Aktuell sind in DMXControl 3 folgende Procedures bereits hinterlegt, es können aber auch Procedures mit eigenen Namen erstellt werden. Für die gängigsten Funktionen werden dem Namen automatisch auch eindeutige Symbole zugeordnet.
Wie die Benennung erfolgt, kann selbst festgelegt werden, da mit den Procedures direkt DMX-Kanäle mit DMX-Werten angesprochen werden. Es ist daher möglich, mit dem Procedure zum Einschalten der Lampe auch einen vollständigen Gerätereset zu starten. Allerdings ist diese Vorgehensweise nicht zu empfehlen.

{| class="wikitable toptextcells"
|-
! Procedur-Name
! Beschreibung
! Bemerkung
|-
|style="width: 10em"| lamp_on
| Schaltet die Lampe des entsprechenden Geräts ein.
|
|-
| lamp_off
| Schaltet die Lampe des entsprechenden Geräts aus.
|
|-
| reset
| Löst am entsprechenden Gerät einen Reset aus.
|
|-
| reset_pan_tilt
| Löst am entsprechenden Gerät einen Reset der Pan & Tilt Motoren aus.
| Das Gerät fährt mit Pan & Tilt seine Referenzpunkte an.
|-
| reset_pan
| Löst am entsprechenden Gerät einen Reset des Pan Motors aus.
| Das Gerät fährt mit Pan seine Referenzpunkte an.
|-
| reset_tilt
| Löst am entsprechenden Gerät einen Reset des Tilt Motors aus.
| Das Gerät fährt mit Tilt seine Referenzpunkte an.
|-
| reset_gobo reset_gobowheel
| Löst am entsprechenden Gerät einen Reset des Gobo Motors aus.
| Das Goborad fährt seine Referenzpunkte an.
|-
| reset_gobo2 reset_gobowheel2
| Löst am entsprechenden Gerät einen Reset des Gobo2 Motors aus.
| Das Goborad 2 fährt seine Referenzpunkte an.
|-
| reset_color reset_colorwheel
| Löst am entsprechenden Gerät einen Reset des Color Motors aus.
| Das Farbrad fährt seine Referenzpunkte an.
|-
| reset_color2 reset_colorwheel2
| Löst am entsprechenden Gerät einen Reset des Color2 Motors aus.
| Das Farbrad 2 fährt seine Referenzpunkte an.
|-
| reset_effects
| Löst am entsprechenden Gerät das Zurücksetzen der eingebauten Effekte aus.
|
|-
| reset_zoom
| Löst am entsprechenden Gerät den Reset der Zoom-Funktion aus.
|
|-
| reset_shutter
| Löst am entsprechenden Gerät den Reset des Shutters aus.
|
|-
| reset_iris
| Löst am entsprechenden Gerät den Reset der Iris-Blende aus.
|
|-
| reset_focus
| Löst am entsprechenden Gerät den Reset der Fokusfunktion aus.
|
|-
| reset_prism
| Löst am entsprechenden Gerät einen Reset des Prismarades aus.
|
|-
| pan_invert_on
| Am entsprechenden Gerät wird der Pan-Kanal invertiert.
|
|-
| pan_invert_off
| Am entsprechenden Gerät wird die Invertierung des Pan-Kanals aufgehoben.
|
|-
| tilt_invert_on
| Am entsprechenden Gerät wird der Tilt-Kanal invertiert.
|
|-
| tilt_invert_off
| Am entsprechenden Gerät wird die Invertierung des Tilt-Kanals aufgehoben.
|
|-
| pan_tilt_swap_on
| Am entsprechenden Gerät werden Pan und Tilt vertauscht.
|
|-
| pan_tilt_swap_off
| Die Vertauschung von Pan und Tilt wird deaktiviert.
|
|-
| display_on
| Das Display des entsprechenden Gerätes wird aktiviert.
|
|-
| display_off
| Das Display des entsprechenden Gerätes wird deaktiviert.
|
|}

===Beispiele===
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>reset</code>
|style="width: 10em"| Vollständiger Reset des Gerätes
|style="width: 60em"| <source lang="xml">
<reset>
<set dmxchannel="0" value="255" />
<hold value="6000" />
<restore dmxchannel="0" />
</reset>
</source>
Reset
* Setzen DMX-Kanal 1 auf DMX-Wert 255.
* Halten des DMX-Werts für 6000 ms (6 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>lamp_on</code>
| Leuchtmittel einschalten
| <source lang="xml">
<lamp_on>
<set dmxchannel="0" value="255" />
<hold value="4000" />
<restore dmxchannel="0" />
</lamp_on>
</source>
Leuchtmittel einschalten
* Setzen DMX-Kanal 1 auf DMX-Wert 255.
* Halten des DMX-Werts für 4000 ms (4 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>lamp_off</code>
| Leuchtmittel ausschalten
| <source lang="xml">
<lamp_off>
<set dmxchannel="0" value="50" />
<hold value="8000" />
<restore dmxchannel="0" />
</lamp_off>
</source>
Leuchtmittel ausschalten
* Setzen DMX-Kanal 1 auf DMX-Wert 50.
* Halten des DMX-Werts für 8000 ms (8 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>procedure</code>
| Eco-Mode für Leuchtmittel
| <source lang="xml">
<procedure name="Lamp eco mode">
<set dmxchannel="0" value="170" />
<hold value="4500" />
<restore dmxchannel="0" />
</procedure>
</source>
Eigenes Procedure mit dem Namen „Eco-Mode für Leuchtmittel“
* Setzen DMX-Kanal 1 auf DMX-Wert 170.
* Halten des DMX-Werts für 4500 ms (4,5 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|}

==Fehlerbehebung: warum funktioniert mein DDF nicht?==
Dies sind häufige Fehler, die verhindern, dass ein DDF zu einem Projekt hinzugefügt werden kann:
* Bei Pan- und Tilt wurde im Attribut <code>range</code> kein Schwenkbereich angegeben.
* Für Strobe ist kein Wert für <code>minval</code> und <code>maxval</code> hinterlegt.
* Der Tag <code>model</code> ist noch falsch geschrieben.

==Links und Referenzen==
{{BoxHinweis
|Text=Ein [[DDFCreator3.0#DDFCreator3.x|DDFCreator]] für DMXControl 3 ist bereits in Arbeit, siehe [http://www.dmxcontrol.de/forum/index.php?page=Thread&threadID=7931&pageNo=1 Forum]. Ihr könnt mit diesem Prototype arbeiten oder die eigenen DDFs mit einem XML-Editor Eurer Wahl oder einfach mit einem Texteditor erstellen. Manchmal hilft es, ein bereits existierendes DDF zu kopieren und anzupassen.
Gerne könnt ihr eure neuen DDFs auch im Forum teilen: [https://forum.dmxcontrol-projects.org/index.php?thread/7935-dmxcontrol-3-ddf-sammler-nur-funktionierende-ddfs-bitte/ DDF Sammlung].
}}

Fußnoten
<references/>
{{End-LaTeX}}
{{NavigationTop-Man3
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}

[[Kategorie: Handbuch DMXControl 3]]

DDF DMXC3

2017-12-28T22:05:04Z

Pgrote: Fehlende funktionen hinzugefügt

{{Kapitelüberschrift|Version=DMXControl 3.1.1}} {{Inuse}}

{{NavigationTop-Man3
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}

==Hintergrund: Wofür werden DDFs benötigt?==
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.

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<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. }}

==Speicherort: Wo sind die DDFs zu finden?==
Die DDFs von DMXControl 3 sind lokal auf dem PC in folgendem Verzeichnis zu finden:
 
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\
</source>
 
[Installationsverzeichnis] steht hierbei für das Verzeichnis, in dem DMXControl 3 installiert wurde. Wurde dies beim Installieren nicht geändert, lautet der Pfad üblicherweise
 
<source lang="xml">
C:\Programme (x86)\DMXControl3\
</source>
 
Das Bild für das Icon des Geräts in der Stage View liegt immer im Verzeichnis
 
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\images\
</source>
 
und die Icons der Gobos unter
 
<source lang="xml">
[Installationsverzeichnis]\kernel\icons
</source>
 
==Struktur: Wie ist ein DDF aufgebaut?==
Das DDF für DMXControl 3 besteht aus vier Teilen:
* '''Basisteil''' mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
* '''Informationsteil''' mit Angaben zum Gerät, Hersteller, Autor sowie DMX-Modus
* '''Funktionsteil''' mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
* '''Procedures-Teil''' für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten
 
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3" ddfversion="1" subdevice="no">
<information>
...
</information>
<functions>
...
</functions>
<procedures>
...
</procedures>
</device>
</source>
 
Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die GUI, damit alle Steuerelemente wie das Device Control und die Controls richtig dargestellt werden. Des Weiteren greift die HAL auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den Cues eines Projekts abzuspeichern.

===Inhalt der vier Teile innerhalb des DDFs===
====Basisteil====
Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element <code>device</code> enthalten. Der Tag <code>device</code> umfasst folgende Attribute:

{| class="wikitable toptextcells"
|-
! Attribut !! Beschreibung !! Standard-Wert !! Zulässige Werte !! Optional
|-
|style="width: 10em"| <code>image</code>
|style="width: 30em"| Bild-Datei des DDFs
|style="width: 10em"| Nicht vorhanden
|style="width: 20em"| Dateiname des Bilds als *.png-Datei
|style="width: 10em"|
|-
| <code>type</code>
|
| <code>DMXDevice</code>
| DMXDevice
|
|-
| <code>dmxaddresscount</code>
| Gesamtzahl der DMX-Kanäle des Geräts
| Nicht vorhanden
| Ganze Zahlen von 1 bis 512
| X
|-
| <code>dmxcversion</code>
| Erforderliche Programmversion zur Verwendung des DDFs
| <code>3</code>
| 3, 3.0.1, 3.0.2, 3.1, 3.1.1 und alle zukünftigen Programmversion
|
|-
| <code>ddfversion</code>
| Version des DDFs
| Nicht vorhanden
| 1, 1.1, 1.2 usw.
|
|-
| <code>subdevice</code>
| Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer
| <code>No</code>
| No oder yes
| X
|-
| <code>defaultdisplaystyle</code>
| Standart Anzeige-Modus in der StageView
| <code>preview</code>
| custom, image ober preview
| X
|-
| <code>defaultdisplaycolor</code>
| Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes
| <code>#ffffff</code>
| Jede HTML-Farbe (#000000 - #ffffff)
| X
|-
| <code>whitechanneldefaultmode</code>
| Das Verhalten, wie der White-Kanal angesprochen wird
| <code>onlywhite</code>
| none, addwhite oder onlywhite
| X
|}

Das Element <code>device</code> 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 Stage View ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.

====Informationsteil====
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 Device Manager. Alle Angaben werden durch das Element <code><information> ... </information></code> eingeklammert.

{| class="wikitable toptextcells"
|-
! Tag !! Beschreibung !! Optional
|-
|style="width: 10em"| <code>model</code>
|style="width: 30em"| Bezeichnung des Geräts gemäß Bedienungsanleitung
|style="width: 10em"|
|-
| <code>vendor</code>
| Hersteller des Geräts gemäß vorgegebener Herstellerliste
|
|-
| <code>author</code>
| Autor des DDFs
|
|-
| <code>mode</code>
| DMX-Modus bzw. Kanalbelegung
| X
|-
| <code>comment</code>
| Kommentar zum DDF oder Gerät
| X
|}

====Funktionsteil====
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 <code><functions> ... </functions></code> 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 Cues abgespeichert werden und lassen sich nur über die Stage View aufrufen.

===Gemeinsamkeiten der Funktionen===
====Genauigkeit bzw. Auflösung von Funktionen====
Auf jedem DMX-Kanal können insgesamt 256 verschiedene Werte übertragen werden und zwar im Bereich von DMX-Wert 0 bis DMX-Wert 255. Dies beschreibt die klassische Auflösung bzw. Genauigkeit eines DMX-Kanals von 8 bit.
Um bei bestimmten Funktionen wie zum Beispiel bei Pan, Tilt oder beim Dimmer feine Auflösungen zu erzielen, werden weitere DMX-Kanäle hinzugezogen, um die Auflösung zu erhöhen. In diesem Fall spricht man dann von einer Auflösung mit 16 bit oder der zweite DMX-Kanal für die Pan-Funktion wird mit Pan fine bezeichnet.
DMXControl 3 unterstützt aktuell Auflösungen von Funktionen bis 32 bit. Für hierfür werden dann vier DMX-Kanäle zusammengefasst, um die Funktion in dieser Auflösung darzustellen. In den DDFs kommen dabei folgende Bezeichnungen zum Einsatz:
* <code>dmxchannel</code> für 8-bit-Auflösung
* <code>finedmxchannel</code> für 16-bit-Auflösung
* <code>ultradmxchannel</code> für 24-bit-Auflösung
* <code>ultrafinedmxchannel</code> für 32-bit-Auflösung
Es ist dabei zu beachten, dass bei der 32-bit-Auflösung auch alle vier DMX-Kanäle anzugeben sind. Es ist mitunter nicht unüblich, dass die vier DMX-Kanäle in der Belegung nicht direkt hintereinander angeordnet sind. Die folgende Tabelle zeigt die Definition der aktuell möglichen Auflösungen anhand des Dimmers.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
| style="width: 10em" rowspan="4" | <code>dimmer</code>
| style="width: 10em" | Dimmer mit 8-bit-Auflösung
| style="width: 60em" | <source lang="xml">
<dimmer dmxchannel="0" />
</source>
Dimmer auf DMX-Kanal 1
|-
| Dimmer mit 16-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" />
</source>
Dimmer mit 16-bit-Auflösung auf DMX-Kanal 1 und 2
|-
| Dimmer mit 24-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" />
</source>
Dimmer mit 24-bit-Auflösung auf DMX-Kanal 1, 2 und 3
|-
| Dimmer mit 32-bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" ultrafinedmxchannel="3" />
</source>
Dimmer mit 32-bit-Auflösung auf DMX-Kanal 1, 2, 3 und 4
|}

====Aufbau einer Funktion auf einem DMX-Kanal====
Liegen auf einem DMX-Kanal wie beispielsweise beim Strobe, Shutter oder Goborad mehrere Funktionen, so werden diese in zwei Kategorien unterteilt:
* <code>step</code> für Funktionen, die immer nur umgeschaltet werden, zum Beispiel das Wechseln der Farbe auf einem Farbrad
* <code>range</code> für Funktionen, die parallel zum Umschalten auch noch in bestimmten Bereichen variiert werden können, wie zum Beispiel die Richtung und die Geschwindigkeit der Goborotation
Ein <code>step</code> besteht dabei immer aus dem eigentlichen Tag <code>step</code>, dem Attribut <code>type</code>, sowie den Attributen für den minimalen DMX-Wert <code>mindmx</code> und den maximalen DMX-Wert <code>maxdmx</code> für den <code>step</code>. Der Wert für das Attribut <code>type</code> ist immer abhängig von der Eigenschaft des DMX-Kanals, die abgebildet werden soll. Welche Werte zulässig sind, wird bei der Beschreibung der jeweiligen Eigenschaft angegeben.
 
<source lang="xml">
<step type="open" mindmx="225" maxdmx="255" />
</source>
 
Der Tag <code>range</code> ist ähnlich aufgebaut, wie der Tag <code>step</code>. Der wesentlichste Unterschied ist die Ergänzung der Attribute <code>minval</code> und <code>maxval</code>. Hier werden beispielsweise die minimale und maximale Drehzahl für die Goborotation angegeben.

Die Besonderheit ist an dieser Stelle, dass die DMX-Werte den Geschwindigkeiten zugeordnet werden. Das heißt, zur minimalen Drehzahl wird der DMX-Wert eingetragen, wo sich das Gobo am langsamsten dreht. Genauso verhält es sich mit der maximalen Drehzahl. Daher kann es vorkommen, dass die minimale Drehzahl nicht immer automatisch auch der niedrige DMX-Wert und die maximale Drehzahl beim größten DMX-Wert anliegt. Ein Code-Beispiel ist im Abschnitt Goborad zu finden.
 
<source lang="xml">
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
</source>
 
===Grundregeln bei der Erstellung eines DDFs===
Bei den DDFs sind folgende grundlegenden Regeln zu beachten:
* Die DMX-Kanäle werden in den DDFs immer bei 0 beginnend gezählt. Deswegen sind für einen LED-PAR mit 5 DMX-Kanälen im DDF auch die DMX-Kanäle 0 bis 4 angegeben, während die Funktionen in der Bedienungsanleitung von DMX-Kanal 1 bis 5 beschriftet sind.
* Die Bezeichnung der Geräte beschränkt sich nur auf die Bezeichnung selbst, wie sie auf dem Deckblatt des Handbuchs steht. Zusätzliche Angaben wie beispielsweise der DMX-Modus / Kanalbelegung oder sonstige Kommentare sind dort nicht zu hinterlegen.
* Die Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Goborotation etc. erfolgt ohne Einheiten. Die üblichen Einheiten für diese Werte sind in der nachfolgenden Tabelle aufgelistet.
* Die zugehörigen DMX-Werte zum Beispiel für die Drehzahl der Goborotation sind so einzutragen, dass von dem Punkt Goborotation stopp aus die Drehzahlen vor und entgegen des Uhrzeigersinns zunehmen.
* Bilder für das Geräte-Icon sowie für die Gobos sollen in einer Auslösung von 128 x 128 Pixeln und als *.png-Datei im DDF hinterlegt werden.
* Die DDFs werden üblicherweise in englischer Sprache verfasst.

{| class="wikitable toptextcells"
|-
! Wert !! Einheit !! Verwendung
|-
|style="width: 10em"| Drehzahl
|style="width: 10em"| <code>1/s</code> 
(Umdrehung pro Sekunde)
| Goborotation, Prismenrotation, kontinuierliche Drehung des Farbrads, kontinuierliche Drehung des Goborads
|-
| Farbtemperatur
| <code>K</code> 
(Kelvin)
| Farbtemperatur
|-
| Frequenz
| <code>Hz</code> 
(Hertz)
| Strobe-Frequenz, Goboshake-Geschwindigkeit
|-
| Winkel
| <code>°</code> 
(Grad)
| Pan- und Tilt-Schwenkbereich, Goboindizierung, Prismenindizierung, Zoom
|-
| Einheitslos
| <code>%</code> 
(Prozent)
| Dimmer, Iris
|}

==Syntax: die möglichen Funktions-Bausteine==
Nachfolgend sind alle aktuell unterstützten Funktionen aufgelistet, die von DMXControl direkt unterstützt werden. Jede Funktion ist mit einem Codebeispiel versehen, der wiederum in Klartext übersetzt ist.

===Dimmer===
Über den Dimmer-Kanal wird die Helligkeit eines Geräts gesteuert. LED-PAR-Scheinwerfer oder Moving-Heads haben meistens nur einen Dimmerkanal. Je nach Ausführung sind von der Standard-Auflösung mit 8 bit feiner Auflösung bis hin zu 32 bit möglich. Dazu wird das Element auf <code><dimmer dmxchannel="0" finedmxchannel="1" ultraddmxchannel="2" ultrafinedmxchannel="3" /></code> erweitert. Die entsprechende Berechnung, wie welcher DMX-Kanal anzusteuern ist, übernimmt DMXControl automatisch.

Dimmerpacks besitzen im Gegensatz zu LED-PARs, Scannern oder Moving-Heads mehrere Dimmer-Kanäle. Hier ist es aber nicht erforderlich, das Dimmerpack mit seinen vier, sechs oder zwölf Dimmer-Kanälen selbst abzubilden. Hilfreicher und einfacher ist es an dieser Stelle, die daran angeschlossenen Halogen-PAR-Scheinwerfer in entsprechender Anzahl dem Projekt hinzufügen.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
| style="width: 10em" rowspan="3" | <code>dimmer</code>
| style="width: 10em" | Standard
| style="width: 60em" | <source lang="xml">
<dimmer dmxchannel="0" />
</source>
Dimmer auf DMX-Kanal 1
|-
| Dimmer mit 16 bit-Auflösung
| <source lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" />
</source>
Dimmer mit 16-bit-Auflösungen auf DMX-Kanal 1 und 2
|-
| Einfacher Dimmer in bestimmtem DMX-Wertebereich
| <source lang="xml">
<dimmer dmxchannel="0">
<range type="linear" mindmx="0" maxdmx="127" minval="0" maxval="100" />
</dimmer>
</source>
Dimmer auf DMX-Kanal 1:
* Lineares Dimmverhalten von 0% Helligkeit (aus) bei DMX-Wert 0 bis maximale Helligkeit (100%) bei DMX-Wert 127
|}

===Switch===
Die Funktion <code>switch</code> wird immer dann eingesetzt, wenn es nur zwischen zwei Zuständen hin- und her geschaltet werden soll, beispielsweise der Zustand "Arbeitslicht an" und der Zustand "Arbeitslicht aus".

Bei diesem Element müssen abgesehen vom DMX-Kanal keine weiteren Angaben vorgenommen werden. DMXControl 3 gibt bei einem Helligkeitswert von kleiner 50% automatisch einen DMX-Wert von 0 aus und bei Helligkeitswerten über 50% automatisch einen DMX-Wert von 255.

Es empfiehlt sich, diese Funktion tatsächlich nur bei einem Switch-Pack einzusetzen. Zum Aktivieren eines weiteren Betriebsmodus, wie zum Beispiel die Sound-to-Light-Steuerung, ist das <code>rawstep</code>-Element besser geeignet.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>switch</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<switch dmxchannel="0" />
</source>
Switch auf DMX-Kanal 1
|}

===Shutter===
Der Shutter ist meistens bei Moving-Heads oder Scannern mit einer Entladungslampe zu finden. Hierbei werden mechanische Blenden in den Lichtstrahl geschoben, wenn das Gerät kein Licht ausgeben soll. Darüber hinaus wird über den Shutter der Strobe-Effekt erzeugt. Bei Moving-Heads oder Scannern mit LEDs als Lichtquelle wird dieses Verhalten über die Elektronik nachgestellt.

In der Regel sind beim Shutter-Kanal mehrere Funktionen zu hinterlegen, mindestens aber die Funktionen Shutter geschlossen und Shutter offen.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>shutter</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<shutter dmxchannel="0">
<step type="closed" mindmx="0" maxdmx="21" />
<step type="open" mindmx="234" maxdmx="255" />
</shutter>
</source>
Shutter auf DMX-Kanal 1:
* Shutter geschlossen bei DMX-Wert zwischen 0 und 21.
* Shutter geöffnet bei DMX-Wert zwischen 234 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Unterer DMX-Wert für den Zustand
|style="width: 10em"| Oberer DMX-Wert für den Zustand
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>closed</code> 
<code>open</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

===Strobe===
====Basis-Funktionen====
Beim Strobe-Kanal können beliebig viele Funktionen wie zum Beispiel verschiedene Strobe-Effekte hinterlegt werden. Folgende Strobe-Effekte sind hierbei üblich:
* <code>linear</code>: Strobe-Frequenz nimmt stetig zu bis hin zu einem fast dauerhaften Leuchten
* <code>pulse</code>: Pulsierender Strobe-Effekt
* <code>random</code>: Blitze werden in zufälligen Zeitabständen mit zunehmender Intensität erzeugt
* <code>ramp up</code>: Blitze werden zunehmen heller bis zum Maximalwert und gehen dann abrupt aus
* <code>spikes</code>: Es werden einzelne Blitze erzeugt

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>strobe</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="89" minval="1" maxval="12" />
<range type="pulse" mindmx="90" maxdmx="172" minval="0.5" maxval="6" />
<range type="random" mindmx="173" maxdmx="255" minval="1" maxval="12" />
</strobe>
</source>
Strobe auf DMX-Kanal 1:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe mit der Geschwindigkeit ansteigend von 1 Hz bei DMX-Wert 6 bis 12 Hz bei DMX-Wert 89.
* Pulsierender Strobe bei DMX-Wert zwischen 90 und 172 mit Geschwindigkeit von 0,5 Hz bis 6 Hz.
* Zufälliges Strobe bei DMX-Wert zwischen 173 und 255 mit Geschwindigkeit von 1 Hz bis 12 Hz.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Strobe-Frequenz
|style="width: 10em"| DMX-Wert für die maximale Strobe-Frequenz
|style="width: 10em"| Minimale Strobe-Frequenz
|style="width: 10em"| Maximale Strobe-Frequenz
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code> 
<code>pulse</code> 
<code>random</code> 
<code>ramp up</code> 
<code>ramp down</code> 
<code>ramp up/down</code> 
<code>lightning</code> 
<code>spikes</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 Hz bis 50 Hz</code>
| <code>0 Hz bis 50 Hz</code>
|}

====Unterfunktionen====
Für einzelne Funktionen des Strobe-Kanals sind folgende Unterfunktionen möglich:
* <code>strobetype</code>: Auswahl des Strobeeffekts über einen getrennten DMX-Kanal

=====Strobetype=====
Über den <code>strobetype</code> wird der Strobeeffekt über einen separaten DMX-Kanal ausgewählt. Diese Funktion steht meistens dann zur Verfügung, wenn das Gerät viele verschiedene Strobeeffekte erzeugen kann und in diesem Zusammenhang die Strobefrequenz weiterhin genau eingestellt werden soll.
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>strobe</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<strobetype dmxchannel="1" />
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
<step handler="strobetype" mindmx="6" maxdmx="42" />
</range>
<range type="random" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
<step handler="strobetype" mindmx="43" maxdmx="85" />
</range>
</strobe>
</source>
Strobe-Frequenz auf DMX-Kanal 1, Strobe-Effekt auf DMX-Kanal 2:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 0,5 Hz bis 25 Hz, bei einem DMX-Wert zwischen 6 und 42 auf DMX-Kanal 2.
* Zufälliger Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 0,5 Hz bis 25 Hz, bei einem DMX-Wert zwischen 43 und 85 auf DMX-Kanal 2.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert
|style="width: 10em"| Maximaler DMX-Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>strobetype</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

====Ergänzende Funktionen====
Für den gesamten Strobe-Kanal sind folgende ergänzende Funktionen möglich:
* <code>duration</code>: Einstellen der Leuchtdauer eines einzelnen Blitzes

=====Duration=====
Über die <code>durartion</code> wird die Länge der Leuchtdauer eines einzelnen Blitzes eingestellt. Die maximale Leuchtdauer korrespondiert dabei mit der Strobe-Frequenz. Bei bestimmten Kombinationen von Strobe-Frequenz und Leuchtdauer wird sofern technisch möglich ein Dauerleuchten erzeugt.
{| class="wikitable toptextcells"
|-
! Sub-Tag !! Variante !! Code
|-
|style="width: 10em"| <code>duration</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<strobe dmxchannel="0">
<step type="open" mindmx="0" maxdmx="5" />
<range type="linear" mindmx="6" maxdmx="255" minval="1" maxval="12" />
<duration dmxchannel="1" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="650" />
</duration>
</strobe>
</source>
Strobe-Frequenz auf DMX-Kanal 1, Blitzdauer auf DMX-Kanal 2:
* Kein Strobe bei DMX-Wert zwischen 0 und 5.
* Linearer Strobe im Bereich zwischen den DMX-Werten 6 und 255 mit Geschwindigkeit von 1 Hz bis 12 Hz. Blitzdauer von 0 ms bis 650 ms über DMX-Kanal 2 im Bereich zwischen den DMX-Werten 0 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die kürzeste Einschaltdauer
|style="width: 10em"| DMX-Wert für die längste Einschaltdauer
|style="width: 10em"| Kürzeste Einschaltdauer
|style="width: 10em"| Längste Einschaltdauer
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 ms bis 2000 ms</code>
| <code>0 ms bis 2000 ms</code>
|}

===Farbe===
Alle Kanäle können durch wie hier am Beispiel für rote LEDs von der Standart-Auflösung mit 8 bit <code><red dmxchannel="0" /></code> auf eine Auflösung mit bis zu 32 bit <code><red dmxchannel="0" finedmxchannel="1" ultraddmxchannel="2" ultrafinedmxchannel="3" /></code> erweitert werden. Die entsprechende Berechnung, wie welcher DMX-Kanal anzusteuern ist, übernimmt DMXControl automatisch.

Bei allen Farbmischungs-Systemen werden ausgenommen von den Farben amber und ultraviolett jeweils nur die DMX-Kanäle angeben, wo sich welche Farbe befindet. Weitere Angaben sind hier nicht erforderlich.

====RGB-Farbmischung====
Die RGB-Farbmischung ist eine so genannte additive Farbmischung. Hierbei werden bei der Farbmischung verschiedene Farben hinzugenommen, um die gewünschte Mischfarbe zu erhalten. Daher muss man die Farben rot, grün und blau jeweils auf die maximale Helligkeit stellen, um die Farbe Weiß zu erhalten.
In DMXControl 3 sind aktuell folgende Farben verfügbar, die direkt von der HAL ohne weitere Anpassungen in einer Standard-Konfiguration unterstützt werden:
* <code>red</code>
* <code>lime</code>
* <code>amber</code>
* <code>green</code>
* <code>cyan</code>
* <code>blue</code>
* <code>indigo</code>
* <code>uv</code>
* <code>white</code>

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="3"| <code>rgb</code>
|style="width: 10em"| RGB
|style="width: 60em"| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
</rgb>
</source>
RGB-Farbmischung auf den Kanälen 1 bis 3, wobei der DMX-Kanal
* 1 die roten LEDs steuert
* 2 die grünen LEDs steuert
* 3 die blauen LEDs steuert
|-
| RGBW
| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<white dmxchannel="3" />
</rgb>
</source>
|-
| RGBA
| <source lang="xml">
<rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<amber dmxchannel="3" />
</rgb>
</source>
|}

=====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 Stage View, kann unter dem Eintrag ''White Automix Mode'' das Verhalten für jedes Gerät einzeln angepasst werden:
* ''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ß

=====Arbeitsbereiche für zusätzliche LED-Farben=====
In DMXControl sind für die Arbeitsbereite der zusätzlichen LED-Farben standardmäßig im Programm hinterlegt, können aber vom Nutzer in den jeweiligen DDFs angepasst werden. Der Arbeitsbereich gibt an, ab wann die HAL beginnt, die Farbe amber, indigo etc. in die Farbmischung einzuberechnen. Diese Angaben werden für jede Farbe separat jeweils über die folgenden vier Attribute definiert. Alle vier Attribute zusammen ergeben im Farbspektrum ein Trapez, sofern das linke und rechte Maximum zusammen auf einem Punkt liegen. In letzterem Fall ergibt sich dann ein Dreieck.
* <code>hueLeftBottom</code>: linker Nullpunkt des Trapezes
* <code>hueLeftTop</code>: linkes Maximum des Trapezes
* <code>hueRightTop</code>: rechtes Maximum des Trapezes
* <code>hueRightBottom</code>: rechter Nullpunkt des Trapezes
Die Standardwerte sind in der untenstehenden Tabelle notiert. Die Werte der Attribute sind in Grad angegeben.
{| class="wikitable toptextcells"
|-
! Farbe !! hueLeftBottom !! hueLeftTop !! hueRightTop !! hueRightBottom
|-
!style="width: 10em; vertical-align:top"| <code>lime</code>
|style="width: 10em"| <code>60</code>
|style="width: 10em"| <code>90</code>
|style="width: 10em"| <code>90</code>
|style="width: 10em"| <code>120</code>
|-
! <code>amber</code>
| <code>0</code>
| <code>45</code>
| <code>45</code>
| <code>60</code>
|-
! <code>cyan</code>
| <code>120</code>
| <code>180</code>
| <code>180</code>
| <code>240</code>
|-
! <code>indigo</code>
| <code>240</code>
| <code>255</code>
| <code>255</code>
| <code>300</code>
|}

Für die Farbe <code>amber</code> sieht die vollständige Definition bei einem RGBA-LED-Scheinwerfer dann wie folgt aus:
 
<source lang="xml"><rgb>
<red dmxchannel="0" />
<green dmxchannel="1" />
<blue dmxchannel="2" />
<amber dmxchannel="4" hueLeftBottom="0" hueLeftTop="60" hueRightTop="60" hueRightBottom="120" />
</rgb>
</source>

====CMY-Farbmischung====
Die CMY-Farbmischung ist eine so genannte subtraktive Farbmischung. Hier werden ausgehen von der Farbe Weiß verschiedene durch drei Scheiben in den Farben Cyan, Magenta und Gelb Farbanteile abgezogen, um die gewünschte Mischfarbe zu erhalten. Die Scheiben sind dabei auf der einen Seiten transparent und auf der gegenüberliegenden Seite vollständig eingefärbt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>cmy</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<cmy>
<cyan dmxchannel="0" />
<magenta dmxchannel="1" />
<yellow dmxchannel="2" />
</cmy>
</source>
CMY-Farbmischung auf den Kanälen 1 bis 3, wobei der DMX-Kanal
* 1 die Intensität von Cyan steuert
* 2 die Intensität von Magenta steuert
* 3 die Intensität von Gelb steuert
|}

====HSV-Farbmischung====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>hsv</code>
|style="width: 10em"| Auflösung mit 16 bit
|style="width: 60em"| <source lang="xml">
<hsv>
<h dmxchannel="0" finedmxchannel="1"/>
<s dmxchannel="2" finedmxchannel="3"/>
<v dmxchannel="4" finedmxchannel="5"/>
</hsv>
</source>
HSV-Farbmischung auf den DMX-Kanälen 1 bis 6, wobei die DMX-Kanäle
* 1, 3 und 5 eine Auflösung von 8 bit und die DMX-Kanäle
* 2, 4 und 6 für die 16-bit-Auflösung zuständig sind.
|}

===Farbrad===
Ein Farbrad besteht aus mehreren im Kreis angeordneten, lichtdurchlässigen Elementen, die in verschiedenen Farben eingefärbt sind. Hierdurch erhält der Lichtstrahl eines Moving-Heads oder eines Scanners "seine" Farbe. Je nach Ausführung sind auch Halbfarben möglich, wo das Farbrad dann immer genau in der Mitte zwischen zwei benachbarten Farben im Lichtstrahl positioniert wird.

Die Anzahl der Farben für ein Farbrad ist effektiv gesehen nicht begrenzt. Allerdings sind technisch bedingt nur 255 verschiedene Farben zuzüglich Weiß möglich. Ein DMX-Kanal kann nur Werte zwischen 0 und 255 annehmen.

====Basis-Funktionen====
Beim Farbrad wird immer der Hexadizimal-Code der entsprechenden Farbe im Attribut <code>val</code> hinterlegt. Buttons mit den Farben erscheinen dann automatisch Color Control sowie im Device Control. Im Attribut <code>caption</code> wird der "Klarname" der Farbe eingetragen, der ebenfalls im Device Control ausgegeben wird.

Es ist zulässig, dass bei den Attributen <code>mindmx</code> und <code>maxdmx</code> die gleichen Werte eingetragen werden. Dies ist immer dann erforderlich, wenn das Farbrad keine feste Position für eine bestimmte Farbe besitzt und sich beliebig positionieren lässt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="9" caption="White" />
<step type="color" val="#e51e1a" mindmx="10" maxdmx="19" caption="Red" />
<step type="color" val="#79bd7f" mindmx="20" maxdmx="29" caption="Aquamarine" />
<step type="color" val="#018934" mindmx="30" maxdmx="39" caption="Green" />
...
</colorwheel>
</source>
Farbrad auf DMX-Kanal 1:
* Farbe Weiß (Farbcode #FFFFFF) zwischen DMX-Wert 0 und 9
* Farbe Rot (Farbcode #E51E1A) zwischen DMX-Wert 10 und 19
* Farbe Aquamarine (Farbcode #79BD7F) zwischen DMX-Wert 20 und 29
* Farbe Grün (Farbcode #018934) zwischen DMX-Wert 30 und 39
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! val !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Farbcode der Farbe im HEX-Formart
|style="width: 10em"| Unterer DMX-Wert für die Farbe
|style="width: 10em"| Oberer DMX-Wert für die Farbe
|style="width: 10em"| Name der Farbe
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>color</code>
| <code>#000000 bis #FFFFFF</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

Der Hexadezimal-Wert (HEX-Wert) kann aus allen anderen Farbsystemen umgerechnet werden. Aus je zwei Buchstaben ergibt sich immer ein Dezimal-Wert zwischen 0 und 255. Beispiele sind hierfür:

{| class="wikitable toptextcells"
|-
! Name !! RGB-Wert !! HEX-Wert !! CMY
|-
|style="width: 10em"| Weiß
|style="width: 10em"| <code>255; 255; 255</code>
|style="width: 10em"| <code>#FFFFFF</code>
|style="width: 10em"| <code> 0%; 0%; 0%</code>
|-
| Rot
| <code>255; 0; 0</code>
| <code>#FF0000</code>
| <code> 0%; 95%; 94%</code>
|-
| Gelb
| <code>255; 255; 0</code>
| <code>#FFFF00</code>
| <code> 9%; 0%; 93%</code>
|-
| Hellgrün
| <code>161; 195; 45</code>
| <code>#A1C32D</code>
| <code> 46%; 0%; 92%</code>
|-
| Schwarz
| <code> 0; 0; 0</code>
| <code>#000000</code>
| <code>100%; 100%; 100%</code>
|}

Im Internet gibt es unter dem Suchwort "''RGB zu HEX''" mehrere Konverter, mit deren Hilfe man die RGB-Farben in das HEX-Format umrechnen oder über einen Farbkreis direkt den HEX-Wert generieren kann.

====Ergänzende Funktionen====
Für den DMX-Kanal für das Farbrad sind folgende ergänzende Funktionen verfügbar, die in der Regel auf dem gleiche DMX-Kanal liegen:
* <code>wheelrotation</code>: Kontinuierliches Drehen des Farbrads
* <code>random</code>: Drehung des Farbrads auf zufällige Positionen

=====Wheelrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="0" caption="White" />
<step type="color" val="#e51e1a" mindmx="15" maxdmx="15" caption="Red" />
...
<wheelrotation>
<range type="cw" mindmx="219" maxdmx="199" minval="0.1" maxval="8" />
<range type="ccw" mindmx="220" maxdmx="240" minval="0.1" maxval="8" />
</wheelrotation>
</colorwheel>
</source>
Kontinuierliche Drehung des Farbrads zwischen DMX-Wert 199 und 240 auf DMX-Kanal 1
* Drehung des Farbrads im Uhrzeigersinn mit 8 1/s bei DMX-Wert 199, abnehmend bis 0,1 1/s bei DMX-Wert 219.
* Drehung des Farbrads gegen den Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 220, schneller werdend 8 1/s bei DMX-Wert 240.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Farbrad
|style="width: 10em"| Maximale Drehzahl des Farbrads
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 15 1/s</code>
| <code>0.01 1/s bis 15 1/s</code>
|}

=====Random=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colorwheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colorwheel dmxchannel="0">
<step type="color" val="#ffffff" mindmx="0" maxdmx="0" caption="White" />
<step type="color" val="#e51e1a" mindmx="15" maxdmx="15" caption="Red" />
...
<random>
<step type="fast" mindmx="241" maxdmx="245" />
<step type="medium" mindmx="246" maxdmx="250" />
<step type="slow" mindmx="251" maxdmx="255" />
</random>
</colorwheel>
</source>
Zufällige Farbe des Farbrads auf Kanal 1
* Schneller Farbwechsel bei einem DMX-Wert zwischen 241 und 245
* Farbwechsel mit mittlerer Geschwindigkeit bei einem DMX-Wert zwischen 246 und 250
* Langsamer Farbwechsel bei einem DMX-Wert zwischen 251 und 255
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"|
|style="width: 10em"|
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>fast</code> 
<code>medium</code> 
<code>slow</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

===Matrix===
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>matrix</code>
|style="width: 10em"| RGB-Matrix mit zwei Zeilen und drei Spalten
|style="width: 60em"| <source lang="xml">
<matrix rows="2" columns="3">
<rgb>
<red dmxchannel="1" />
<green dmxchannel="2" />
<blue dmxchannel="3" />
</rgb>
<rgb>
<red dmxchannel="4" />
<green dmxchannel="5" />
<blue dmxchannel="6" />
</rgb>
<rgb>
<red dmxchannel="7" />
<green dmxchannel="8" />
<blue dmxchannel="9" />
</rgb>
<rgb>
<red dmxchannel="10" />
<green dmxchannel="11" />
<blue dmxchannel="12" />
</rgb>
<rgb>
<red dmxchannel="13" />
<green dmxchannel="14" />
<blue dmxchannel="15" />
</rgb>
<rgb>
<red dmxchannel="16" />
<green dmxchannel="17" />
<blue dmxchannel="18" />
</rgb>
</matrix>
</source>
|}

===Farbtemperatur===
Mit der Farbtemperatur wird angegeben, wie warm oder kalt eine Farbe dargestellt werden soll. Ein warmes Weiß erzeugen klassische PAR-Scheinwerfer. Die Farbtemperatur liegt hier bei etwa 2.700 K. Entladungslampen in Moving-Head oder Scannern haben dagegen eine Farbtemperatur zwischen 7.000 K und 8.000 K, wodurch dieses Licht als kalt empfunden wird.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>colortemp</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<colortemp dmxchannel="0" >
<range minval="3200" maxval="7000" mindmx="0" maxdmx="255" />
</colortemp>
</source>
Farbtemperatur auf DMX-Kanal 1:
* Farbtemperatur von 3.200 K bei DMX-Wert zunehmend bis 7.000 K bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die wärmste Farbtemperatur
|style="width: 10em"| DMX-Wert für die kälteste Farbtemperatur
|style="width: 10em"| Wärmste Farbtemperatur
|style="width: 10em"| Kälteste Farbtemperatur
|-
!style="vertical-align:top"| Zulässiger Attributwert
| nicht vorhanden
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>2500 K bis 8000 K</code>
| <code>2500 K bis 8000 K</code>
|}

===Goborad===
Mit Hilfe eines Gobos projiziert ein Moving-Head oder Scanner verschiedene Figuren und Motive in den Raum bzw. auf die Tanzfläche.

Die Anzahl der Gobos für ein Goborad ist effektiv gesehen nicht begrenzt. Allerdings sind technisch bedingt nur 255 verschiedene Gobos zuzüglich offen (kein Gobo) möglich. Ein DMX-Kanal kann nur Werte zwischen 0 und 255 annehmen.

====Basis-Funktionen====
Beim Goborad wird immer der Dateiname des Icons eines Gobos im Attribut <code>val</code> hinterlegt. Die Icons erscheinen dann automatisch mit den Icons im Gobo Control sowie im Device Control. Im Attribut <code>caption</code> wird der "Klarname" des Gobos eingetragen, der ebenfalls im Device Control ausgegeben wird. Mit Hilfe des Icons der Gobos wählt die HAL von DMXControl 3 automatisch die Gobos von verschiedenen Geräten aus, die sich am ähnlichsten sind. Sind keine Icons der Gobos im DDF hinterlegt, kann das DDF zwar verwendet werden, jedoch ist die automatische Auswahl der ähnlichsten Gobos von unterschiedlichen Geräten in diesem Fall nicht verfügbar.

Es ist zulässig, dass bei den Attributen <code>mindmx</code> und <code>maxdmx</code> die gleichen Werte eingetragen werden. Dies ist immer dann erforderlich, wenn das Goborad keine feste Position für ein bestimmtes Gobo besitzt und sich beliebig positionieren lässt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1" />
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2" />
<step type="gobo" val="thinbars.png" mindmx="48" maxdmx="63" caption="Gobo 3" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1:
* Kein Gobo (offen) bei DMX-Wert zwischen 0 und 15.
* Gobo 1 bei DMX-Wert zwischen 16 und 31, Dateiname des Icons lautet „congostar.png“.
* Gobo 2 bei DMX-Wert zwischen 32 und 47, Dateiname des Icons lautet „sunburst.png“.
* Gobo 3 bei DMX-Wert zwischen 48 und 63, Dateiname des Icons lautet „thinbars.png“.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! val !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Dateiname des Icons für das Gobo
|style="width: 10em"| Unterer DMX-Wert für das Gobo
|style="width: 10em"| Oberer DMX-Wert für das Gobo
|style="width: 10em"| Beschreibung des Gobos
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>open</code> 
<code>gobo</code>
| <code>*.png-Dateien</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

====Zusätzliche Funktionen====
Für einzelne Funktionen des Kanals für das Goborad sind folgende zusätzliche Funktionen möglich:
* <code>goboindex</code>: Ausrichtung des Gobos in einem bestimmten Winkel, die so genannte Indizierung des Gobos
* <code>goborotation</code>: Kontinuierliches Drehen des Gobos in verschiedene Richtungen
* <code>goboshake</code>: Goboshake, das heißt hin- und herbewegen des Gobos mit verschiedenen Geschwindigkeiten auf dem gleichen DMX-Kanal
* <code>wheelrotation</code>: Kontinuierliches Drehen des Goborads

Diese zusätzlichen Funktionen ausgenommen der Rotation des gesamten Goborades können auf drei verschiedenen Wegen aufgerufen werden:
* Für die Ansteuerung der zusätzlichen Funktionen kommen ein oder mehrere separete DMX-Kanäle zum Einsatz.
* Die zusätzlichen Funktionen liegen auf dem gleichen DMX-Kanal wie das Goborad selbst.
* Die Steuerung der Funktionen liegt zwar auch auf einen separaten DMX-Kanal, sie werden in Abhängigkeit eines bestimmten Wertebereiches auf dem Goborad aktiviert. In diesem Fall sind die verfügbaren Gobos in der Übersicht mehrfach gelistet.

=====Goboindizierung=====
Die Goboindizierung dient dazu, das Gobo in einem bestimmten Winkel bzw. in einer bestimmten Position auszurichten. Eine Beschränkung des maximalen Drehwinkels für die Goboindizierung auf 360° ist in Bezug auf die möglichen Effekte manchmal nicht sinnvoll, weshalb der maximale zulässige Drehwinkel größer ausfällt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für Goboindizierung
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</goboindex>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboindizierung auf DMX-Kanal 2:
* Positionierung / Ausrichtung des Gobos in einem Winkel zwischen 0° bei DMX-Wert 0 und 360° bei DMX-Wert 127.
|-
| <code>gobowheel</code>
| Gleicher DMX-Kanal für Goboindizierung
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex />
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1">
<range range="360" handler="goboindex" mindmx="24" maxdmx="31" minval="0" maxval="360" />
</step>
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2">
<range range="360" handler="goboindex" mindmx="40" maxdmx="47" minval="0" maxval="360" />
</step>
...
</gobowheel>
</source>
Goborad und Goboindizierung auf DMX-Kanal 1:
* Positionierung / Ausrichtung des Gobo 1 in einem Winkel zwischen 0° bei DMX-Wert 24 und 360° bei DMX-Wert 31.
* Positionierung / Ausrichtung des Gobo 2 in einem Winkel zwischen 0° bei DMX-Wert 40 und 360° bei DMX-Wert 47.
|-
| <code>gobowheel</code>
| Aktivierung der Goboindizierung über bestimmten Wertebereich
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</goboindex>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="23" val="congostar.png" caption="Gobo 1">
<step for="goboindex" mindmx="24" maxdmx="31" />
</step>
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboindizierung auf DMX-Kanal 2:
* Aktivierung der Goboindizierung bei einem DMX-Wert auf DMX-Kanal 1 zwischen 24 und 31. Positionierung / Ausrichtung des Gobos über DMX-Kanal 2 in einem Winkel zwischen 0° bei DMX-Wert 0 und 360° bei DMX-Wert 127.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Maximaler Drehwinkel für die Goboindizierung
|style="width: 10em"| DMX-Wert für die Start-Position
|style="width: 10em"| DMX-Wert für die End-Position
|style="width: 10em"| Start-Position der Goboindizierung
|style="width: 10em"| End-Position der Goboindizierung
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>0° bis 720°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 720°</code>
| <code>0° bis 720°</code>
|}

=====Goborotation=====
Mit der Goborotation können die Gobos eines Goborades in verschiedene Richtungen mit unterschiedlichen Geschwindigkeiten kontinuierlich gedreht werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für die Goborotation
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goborotation dmxchannel="1">
<step type="stop" mindmx="192" maxdmx="192" />
<range type="cw" mindmx="191" maxdmx="128" minval="0.5" maxval="5" />
<range type="ccw" mindmx="193" maxdmx="255" minval="0.5" maxval="5" />
</goborotation>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goborotation auf DMX-Kanal 2:
* Keine Goborotation bei DMX-Wert 192.
* Goborotation im Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 191, zunehmend bis 5 1/s bei DMX-Wert 128.
* Goborotation gegen den Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255.
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Aktivierung der Goborotation über einen bestimmten Wertebereich
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goborotation dmxchannel="1">
<step type="stop" mindmx="192" maxdmx="192" />
<range type="cw" mindmx="191" maxdmx="128" minval="0.5" maxval="5" />
<range type="ccw" mindmx="193" maxdmx="255" minval="0.5" maxval="5" />
</goborotation>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="23" val="congostar.png" caption="Gobo 1">
<step for="goboindex" mindmx="24" maxdmx="31" />
</step>
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goborotation auf DMX-Kanal 2:
* Statisches Gobo bei einem DMX-Wert zwischen 16 und 23 auf DMX-Kanal 1.
* Aktvierung der Goborotation bei einem DMX-Wert zwischen 24 und 31 auf DMX-Kanal 1.
* Keine Goborotation bei DMX-Wert 192 auf DMX-Kanal 2.
* Goborotation im Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 191, zunehmend bis 5 1/s bei DMX-Wert 128 auf DMX-Kanal 2.
* Goborotation gegen den Uhrzeigersinn mit 0,5 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255 auf DMX-Kanal 2.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Gobos
|style="width: 10em"| Maximale Drehzahl des Gobos
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 10 1/s</code>
| <code>0.01 1/s bis 10 1/s</code>
|}

=====Goboshake=====
Das Goboshake muss für jedes Gobo einzeln eingerichtet werden. Das bedeutet, dass zum einen zu definieren ist, bei welchen DMX-Werten das Goboshake deaktiviert ist. Diese Werte entsprechen meistens den DMX-Werten, wo das Gobo ausgewählt wird. Als zweites muss definiert werden, bei welchen DMX-Werten das Goboshake aktiv ist. Hierbei sind auch die Geschwindigkeiten einzupflegen. Der dritte zu ergänzende Eintrag ist das Element <code><goboshake /></code> selbst, welches direkt als erstes Unterelement für das Element <code>gobowheel</code> aufgeführt wird. Hierüber wird angegeben, dass die Goboshake-Funktion auf dem gleichen DMX-Kanal liegt wie die eigentliche Basis-Funktion.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Separater DMX-Kanal für Goboshake
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<goboshake dmxchannel="1">
<range minval="0.1" maxval="10" mindmx="16" maxdmx="127" />
</goboshake>
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" mindmx="16" maxdmx="31" val="congostar.png" caption="Gobo 1" />
...
</gobowheel>
</source>
Goborad auf DMX-Kanal 1, Goboshake auf DMX-Kanal 2:
* Keine Bewegung des Gobos bei DMX-Wert zwischen 0 und 15 auf DMX-Kanal 2.
* Zunehmende Frequenz des Goboshake von 0,1 Hz bei DMX-Wert 16 auf maximal 10 Hz bei DMX-Wert 128 auf DMX-Kanal 2.
|-
| <code>gobowheel</code>
| Gleicher DMX-Kanal für Goboshake
| <source lang="xml">
<gobowheel dmxchannel="0">
<goboshake />
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1">
<range handler="goboshake" mindmx="128" maxdmx="135" minval="0.4" maxval="5" />
</step>
<step type="gobo" val="sunburst.png" mindmx="32" maxdmx="47" caption="Gobo 2">
<range handler="goboshake" mindmx="136" maxdmx="143" minval="0.4" maxval="5" />
</step>
</gobowheel>
</source>
Goborad mit Goboshake auf DMX-Kanal 1:
* Kein Gobo (offen) bei DMX-Wert zwischen 0 und 15.
* Gobo 1 bei DMX-Wert zwischen 16 und 31. Aktivierung des Goboshakes bei DMX-Wert 128 mit Frequenz 0,4 Hz, zunehmend bis 5 Hz bei DMX-Wert 135.
* Gobo 2 bei DMX-Wert zwischen 32 und 47. Aktivierung des Goboshakes bei DMX-Wert 136 mit Frequenz 0,4 Hz, zunehmend bis 5 Hz bei DMX-Wert 143.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Goboshake-Geschwindigkeit
|style="width: 10em"| DMX-Wert für die maximale Goboshake-Geschwindigkeit
|style="width: 10em"| Minimale Goboshake-Geschwindigkeit
|style="width: 10em"| Maximale Goboshake-Geschwindigkeit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>goboshake</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 Hz bis 20 Hz</code>
| <code>0 Hz bis 20 Hz</code>
|}

=====Wheelrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>gobowheel</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<gobowheel dmxchannel="0">
<step type="open" mindmx="0" maxdmx="15" caption="Offen" />
<step type="gobo" val="congostar.png" mindmx="16" maxdmx="31" caption="Gobo 1" />
...
<wheelrotation>
<range type="cw" mindmx="223" maxdmx="192" minval="0.1" maxval="8" />
<range type="ccw" mindmx="224" maxdmx="255" minval="0.1" maxval="8" />
</wheelrotation>
</gobowheel>
</source>
Kontinuierliche Drehung des Goborads zwischen DMX-Wert 192 und 255 auf DMX-Kanal 1:
* Drehung des Goborads im Uhrzeigersinn mit 8 1/s bei DMX-Wert 192, abnehmend bis 0,1 1/s bei DMX-Wert 223.
* Drehung des Goborads gegen den Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 224, schneller werdend 8 1/s bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Drehzahl
|style="width: 10em"| DMX-Wert für schnellste Drehzahl
|style="width: 10em"| Minimale Drehzahl des Goborad
|style="width: 10em"| Maximale Drehzahl des Goborad
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 15 1/s</code>
| <code>0.01 1/s bis 15 1/s</code>
|}

===Prisma===
Mit Hilfe eines Prismas wird der Lichtstrahl mehrfach geteilt. Diese Funktion ist meistens bei Moving-Heads und Scannern und in verschiedenen Ausbaustufen zu finden. Möglich ist ein einfaches statisches Prisma bis hin zu mehreren Prismen mit verschiedenen Anzahlen an Facetten, die sich wiederum rotieren und positionieren lassen.

====Basis-Funktionen====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
<step type="prism" mindmx="128" maxdmx="191" caption="6-facets linear prism" />
<step type="prism" mindmx="192" maxdmx="255" caption="8-facets radial prism" />
</prism>
</source>
Prisma auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 63.
* 3-Facetten-Prisma bei DMX-Wert zwischen 64 und 127.
* Lineares 6-Facetten-Prisma bei DMX-Wert zwischen 128 und 191.
* Radial 8-Facetten-Prisma bei DMX-Wert zwischen 192 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! caption
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für zugehöriges Prisma
|style="width: 10em"| Maximaler DMX-Wert für zugehöriges Prisma
|style="width: 10em"| Beschreibung des Prismas
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>open</code> 
<code>prism</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}

====Zusätzliche Funktionen====
Für einzelne Funktionen des Kanals für das Prisma sind folgende zusätzliche Funktionen möglich:
* <code>prismindex</code>: Positionierung des Prismas in einem beliebigen Winkel
* <code>prismrotation</code>: Kontinuierliches Drehen des Prismas in verschiedene Richtungen

Diese zusätzlichen Funktionen können auf zwei verschiedenen Wegen aufgerufen werden:
* Für die Ansteuerung der zusätzlichen Funktionen kommen ein oder mehrere separete DMX-Kanäle zum Einsatz.
* Die zusätzlichen Funktionen liegen auf dem gleichen DMX-Kanal wie das Prisma selbst.

=====Prismenindizierung=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Separater DMX-Kanal für Prismenindizierung
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<prismindex dmxchannel="1">
<range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
</prismindex>
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
...
</prism>
</source>
Prisma auf DMX-Kanal 1, Prismenindizierung auf DMX-Kanal 2:
* Kein Prisma bei DMX-Wert zwischen 0 und 63 auf DMX-Kanal 1.
* 3.Facetten-Prisma statisch bei DMX-Wert zwischen 64 und 127 auf DMX-Kanal 1.
* Indizierung / Positionierung des eingelegten Prismas in einem beliebigen Winkel zwischen 0° und 360° bei einem DMX-Wert zwischen 0 und 127.
|-
| <code>prism</code>
| Prismenindizierung auf gleichem DMX-Kanal
| <source lang="xml">
<prism dmxchannel="0">
<prismindex />
<step type="open" mindmx="0" maxdmx="31" caption="Open" />
<step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
<range range="360" handler="prismindex" mindmx="32" maxdmx="119" minval="0" maxval="360" />
</step>
…
</prism>
</source>
Prisma mit Prismenindizierung auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 31.
* Positionierung des 3-Facetten-Prismas in einem beliebigen Winkel zwischen 0° bei DMX-Wert 32 und 360° bei DMX-Wert 119.
* Basisposition des Prismas bei einem DMX-Wert zwischen 120 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Maximaler Drehwinkel für die Prismenindizierung
|style="width: 10em"| DMX-Wert für die Start-Position
|style="width: 10em"| DMX-Wert für die End-Position
|style="width: 10em"| Start-Position der Prismenindizierung
|style="width: 10em"| End-Position der Prismenindizierung
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>0° bis 360°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 360°</code>
| <code>0° bis 360°</code>
|}

=====Prismenrotation=====
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>prism</code>
|style="width: 10em"| Separeter DMX-Kanal für Prismenrotation
|style="width: 60em"| <source lang="xml">
<prism dmxchannel="0">
<prismrotation dmxchannel="1">
<step type="stop" mindmx="191" maxdmx="192" />
<range type="cw" mindmx="193" maxdmx="255" minval="0.1" maxval="3.0" />
<range type="ccw" mindmx="190" maxdmx="128" minval="0.1" maxval="3.0" />
</prismrotation>
<step type="open" mindmx="0" maxdmx="63" caption="Open" />
<step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
...
</prism>
</source>
Prisma auf DMX-Kanal 1, Prismenrotation auf DMX-Kanal 2:
* Prisma statisch bei DMX-Wert zwischen 191 und 192, statisch.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 193, schneller werdend bis 3 1/s bei DMX-Wert 255.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/s bei DMX-Wert 128, abnehmend bis 0,1 1/s bei DMX-Wert 190.
|-
| <code>prism</code>
| Prismenrotation auf gleichem DMX-Kanal
| <source lang="xml">
<prism dmxchannel="0">
<prismrotation />
<step type="open" mindmx="0" maxdmx="31" caption="Open" />
<step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
<step type="stop" handler="prismrotation" mindmx="120" maxdmx="127" />
<range type="ccw" handler="prismrotation" mindmx="191" maxdmx="128" minval="0.1" maxval="3" />
<range type="cw" handler="prismrotation" mindmx="192" maxdmx="255" minval="0.1" maxval="3" />
</step>
…
</prism>
</source>
Prisma mit Prismenrotation auf DMX-Kanal 1:
* Kein Prisma bei DMX-Wert zwischen 0 und 31.
* 3-Facetten-Prisma bei DMX-Wert zwischen 32 und 127, statisch.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/s bei DMX-Wert 128, abnehmend bis 0,1 1/s bei DMX-Wert 191.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/s bei DMX-Wert 192, schneller werdend bis 3 1/s bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! handler !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für die minimale Drehzahl des Prismas
|style="width: 10em"| DMX-Wert für die maximale Drehzahl des Prismas
|style="width: 10em"| Minimale Drehzahl des Prismas
|style="width: 10em"| Maximale Drehzahl des Prismas
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>prismrotation</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.05 1/s bis 5 1/s</code>
| <code>0.05 1/s bis 5 1/s</code>
|}

===Position===
In der Funktion Position werden die DMX-Kanäle für die Pan- und Tilt-Bewegung von Moving-Heads und Scannern im DDF hinterlegt, also das horizontale und vertikale Bewegen des Kopfs bzw. des Spiegels.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>position</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<position>
<pan dmxchannel="0" finedmxchannel="1">
<range range="540" />
</pan>
<tilt dmxchannel="2" finedmxchannel="3">
<range range="240" />
</tilt>
</position>
</source>
Pan- und Tilt-Bewegung mit Auflösung von 16 bit auf den DMX-Kanälen 1 bis 4:
* Pan-Bewegung mit einem Schwenkbereich von 540° auf den DMX-Kanälen 1 und 2.
* Tilt-Bewegung mit einem Kippbereich von 240° auf den DMX-Kanälen 3 und 4.
|}

===Pan-Tilt-Geschwindigkeit===
Mit der Funktion für die Pan-Tilt-Geschwindigkeit wird festgelegt, wie schnell ein Moving-Head oder Scanner bei seinen Fahrten fährt.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>ptspeed</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<ptspeed dmxchannel="0">
<range type="linear" mindmx="255" maxdmx="0" minval="0" maxval="100" />
</ptspeed>
</source>
Pan-Tilt-Geschwindigkeit auf Kanal 1:
* Maximalwert der Pan-Tilt-Geschwindigkeit bei DMX-Wert 0, abnehmend auf geringsten Wert bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für geringste Pan-Tilt-Geschwindigkeit
|style="width: 10em"| DMX-Wert für maximale Pan-Tilt-Geschwindigkeit
|style="width: 10em"| Geringste Pan-Tilt-Geschwindigkeit
|style="width: 10em"| Maximale Pan-Tilt-Geschwindigkeit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Zoom===
Die Zoom-Funktion verändert den Abstrahlwinkel / Öffnungswinkel des Lichtstrahls des Geräts. Sie darf nicht mit der Iris verwechselt werden. Die Zoom-Funktion kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>zoom</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<zoom dmxchannel="0" >
<range mindmx="255" maxdmx="0" minval="14" maxval="30" />
</zoom>
</source>
Zoom auf DMX-Kanal 1:
* Lineare Verkleinerung des Lichtstrahls von 30° bei DMX-Wert 0 auf 14° bei DMX-Wert 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für kleinsten Öffnungswinkel
|style="width: 10em"| DMX-Wert für größten Öffnungswinkel
|style="width: 10em"| Kleinster Öffnungswinkel
|style="width: 10em"| Größter Öffnungswinkel
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 90°</code>
| <code>0° bis 90°</code>
|}

===Iris===
Mit der Iris kann der Lichtstrahl in seiner Größe bzw. der Projektionsbereich variiert werden. Die Iris arbeitet dabei in der Lichttechnik genauso wie die Iris in einem Fotoapparat. Im Gegensatz zum Zoom ändert sich der Abstrahlwinkel mit dem Öffnen und Schließen der Iris nicht. Bei nahezu geschlossener Iris wird nur ein kleiner Anteil des Lichtstrahls durch die Blende gelassen.

Die Iris-Funktion kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>iris</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<iris dmxchannel="0">
<range type="linear" mindmx="0" maxdmx="128" minval="0" maxval="100" />
</iris>
</source>
Iris auf DMX-Kanal 1:
* Lineare Öffnen der Iris von geschlossen (0%) bei DMX-Wert 0 auf vollständig geöffnet (100%) bei DMX-Wert 128.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für kleinste Öffnungsweite
|style="width: 10em"| DMX-Wert für größte Öffnungsweite
|style="width: 10em"| Kleinste Öffnungsweite
|style="width: 10em"| Größte Öffnungsweite
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Fokus===
Die Fokus-Funktion dient insbesondere zum motorisierten „Scharf-Stellen“ von Gobo von Moving-Heads und Scannern und kann durch das Einfügen von <code>finedmxchannel="1"</code> auf eine Auflösung von 16 bit erweitert werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>focus</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<focus dmxchannel="0">
<range mindmx="255" maxdmx="0" minval="0" maxval="100" />
</focus>
</source>
Fokus auf DMX-Kanal 1:
* Lineare Einstellung des Fokus von nah bei DMX-Wert 255 bis weit bei DMX-Wert 0.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| DMX-Wert für Fokus nah
|style="width: 10em"| DMX-Wert für Fokus weit
|style="width: 10em"| Fokus nah
|style="width: 10em"| Fokus weit
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 % bis 100 %</code>
| <code>0 % bis 100 %</code>
|}

===Nebel===
Über die Nebel-Funktion wird die Intensität des Nebelausstoßes gesteuert, sowohl bei einfachen Nebelmaschinen als auch bei Hazern.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>fog</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<fog dmxchannel="0" />
</source>
|}

===Ventilator===
Die Ventilator-Funktion steuert die Fördermenge eines Ventilators. Dies kann zum einen der Ventilator in einem Hazer sein, zum anderen eine DMX-gesteuerte Windmaschine.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>fan</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<fan dmxchannel="0" />
</source>
|}

===Freie Funktionen===
Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur im Device Control ausgegeben. Auch die Vorteile der HAL lassen sich auf diese frei definierten Funktionen anwenden.

Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:
* <code>rawstep</code>: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
* <code>raw</code>: Generiert einen einfachen Schieberegler.
* <code>const</code>: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.

{{BoxWichtig|Text=Alle oben genannten Elemente sind vollständig gerätespezifisch. Die HAL kann in Cuelists etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist. }}

====rawstep====
Über das Element rawstep wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:
* Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
* Einfügen und Entfernen einer Animationsscheibe in einem Moving-Head
* Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus

Im Gegensatz zu den fest definierten Funktionen muss beim <code>rawstep</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes <code>step</code> kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise der HAL.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>rawstep</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<rawstep dmxchannel="0" name="Mode">
<step caption="DMX" mindmx="0" maxdmx="9" />
<step caption="Auto" mindmx="10" maxdmx="199" />
<step caption="Music" mindmx="200" maxdmx="255" />
</rawstep>
</source>
Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal 1:
* Aktivierung des DMX-Modus bei DMX-Wert zwischen 0 und 9.
* Aktivierung der Automatik-Modus bei DMX-Wert zwischen 10 und 199.
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen 200 und 255.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! caption !! mindmx !! maxdmx
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Beschreibung der Funktion
|style="width: 10em"| Minimaler DMX-Wert zur Aktivierung der der Funktion
|style="width: 10em"| Maximaler DMX-Wert zur Aktivierung der der Funktion
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>Text</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}

{{BoxWichtig|Text=Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }}

====raw====
Das Element raw erzeugt im Device Control einen Schieberegler. Typische Anwendungsfälle sind hierfür:
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Einstellung der Mikrofon-Empfindlichkeit für die Sound-To-Light-Steuerung
* Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
* Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
* Nutzung für weitere Bewegungsachsen
* Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern
* Motorisierte Schieberblenden

Im Gegensatz zu den fest definierten Funktionen muss beim <code>raw</code> neben dem DMX-Kanal im Attribut <code>nam</code>e auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>raw</code>
|style="width: 10em"| Geschwindigkeitsregler für Automatikprogramme
|style="width: 60em"| <source lang="xml">
<raw dmxchannel="0" name="Macro speed" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</raw>
</source>
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:
* Geschwindigkeit der Automatikprogramme zunehmend von DMX-Wert bis DMX-Wert 255.
|-
| Vorlage für Animationsscheibe
| <source lang="xml">
<raw dmxchannel="0" name="Animation disk rotation" >
<step type="stop" mindmx="125" maxdmx="130" minval="0" maxval=""/>
<range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
<range type="ccw" mindmx="124" maxdmx="0" maxval="-0.05" minval="-2" />
</raw >
</source>
Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal 1:
* Animationsscheibe statisch bei DMX-Wert zwischen 125 und 130.
* Rotation der Animationsscheibe im Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 131, schneller werdend bis 2 1/s bei DMX-Wert 255.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/s bei DMX-Wert 124, abnehmend bis -0,05 1/s bei DMX-Wert 0.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"|
|style="width: 10em"| Minimaler DMX-Wert für die Funktion
|style="width: 10em"| Maximaler DMX-Wert für die Funktion
|style="width: 10em"| Kleinster Wert
|style="width: 10em"| Größter Wert
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>linear</code> 
<code>stop</code> 
<code>cw</code> 
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
|}

====const====
Das Element const wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.

Für das Element const ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.

Im Gegensatz zu den fest definierten Funktionen muss beim <code>const</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut <code>val</code> wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.

{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>const</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<const dmxchannel="0" name="Macro Effects" val="0" />
</source>
Makroeffekte auf DMX-Kanal 1:
* Dauerhaft gesetzter DMX-Wert 0.
|}

==Procedures==
Mit Hilfe von Procedures werden Funktionen aufgerufen, die im Live-Betrieb in der Regel nicht benötigt werden. Auch ein Abspeichern dieser Funktionen in Cues ist im Normalfall nicht erforderlich.

Auf diese Funktionen wird nicht über das Device Control, sondern im Stage View über das Kontexmenü des jeweiligen Geräts, über das Untermenü Procedures zugegriffen.

===Aufbau===
Procedures in DDFs für DMXControl 3 besitzen alle den gleichen Aufbau, der meistens aus vier Elementen besteht:
* Name der Funktion für das zugehörige Procedure
* <code>set</code>: Festlegung des DMX-Kanals und dem DMX-Wert
* <code>hold</code>: Haltezeit für den DMX-Wert
* <code>restore</code>: Wiederherstellung des Ausgangszustands

Lässt man das Element <code>restore</code> in einem Procedure weg, bleibt der unter <code>set</code> eingetragene DMX-Wert gesetzt.

===Verfügbare Procedures===
Aktuell sind in DMXControl 3 folgende Procedures bereits hinterlegt, es können aber auch Procedures mit eigenen Namen erstellt werden. Für die gängigsten Funktionen werden dem Namen automatisch auch eindeutige Symbole zugeordnet.
Wie die Benennung erfolgt, kann selbst festgelegt werden, da mit den Procedures direkt DMX-Kanäle mit DMX-Werten angesprochen werden. Es ist daher möglich, mit dem Procedure zum Einschalten der Lampe auch einen vollständigen Gerätereset zu starten. Allerdings ist diese Vorgehensweise nicht zu empfehlen.

{| class="wikitable toptextcells"
|-
! Procedur-Name
! Beschreibung
! Bemerkung
|-
|style="width: 10em"| lamp_on
| Schaltet die Lampe des entsprechenden Geräts ein.
|
|-
| lamp_off
| Schaltet die Lampe des entsprechenden Geräts aus.
|
|-
| reset
| Löst am entsprechenden Gerät einen Reset aus.
|
|-
| reset_pan_tilt
| Löst am entsprechenden Gerät einen Reset der Pan & Tilt Motoren aus.
| Das Gerät fährt mit Pan & Tilt seine Referenzpunkte an.
|-
| reset_pan
| Löst am entsprechenden Gerät einen Reset des Pan Motors aus.
| Das Gerät fährt mit Pan seine Referenzpunkte an.
|-
| reset_tilt
| Löst am entsprechenden Gerät einen Reset des Tilt Motors aus.
| Das Gerät fährt mit Tilt seine Referenzpunkte an.
|-
| reset_gobo
| Löst am entsprechenden Gerät einen Reset des Gobo Motors aus.
| Das Goborad fährt seine Referenzpunkte an.
|-
| reset_gobo2
| Löst am entsprechenden Gerät einen Reset des Gobo2 Motors aus.
| Das Goborad 2 fährt seine Referenzpunkte an.
|-
| reset_color
| Löst am entsprechenden Gerät einen Reset des Color Motors aus.
| Das Farbrad fährt seine Referenzpunkte an.
|-
| reset_color2
| Löst am entsprechenden Gerät einen Reset des Color2 Motors aus.
| Das Farbrad 2 fährt seine Referenzpunkte an.
|-
| reset_effects
| Löst am entsprechenden Gerät das Zurücksetzen der eingebauten Effekte aus.
|
|-
| reset_zoom
| Löst am entsprechenden Gerät den Reset der Zoom-Funktion aus.
|
|-
| reset_shutter
| Löst am entsprechenden Gerät den Reset des Shutters aus.
|
|-
| reset_iris
| Löst am entsprechenden Gerät den Reset der Iris-Blende aus.
|
|-
| reset_focus
| Löst am entsprechenden Gerät den Reset der Fokusfunktion aus.
|
|-
| reset_prism
| Löst am entsprechenden Gerät einen Reset des Prismarades aus.
|
|-
| pan_invert_on
| Am entsprechenden Gerät wird der Pan-Kanal invertiert.
|
|-
| pan_invert_off
| Am entsprechenden Gerät wird die Invertierung des Pan-Kanals aufgehoben.
|
|-
| tilt_invert_on
| Am entsprechenden Gerät wird der Tilt-Kanal invertiert.
|
|-
| tilt_invert_off
| Am entsprechenden Gerät wird die Invertierung des Tilt-Kanals aufgehoben.
|
|-
| pan_tilt_swap_on
| Am entsprechenden Gerät werden Pan und Tilt vertauscht.
|
|-
| pan_tilt_swap_off
| Die Vertauschung von Pan und Tilt wird deaktiviert.
|
|-
| display_on
| Das Display des entsprechenden Gerätes wird aktiviert.
|
|-
| display_off
| Das Display des entsprechenden Gerätes wird deaktiviert.
|
|}

===Beispiele===
{| class="wikitable toptextcells"
|-
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>reset</code>
|style="width: 10em"| Vollständiger Reset des Gerätes
|style="width: 60em"| <source lang="xml">
<reset>
<set dmxchannel="0" value="255" />
<hold value="6000" />
<restore dmxchannel="0" />
</reset>
</source>
Reset
* Setzen DMX-Kanal 1 auf DMX-Wert 255.
* Halten des DMX-Werts für 6000 ms (6 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>lamp_on</code>
| Leuchtmittel einschalten
| <source lang="xml">
<lamp_on>
<set dmxchannel="0" value="255" />
<hold value="4000" />
<restore dmxchannel="0" />
</lamp_on>
</source>
Leuchtmittel einschalten
* Setzen DMX-Kanal 1 auf DMX-Wert 255.
* Halten des DMX-Werts für 4000 ms (4 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>lamp_off</code>
| Leuchtmittel ausschalten
| <source lang="xml">
<lamp_off>
<set dmxchannel="0" value="50" />
<hold value="8000" />
<restore dmxchannel="0" />
</lamp_off>
</source>
Leuchtmittel ausschalten
* Setzen DMX-Kanal 1 auf DMX-Wert 50.
* Halten des DMX-Werts für 8000 ms (8 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|-
| <code>procedure</code>
| Eco-Mode für Leuchtmittel
| <source lang="xml">
<procedure name="Lamp eco mode">
<set dmxchannel="0" value="170" />
<hold value="4500" />
<restore dmxchannel="0" />
</procedure>
</source>
Eigenes Procedure mit dem Namen „Eco-Mode für Leuchtmittel“
* Setzen DMX-Kanal 1 auf DMX-Wert 170.
* Halten des DMX-Werts für 4500 ms (4,5 s).
* Wiederherstellung des ursprünglichen DMX-Wertes für DMX-Kanal 1.
|}

==Fehlerbehebung: warum funktioniert mein DDF nicht?==
Dies sind häufige Fehler, die verhindern, dass ein DDF zu einem Projekt hinzugefügt werden kann:
* Bei Pan- und Tilt wurde im Attribut <code>range</code> kein Schwenkbereich angegeben.
* Für Strobe ist kein Wert für <code>minval</code> und <code>maxval</code> hinterlegt.
* Der Tag <code>model</code> ist noch falsch geschrieben.

==Links und Referenzen==
{{BoxHinweis
|Text=Ein [[DDFCreator3.0#DDFCreator3.x|DDFCreator]] für DMXControl 3 ist bereits in Arbeit, siehe [http://www.dmxcontrol.de/forum/index.php?page=Thread&threadID=7931&pageNo=1 Forum]. Ihr könnt mit diesem Prototype arbeiten oder die eigenen DDFs mit einem XML-Editor Eurer Wahl oder einfach mit einem Texteditor erstellen. Manchmal hilft es, ein bereits existierendes DDF zu kopieren und anzupassen.
Gerne könnt ihr eure neuen DDFs auch im Forum teilen: [https://forum.dmxcontrol-projects.org/index.php?thread/7935-dmxcontrol-3-ddf-sammler-nur-funktionierende-ddfs-bitte/ DDF Sammlung].
}}

Fußnoten
<references/>
{{End-LaTeX}}
{{NavigationTop-Man3
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}

[[Kategorie: Handbuch DMXControl 3]]

Liste von Herstellern

2017-10-25T19:58:03Z

Pgrote:

0energyLighting 
A & O Lighting 
A.C. Lighting 
AAdynTech 
AC Lighting 
ADB 
APE Labs 
ARRI 
Ablelite International 
Abstract 
Acclaim 
Acme 
Actor 
Adam Hall 
Aeson 
Alkalite 
Altman Lighting 
American DJ 
American Pro 
Amptown 
Anexo 
Anolis 
Antari 
Ape Labs 
Apollo Light 
Arkaos 
Art Lighting 
Artistic License 
Astera LED Technology 
Asymptech 
Atac 
Audio Visual Engineering 
Aurorae 
Avolites 
Ayrton 
BB&S 
BEST LIGHT 
Bandit Lites 
Barco 
BargeHeights 
BeamZ 
Behringer 
Big Dipper 
Birket Engineering 
Black Tank 
Blizzard Lighting 
Boost 
Borphi 
Botex 
Botion Lighting Equipment 
BrightLight 
Brite Shot 
Briteq 
Brother Brother and Sons 
CKC 
CY Lighting 
Cameo 
Canara 
Centerline Lighting 
Charming Technology 
Chauvet 
Christie 
Chroma-Q 
Chromaviso 
Chromlech 
Cindy 
Cineo Lighting 
City Theatrical 
Clay Paky 
COEF Lighting 
Coemar 
Color Imagination 
ColorKey 
ColorVerse 
Compulite 
Conrad 
Constella 
Contest 
Coolux 
Creative Lighting 
DIALighting 
DML 
DMX4ALL 
DMXControl Projects e.V. 
DTS 
Daisy Lighting Equipment Factory 

Darklight Precision Lighting System 
Deliya 
Derksen 
Digital Enlightenment 
Digital Sputnik Lighting 
DiscoTech 
Diversitronics 
Divine Lighting 
Dortron Showtec 
Doug Fleenor Designs 
Dune 
ETC 
Eagle Fai 

Eddylight 
Ehrgeiz 
Elation 
Elation Architectural 
Elation 
:Electroconcept
Electron 
Elektralite 
Element Labs 
Elements 
Eliminator 
Elite 
:Empire Electronic
Eurolite 

:EvenTec
Evolight 
Expolite 

Fal 
FiberLamp 
Fiilex 
Fine Art 
:Firestorm
Flash Butrym 
Flix 
Fort 
Fountain People 
Fritz N 
Futurelight 
G 13 Lighting 
G-Lec 
G-Lites 
:GAD
GAM 
GLP 
GRNLite 
GTech 
Gekko Technology 
Generic 
Geni 
Gerriets 
Global Design Solutions 
Golden Sea 
Grande Engineering 
Green Hippo 
Greenlight Lighting 
Griven 
:HB-Laser
HQ Power 
HTL 
Haya Light Equipment 
Hazebase 
Hendrik Hoelscher 
High End Systems 
Hong Yi Stage Lighting 
Howard Eaton Lighting 
Hungaroflash 
IMG Stage Line 
Ibiza 
Idealight Industrial 
Ignition 
:Illumion
Illumivision 
Iluminarc 
ImageCue 
Insight Lighting 
Involight 
Irradiant 
JB Systems 
JB-Lighting 
Jem 
:Jenbo Lighting International
K9 Lighting 
KLS Lighting 

Kam 
:Kapego
Kino Flo 

LDDE 
LDR 
:LEADER LIGHT
LEE 
LOOK Solutions 
Lampo Lighting 
LanBolight Technology 
:Lanling Tech
Lanling 
Lanta Lighting 
Laser Imagineering 
Laser UK 
Laserworld 
Laserworld 
Le Maitre 
Leader Light 
Leddux 
Licht Technik 
Light Emotion 
:Light Sky
LightGraphix 
LightSky 
Lighting Innovation 
Lightmaxx 
Lightning Strikes 
Lightronics 
:Lite Works
Litecraft 
Litepanels 
Logvinov 
Longman 
Look Solutions 
Lumenpulse 
Lumi Professional 
:Lumin Lights
Lumisia 
Lumonic Limited 
MA Lighting 
:MAD
:MAIKLUX
MDG 
MT Lighting 
:MZ Vision
Madrix 
:Magic
Martin 
:Matrix
Mc Crypt 
:MediaLas
Mega Diode 
Megalite 
Megastage 
Meteor 
Microh 
Milford Instruments 
Monacor International 
Monoprice 
Morpheus 
Movitec 
Multiform Lighting 
Mushroom Lighting Technology 
NAT 
NJD Electronics 
:NSI
:NV Belgian German Elect Corporation
NW Lighting FX 
NeoNeon 
Nicols 
Nightsun 
Novalight 
OXO Show Solutions 
Ocean Optics 
:Octopod
Omez Lighting 
Omni Lighting 
Omni Sistems 
Omnitronic 
Optima 
Osiris 
Osram 
Outsight 
PC Lights 
PR Lighting 
PRG 
PSL 
Panasonic 

:Panther Lights
Pasef 
:Pearl River

Philips 
Photon Star 
Picturall 
PixMob 
PixelRange 
Precision Projection Systems 
Prism Projection 
:ProLights
:ProTech

Proel 
Prolight 
Prolights 
Pulsar 

QTX Lighting 
Qmaxz 
RC4 
ROBE Lighting 
Rainbow 
Rave Laser 
Red Lighting 
:Reke
Remote Controlled Lighting 
Renewed Vision 
Resolume 
Rige Lighting 
Robe 

Robert Juliat 
Roblon 

Rosco 
SAMSC 

SGM 
:SMART4CARS
:STAGELux
:Sagitter
:SainStyle
:Scanic
Schnick Schnack Systems 
Screen Monkey 
Selador 
Selecon 
ShenZhen Becen 
Shinp 
Show Series 
Show Technology 
:ShowLED
Showco 
Showled 
Showline 
:Showlite
Showtec 
Silver Star 

Skytec 
Smoke Factory 
Snowmasters Special Effects 

Space Cannon 
Spark Lighting 

Spotlight 
Stage Ape Lighting 

Stage Line 
Stage Technologies 
:StageLux
:Stagetech
Stagg 
StairVille 

:Starlite System Technology
Starway 
Stellar Labs 

Strand 

Studio Due 
:Sunstage Light
Suntech 
Swefog 
Swelite 
Syncrolite 
T8 Technologies 
TAS 
TBF Pyrotec 
TE Lighting 

TIR 
:TKO
TL Laser 
TMB 
TPR Enterprises 
Targetti 
:Teanma

Technilux 

Technylight 
Teclumen 
Terbly 
Thorn 
Tokistar 
Toplite 
Transtun 
Traxon Technologies 
Triangle Lights 
Triton Blue 
TyLED 
Ulrich Radig 
:Ultralite
Ultratec Special Effects 
:Uni-lyte
Universal Fibre Optics 
V:LED 
VAS Lighting 
VariLite 
Varytec 
:Vehor
Velleman 
Vello 
Venue Effects Lighting 
:Verhor
Versa-Light 
Viking Stage Lighting 
Vincent 
Vision Light 
Visual Effects 
Visual Productions 
Volkslaser 
Wecan 
:Welaku
White Light 
Wiedamark 
Wildfire 
Wilgex 
Work 
Wybron 
X-Laser 
XAL 
:XLTC
Xenio 
Xilver 
Yaohai Electronics 
Yellow River 
Yorkville 
Zap Technology 
Zero 88 
:Zoom
Zylight 
elumen8 
i-Pix 
iLED 
iSolutions 
interlite 
mbT Lighting 
wdm lighting