DDF DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
(Ebenen der Überschriften verschoben)
Keine Bearbeitungszusammenfassung
 
(56 dazwischenliegende Versionen von 4 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.1.1}} {{Inuse}}
{{Manual Header
 
| Type = DMXC3 DDFs
{{NavigationTop-Man3
| Version = 3.3.0
|zurückLink =
|zurückText =
|vorLink =
|vorText =
}}
}}
{{Start-LaTeX}}
{{Hinweis|18.10.2013: JKuehn: Artikel wurde erstellt<br>
14.04.2015: JKuehn: Übertragung des Artikels muss durchgeführt werden}}
=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 Movinghead, 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 Movingheads 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.
=Speicherort: Wo sind die DDFs zu finden?=
Die DDFs von DMXControl 3 sind lokal auf dem PC in folgendem Verzeichnis zu finden:
<br />
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\
</source>
<br />
[Installationsverzeichnis] steht hierbei für das Verzeichnis, in dem DMXControl 3 installiert wurde. Wurde dies beim Installieren nicht geändert, lautet der Pfad üblicherweise
<br />
<source lang="xml">
C:\Programme (x86)\DMXControl3\
</source>
<br />
Das Bild für das Icon des Geräts in der Stage View liegt immer im Verzeichnis
<br />
<source lang="xml">
[Installationsverzeichnis]\kernel\devices\images\
</source>
<br />
und die Icons der Gobos unter
<br />
<source lang="xml">
[Installationsverzeichnis]\kernel\icons
</source>
<br />
=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
<br />
<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>
<br />
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"
|-
! Attribut !! Beschreibung !! Standard-Wert !! Zulässige Werte !! Optional
|-
| <code>image</code> || Bild-Datei des DDFs || Nicht vorhanden || Dateiname des Bilds als *.png-Datei ||
|-
| <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
|}
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"
|-
! Tag !! Beschreibung !! Optional
|-
| <code>model</code> || Bezeichnung des Geräts gemäß Bedienungsanleitung ||
|-
| <code>vendor</code> || Hersteller des Geräts gemäß vorgegebener Herstellerliste ||
|-
| <code>author</code> || Autor des DDFs ||
|-
| <code>mode</code> || DMX-Modus || 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====
DDF ist die Abkürzung für {{Manual Objectcaption|"Device Definition File"}}. DDFs werden von DMXControl verwendet, um Informationen über die verwendeten Geräte zu erhalten:
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 Movinghead 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.
* welche DMX-Kanäle werden überhaupt belegt?
* welche Funktionen habe die verschiedenen DMX-Kanäle?
* wie sehen die Farben auf einem Farbrad bzw. die Gobo auf einem Goborad aus?
* gibt es verschiedene Strobe-Funktionen und wenn ja, welche?
Dies und viele weitere Informationen sind in einem vollständigen DDF enthalten. DMXControl 3 benötigt die Informationen, um anhand dessen die Bedienoberfläche in Form der {{Manual Windowcaption|[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} und den {{Manual Windowcaption|[[Control Panel DMXC3|Steuerfenster (Control Panel)]]}} aufzubauen. Darüber hinaus ermöglicht DMXControl 3 unter Einbeziehung des {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraktions-Layers (HAL)]]}} auch das Ansteuern unterschiedlicher Geräte. Alle Informationen werden in der Datei in einer klassischen XML-Struktur beschrieben, sodass alle Angaben auch nur mit dem klassischen Editor von Windows oder Notepad++<ref>Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen auf der Herstellerseite: https://notepad-plus-plus.org/</ref> und dem dort verfügbaren Plugin XML-Tools<ref> Installationsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Pluginadministrator von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2</ref> im Klartext lesbar sind.


===Procedures===
Dieser Teil des Handbuchs über DMXControl 3 beschäftigt mit der Erstellung von DDFs. Die Unterteilung der Artikel orientiert sich dabei an den vorhandenen {{Manual Windowcaption|Steuerfenster}} in DMXControl 3 selbst. Der Teil des Handbuchs zu den DDFs in DMXControl 3 gliedert sich in vier Bereiche:
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 Movingheads 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.
* [[Einführung (DDF-Syntax) DMXC3|'''Grundlagen''']] und wichtige Hinweise zur DDF-Erstellung
* [[Intensity (DDF-Syntax) DMXC3|'''Syntax''']] der unterstützten Funktionen
* [[Procedures (DDF-Syntax) DMXC3|'''Procedures''']] zum Aufrufen bestimmter Gerätefunktionen
* [[DDF-Tutorial LED-Scheinwerfer DMXC3|'''Beispiele''']] zur manuellen Programmierung von DDFs für DMXControl 3


==Aufbau einer Funktion auf einem DMX-Kanal==
{{Manual Box | de | Important | Der aktuelle DDFCreator unterstützt auf Grund seines Alters nicht alle Funktionen, die in den DDFs für DMXControl 3 abgebildet werden können. Unter Umständen löscht der [[DDFCreator 3|DDFCreator]] Bestandteile im DDF, die dieser nicht kennt. Daher ist es empfehlenswert, den DDFCreator nicht mehr zu verwenden, sobald im DDF manuell zusätzliche Funktionen hinzugefügt wurden.}}
Liegen auf einem DMX-Kanal wie beispielsweise beim Strobe, Shutter oder Goborad mehrere Funktionen, so werden diese in zwei Kategorien unterteilt:
{{Manual Box | de | Attention | DDFs für DMXControl 2 sind nicht mit den DDFs für DMXControl 3 kompatibel, da sich der interne Aufbau komplett unterscheidet. DMXControl 3 benötigt für den {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraktions-Layers (HAL)]]}} zusätzliche Informationen. Auch bringen die DDFs keine selbst gebaute Bedienoberfläche mit. Alle Steuerelemente generiert DMXControl 3 einheitlich über die GUI.}}
* <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.
<br />
<source lang="xml">
<step type="open" mindmx="225" maxdmx="255" />
</source>
<br />
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.
<br />
<source lang="xml">
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
</source>
<br />
==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 Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Gobo-Rotation 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"
|-
! Wert !! Einheit !! Verwendung
|-
| Drehzahl || <code>1/min</code> (Umdrehung pro Minute) || 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
|}
=Beispiel: So sieht ein einfaches DDF aus=
Für einen einfachen LED-PAR-Scheinwerfer mit eigenem Dimmer- und Strobe-Kanal soll im Folgenden ein DDF erstellt werden. Das LED-PAR-Scheinwerfer hat damit fünf DMX-Kanäle.
==Basisteil==
Nach den Informationen zum Dokumentenstandard wird mit dem Tag <code>device</code> der Bereich für die eigentlichen Informationen geöffnet, die im DDF hinterlegt sind. Die Bild-Datei für das Icon in der Stage View trägt den Dateinamen <code>led-par.png</code>. Bei dem Gerät handelt es sich um ein <code>DMXDevice</code> mit <code>5</code> DMX-Kanälen. Das DDF wird für DMXControl Version <code>3</code> erstellt und wurde bislang nur einmal bearbeitet, weswegen es die Version <code>1</code> ist.
<br />
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<device image="led-par.png" type="DMXDevice" dmxaddresscount="5" dmxcversion="3" ddfversion="1">
</source>
==Informationsteil==
Im Informationsteil ist die Bezeichnung des Geräts, in diesem Fall <code>LED-PAR</code> hinterlegt, der vom Hersteller <code>Various</code> geliefert wurde. Erstellt hat dieses DDF <code>Stefan Kistner</code> und es ist gültig für den DMX-Modus <code>Basic</code>. Alle diese Informationen sind durch das Element <code><information> ... </information></code> eingeklammert.
<br />
<source lang="xml">
  <information>
    <model>LED-PAR</model>
    <vendor>Various</vendor>
    <author>Stefan Kistner</author>
    <mode>Basic</mode>
  </information>
</source>
==Funktionsteil==
Der Funktionsteil wird immer durch den Tag <code>functions</code> geöffnet.
===Dimmer-Kanal===
Es wird als erstes ein Dimmer-Property für den DMX-Kanal 1 angelegt, welches in dem DMX-Bereich (<code>range</code>) von <code>192</code> (dunkel) bis <code>0</code> (hell) im Gerät implementiert ist. Der Parameterwertebereich erstreckt sich von <code>minval</code> bis <code>maxval</code>, also von <code>0</code> bis <code>100</code>. Im Dimmer-Property wird also die Intensität zwischen 0 (%) und 100 (%) eingestellt und DMXControl 3 rechnet diese dann proportional in die DMX-Werte um anhand der Zuordnung <code>mindmx</code> ≙ <code>minval</code> und <code>maxdmx</code> ≙ <code>maxval</code>.
<br />
<source lang="xml">
  <functions>
    <dimmer dmxchannel="0" mindmx="192" maxdmx="0" minval="0" maxval="100" />
</source>
===Kanäle für rot, grün und blau===
Da bei diesem LED-PAR-Scheinwerfer nur rote, grüne und blaue LEDs für die Farbmischung verbaut sind, wird im DDF ein einfaches RGB-Element verwendet. Dabei steuert der DMX-Kanal 2 die roten LEDs, der DMX-Kanal 3 die grünen und der DMX-Kanal 4 die blauen LEDs.
<br />
<source lang="xml">
    <rgb>
      <red dmxchannel="1" />
      <green dmxchannel="2" />
      <blue dmxchannel="3" />
    </rgb>
</source>
===Strobe-Kanal===
Der Strobe-Kanal liegt auf Kanal 5. Der vorliegende LED-PAR-Scheinwerfer verfügt nur über eine einfache Strobe-Funktion, die beim DMX-Wert <code>0</code> aus ist (<code>0</code> Hz) und bis DMX-Wert <code>255</code> kontinuierlich schneller wird bis zu einer Strobe-Frequenz von <code>15</code> Hz. Wichtig ist an dieser Stelle, dass die Einheit (hier Hertz) nicht eingetragen wird.
Da nach dem Strobe-Element keine weiteren Funktionen folgen, wird das Element <code><functions></code> mit dem End-Tag <code></functions></code> geschlossen.
<br />
<source lang="xml">
    <strobe dmxchannel="4" >
      <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
    </strobe>
  </functions>
</source>
==Procedures==
Bei diesem einfachen LED-PAR-Scheinwerfer gibt es keine Sonderfunktionen, wie zum Bespiel die Initiierung eines Reset (ein Neustart) des Geräts. Deswegen entfällt das Element für Procedures komplett.
Zum Schluss muss das Element <code><device></code> noch mittels des End-Tags <code></device></code> geschlossen werden.
==Zusammenfassung==
Das komplette DDF für diesen LED-PAR-Scheinwerfer sieht wie folgt aus:
<br />
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<device image="led-par.png" type="DMXDevice" dmxaddresscount="5" dmxcversion="3" ddfversion="1">
  <information>
    <model>LED-PAR</model>
    <vendor>Various</vendor>
    <author>Stefan Kistner</author>
    <mode>Basic</mode>
  </information>
  <functions>
    <dimmer dmxchannel="0" mindmx="192" maxdmx="0" minval="0" maxval="100" />
    <rgb>
      <red dmxchannel="1" />
      <green dmxchannel="2" />
      <blue dmxchannel="3" />
    </rgb>
    <strobe dmxchannel="4" >
      <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
    </strobe>
  </functions>
</device>
</source>
=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 Movingheads 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 Movingheads 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.


= Grundlagen =
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
|-
|-
|style="width: 10em" rowspan="3"| <code>dimmer</code>
! [[Einführung (DDF-Syntax) DMXC3|Allgemeine Einführung]]
|style="width: 10em"| Standard
| Die allgemeine Einführung gibt einen groben Überblick, was DDFs im Kontext von DMXControl 3 sind, nach welchen Merkmalen die DDFs in DMXControl 3 zum Einsatz kommen und welche Verzeichnisse auf dem PC für die DDFs genutzt werden.
|style="width: 60em"| <source lang="xml">
<dimmer dmxchannel="0" />
</source>
Dimmer auf DMX-Kanal 1
|-
|-
| Dimmer mit 16 bit-Auflösung
! [[Grundaufbau (DDF-Syntax) DMXC3|Grundaufbau]]
| <source lang="xml">
| Dieser Artikel beschreibt die grundlegende Struktur eines DDFs für DMXControl 3 sowie die Angaben wie Informationen zum Gerät, die im Informationsteil zu machen sind.
<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" />
</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".
 
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! [[Funktionselemente (DDF-Syntax) DMXC3|Funktionselemente]]
| In diesem Artikel werden verschiedene Gemeinsamkeiten erläutert, die unabhängig von der verwendeten Funktion zu einer vollständigen Definition von insbesondere komplexeren DMX-Kanälen benötigt werden und daher in den meistern DDFs zu finden sind.
|-
|-
|style="width: 10em"| <code>switch</code>
! [[Grundregeln (DDF-Syntax) DMXC3|Grundregeln]]
|style="width: 10em"| Standard
| Die Grundregeln fassen zusammen, von welchen Einheiten der HAL beispielsweise bei der Festlegung der maximalen Strobefrequenz ausgeht.
|style="width: 60em"| <source lang="xml">
<switch dmxchannel="0" />
</source>
Switch auf DMX-Kanal 1
|}
|}


==Shutter==
{{Manual Box | de | Hint | DMXControl 3.2 unterstützt noch keine Multibeam-Geräte (Geräte mit seperat gesteuerten Lampen). Dies kann mithilfe mehrerer einzelner DDFs, bzw. einem DDF und Generic RGB, Dimmer, etc. umgangen werden.}}
Der Shutter ist meistens bei Movingheads 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 Movingheads 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.
= Funktionsübersicht =
In den DDFs werden folgende Funktionen direkt von der HAL unterstützt. Die Tabelle verweist euch auf die verschiedenen Artikel, in denen euch die jeweiligen Funktionen inklusive aller möglichen Varianten mit entsprechenden Beispielen erklärt werden.


{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! style="height: 40px; width: 200px" | Bereich !! style="width: 600px" | Funktionen
|-
|-
|style="width: 10em"| <code>shutter</code>
! [[Intensity (DDF-Syntax) DMXC3|Intensität]]
|style="width: 10em"| Standard
| [[Intensity (DDF-Syntax) DMXC3#Dimmer|Dimmer]], [[Intensity (DDF-Syntax) DMXC3#Switch|Switch]], [[Intensity (DDF-Syntax) DMXC3#Shutter|Shutter]], [[Intensity (DDF-Syntax) DMXC3#Strobe|Strobe]]
|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
! [[Position (DDF-Syntax) DMXC3|Position]]
| [[Position (DDF-Syntax) DMXC3#Position|Position]], [[Position (DDF-Syntax) DMXC3#Pan-Tilt-Geschwindigkeit|Pan-Tilt-Geschwindigkeit]]
|-
|-
!style="width: 10em; vertical-align:top"| Beschreibung
! [[Color (DDF-Syntax) DMXC3|Farbe]]
|style="width: 10em"|  
| [[Color (DDF-Syntax) DMXC3#RGBx-Farbmischung|RGBx-Farbmischung]], [[Color (DDF-Syntax) DMXC3#CMY-Farbmischung|CMY-Farbmischung]], [[Color (DDF-Syntax) DMXC3#HSV-Farbmischung|HSV-Farbmischung]], [[Color (DDF-Syntax) DMXC3#Farbrad|Farbrad]], [[Color (DDF-Syntax) DMXC3#Farbtemperatur|Farbtemperatur]]
|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
! [[Matrix (DDF-Syntax) DMXC3|Pixel-Effekte]]
| <code>closed</code><br />
| [[Matrix (DDF-Syntax) DMXC3#Matrix|Matrix]], [[Radix (DDF-Syntax) DMXC3#Radix|Radix]]
<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
! [[Gobo (DDF-Syntax) DMXC3|Gobo]]
| [[Gobo (DDF-Syntax) DMXC3#Goborad|Goborad]]
|-
|-
|style="width: 10em"| <code>strobe</code>
! [[Beam (DDF-Syntax) DMXC3|Lichtstrahl]]
|style="width: 10em"| Standard
| [[Beam (DDF-Syntax) DMXC3#Fokus|Fokus]], [[Beam (DDF-Syntax) DMXC3#Frost|Frost]], [[Beam (DDF-Syntax) DMXC3#Iris|Iris]], [[Beam (DDF-Syntax) DMXC3#Zoom|Zoom]]
|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
! [[Blades (DDF-Syntax) DMXC3|Blendenschieber]]
| [[Blades (DDF-Syntax) DMXC3|Blendenschieber]]
|-
|-
!style="width: 10em; vertical-align:top"| Beschreibung
! [[Effectwheel (DDF-Syntax) DMXC3|Effektrad]]
|style="width: 10em"|
| [[Effectwheel (DDF-Syntax) DMXC3#Prisma|Prisma]], [[Effectwheel (DDF-Syntax) DMXC3#Effektrad|Effektrad]]
|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
! [[Stage Effect (DDF-Syntax) DMXC3|Bühneneffekte]]
| <code>linear</code><br />
| [[Stage Effect (DDF-Syntax) DMXC3#Nebel|Nebel]], [[Stage Effect (DDF-Syntax) DMXC3#Ventilator|Ventilator]]
<code>pulse</code><br />
<code>random</code><br />
<code>ramp up</code><br />
<code>ramp down</code><br />
<code>ramp up/down</code><br />
<code>lightning</code><br />
<code>spikes</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0 Hz bis 30 Hz</code>
| <code>0 Hz bis 30 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====
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! [[Open Function (DDF-Syntax) DMXC3|Allgemeine Funktionen]]
| [[Open Function (DDF-Syntax) DMXC3#Index|Index]], [[Open Function (DDF-Syntax) DMXC3#Rotation|Rotation]], [[Open Function (DDF-Syntax) DMXC3#Cool|Cool]], [[Open Function (DDF-Syntax) DMXC3#Heat|Heat]]
|-
|-
|style="width: 10em"| <code>strobe</code>
! [[Open Function (DDF-Syntax) DMXC3|Freie Funktionen]]
|style="width: 10em"| Standard
| [[Open Function (DDF-Syntax) DMXC3#rawstep|rawstep]], [[Open Function (DDF-Syntax) DMXC3#raw|raw]], [[Open Function (DDF-Syntax) DMXC3#rawranges|rawranges]], [[Open Function (DDF-Syntax) DMXC3#const|const]]
|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 1 Hz bis 12 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 1 Hz bis 12 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===
= Procedures =
Für den gesamten Strobe-Kanal sind folgende ergänzende Funktionen möglich:
* <code>duration</code>: Einstellen der Blitzdauer
 
====Duration====
{| 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"
{| class="wikitable toptextcells"
|-
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
|-
|-
!style="width: 10em; vertical-align:top"| Beschreibung
! [[Procedures (DDF-Syntax) DMXC3|Funktionen]]
|style="width: 10em"|
| Dieser Artikel listet alle in DMXControl 3 verfügbaren Procedures auf.
|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
! [[Procedures (DDF-Syntax examples) DMXC3|Beispiele]]
| <code>linear</code>
| Der Artikel zeigt ein paar Beispiele für vorgegebene, aber auch für eigene Procedures.
| <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==
= Tutorials =
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.
 
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! style="height: 40px; width: 200px" | Kapitel !! style="width: 600px" | Zusammenfassung
|-
|-
|style="width: 10em" rowspan="3"| <code>rgb</code>
! [[DDF-Tutorial LED-Scheinwerfer DMXC3|LED-Scheinwerfer]]
|style="width: 10em"| RGB (Standard)
| Im ersten von insgesamt drei Tutorials wird das DDF für einen einfachen LED-Scheinwerfer erstellt. Als Vorlage dient Cameo LED Mini Tri Par Can 3W.
|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
! [[DDF-Tutorial 4er-Bar DMXC3|4er-LED-Bar]]
| <source lang="xml">
| Das zweite Tutorial behandelt die manuelle Erstellung eines DDFs für einer 4er-LED-Bar am Beispiel der Eurolite LED KLS-2500.
<rgb>
  <red dmxchannel="0" />
  <green dmxchannel="1" />
  <blue dmxchannel="2" />
  <white dmxchannel="3" />
</rgb>
</source>
|-
|-
| RGBA
! [[DDF-Tutorial Moving Head DMXC3|Moving Head]]
| <source lang="xml">
| Das dritte Beispiel zeigt, wie das DDF für einen einfachen Moving Head erstellt wird. Als Vorlage dient hier der Showtec Indigo 150 LED, der teilweise auch unter anderen Marken vertrieben wurde.
<rgb>
  <red dmxchannel="0" />
  <green dmxchannel="1" />
  <blue dmxchannel="2" />
  <amber dmxchannel="3" hueLeftBottom="0" hueLeftTop="60" hueRightTop="60" hueRightBottom="120" />
</rgb>
</source>
|}
|}


Die weiße LED wird 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:
= Links und Referenzen =
* None: Keine Ansteuerung der weißen LED (Standard-Einstellung)
== Links ==
* Add white: Alle vier LEDs bei 100% für die Farbe weiß
<references/>
* Only white: Nur weiße LEDs bei 100% für die Farbe weiß
Bei der RGBA-Farbmischung muss für die Amber-LED genau festgelegt werden, in welchem Bereich der Farbkreises die Amber-LED in die Farbmischung „eingreifen“ soll. Standardmäßig reicht folgende Ergänzung aus:
<br />
<source lang="xml">hueLeftBottom="0" hueLeftTop="60" hueRightTop="60" hueRightBottom="120"</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 Movingheads 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/min bei DMX-Wert 199, abnehmend bis 0,1 1/min bei DMX-Wert 219.
* Drehung des Farbrads gegen den Uhrzeigersinn mit 0,1 1/min bei DMX-Wert 220, schneller werdend 8 1/min 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><br />
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/min bis 15 1/min</code>
| <code>0.01 1/min bis 15 1/min</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><br />
<code>medium</code><br />
<code>slow</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
|}


==Matrix==
== Videotutorials ==
{| class="wikitable toptextcells"
Auf unserem {{DMXCWebLinks|YouTube}} findet ihr zu diesem Thema folgende Videos.
|-
{|
! Tag !! Variante !! Code
{{DMXC3 Manual-Tableentry Videolink | rHtUIUjNfLQ | Spot on: Wir bauen uns DDFs}}
|-
|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==
[[en: DDF DMXC3]]
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 Movinghead 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 Movinghead 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.
 
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><br />
<code>gobo</code>
| <code>*.png-Dateien</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}
 
===Unterfunktionen===
Für einzelne Funktionen des Kanals für das Goborad sind folgende Unterfunktionen möglich:
* <code>goboshake</code>: Gobo-Shake mit verschiedenen Geschwindigkeiten auf dem gleichen DMX-Kanal
* <code>wheelrotation</code>: Kontinuierliches Drehen des Goborads
 
====Goboshake====
Das Gobo-Shake muss für jedes Gobo einzeln eingerichtet werden. Das bedeutet, dass zum einen zu definieren ist, bei welchen DMX-Werten das Gobo-Shake 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 Gobo-Shake aktiv ist. Hierbei sind auch die Geschwindigkeiten einzupflegen.
 
{| 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">
  <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="16" maxdmx="31" minval="0" maxval="0" />
    <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="32" maxdmx="47" minval="0" maxval="0" />
    <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 Gobo-Shakes 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 Gobo-Shakes 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 Gobo-Shake-Geschwindigkeit
|style="width: 10em"| DMX-Wert für die maximale Gobo-Shake-Geschwindigkeit
|style="width: 10em"| Minimale Gobo-Shake-Geschwindigkeit
|style="width: 10em"| Maximale Gobo-Shake-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/min bei DMX-Wert 192, abnehmend bis 0,1 1/min bei DMX-Wert 223.
* Drehung des Goborads gegen den Uhrzeigersinn mit 0,1 1/min bei DMX-Wert 224, schneller werdend 8 1/min 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><br />
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/min bis 15 1/min</code>
| <code>0.01 1/min bis 15 1/min</code>
|}
 
===Ergänzende Funktionen===
Für das entsprechende Goborad sind folgende ergänzende Funktionen möglich:
* <code>goborotation</code>: Kontinuierliches Drehen des Gobos in verschiedene Richtungen
* <code>goboindex</code>: Ausrichtung des Gobos in einem bestimmten Winkel, die so genannte Indizierung des Gobos
 
====Goborotation====
Die Goborotation liegt meistens auf einem separaten DMX-Kanal. Der dort eingestellte Wert für die Drehzahl gilt für alle Gobos des zugehörigen Goborads.
 
{| 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">
  <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/min bei DMX-Wert 191, zunehmend bis 5 1/min bei DMX-Wert 128.
* Goborotation gegen den Uhrzeigersinn mit 0,5 1/min bei DMX-Wert 193, zunehmend bis 5 1/min 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 des Gobos
|style="width: 10em"| Maximale Drehzahl des Gobos
|-
!style="vertical-align:top"| Zulässiger Attributwert
| <code>stop</code><br />
<code>cw</code><br />
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/min bis 15 1/min</code>
| <code>0.01 1/min bis 15 1/min</code>
|}
 
====Goboindizierung====
Die Goboindizierung liegt meistens auf einem separaten DMX-Kanal und dient dazu, das Gobo in einem bestimmten Winkel bzw. in einer bestimmten Position auszurichten. Der dort eingestellte Wert für die Position / Ausrichtung gilt für alle Gobos des zugehörigen Goborads.
 
{| 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">
  <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.
|}
{| 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 360°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 360°</code>
| <code>0° bis 360°</code>
|}
 
==Prisma==
Mit Hilfe eines Prismas wird der Lichtstrahl mehrfach geteilt. Diese Funktion ist meistens bei Movingheads 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><br />
<code>prism</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Text</code>
|}
 
===Unterfunktionen===
Für einzelne Funktionen des Kanals für das Prisma sind folgende Unterfunktionen auf dem gleichen DMX-Kanal möglich:
* <code>prismrotation</code>: Kontinuierliches Drehen des Prismas in verschiedene Richtungen
 
====Prismenrotation auf gleichem DMX-Kanal====
{| 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">
  <prismrotation />
  <step type="open" mindmx="0" maxdmx="63" caption="Open" />
  <step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
    <step type="stop" handler="prismrotation" mindmx="64" 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 63.
* 3-Facetten-Prisma bei DMX-Wert zwischen 64 und 127, statisch.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/min bei DMX-Wert 128, abnehmend bis 0,1 1/min bei DMX-Wert 191.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/min bei DMX-Wert 192, schneller werdend bis 3 1/min 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/min bis 5 1/min</code>
| <code>0.05 1/min bis 5 1/min</code>
|}
 
===Ergänzende Funktionen===
Für den gesamten DMX-Kanal für das Prisma sind folgende ergänzende Funktionen auf einem separaten DMX-Kanal möglich:
* <code>prismrotation</code>: Kontinuierliches Drehen des Prismas in verschiedene Richtungen
* <code>prismindex</code>: Ausrichtung des Prismas in einem bestimmten Winkel, die so genannte Indizierung des Prismas
 
====Prismenrotation auf separaten DMX-Kanal====
{| 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">
  <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/min bei DMX-Wert 193, schneller werdend bis 3 1/min bei DMX-Wert 255.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/min bei DMX-Wert 128, abnehmend bis 0,1 1/min bei DMX-Wert 190.
|}
{| 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 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>stop</code><br />
<code>cw</code><br />
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.05 1/min bis 5 1/min</code>
| <code>0.05 1/min bis 5 1/min</code>
|}
 
====Prismenindizierung====
{| 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">
  <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, Prismenrotation auf DMX-Kanal 2:
* Prisma statisch bei DMX-Wert zwischen 191 und 192, statisch.
* Rotation des Prismas im Uhrzeigersinn mit 0,1 1/min bei DMX-Wert 193, schneller werdend bis 3 1/min bei DMX-Wert 255.
* Rotation des Prismas gegen den Uhrzeigersinn mit 3 1/min bei DMX-Wert 128, abnehmend bis 0,1 1/min bei DMX-Wert 190.
|}
{| 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>
|}
 
==Position==
In der Funktion Position werden die DMX-Kanäle für die Pan- und Tilt-Bewegung von Movingheads 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 Movinghead 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><br />
<code>cw</code><br />
<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 Movingheads 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.
 
===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 Movinghead
* 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.
 
{| 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>
|}
 
===raw===
Das Element raw erzeugt im Device Control einen Schieberegler. Typische Anwendungsfälle sind hierfür:
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Drehrichtung und Drehzahl einer Animationsscheibe in einem Movinghead
 
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/min bei DMX-Wert 131, schneller werdend bis 2 1/min bei DMX-Wert 255.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/min bei DMX-Wert 124, abnehmend bis -0,05 1/min 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><br />
<code>stop</code><br />
<code>cw</code><br />
<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 Gobo-Wheel fährt seine Referenzpunkte an.
|-
| reset_gobo2
| Löst am entsprechenden Gerät einen Reset des Gobo2 Motors aus.
| Das Gobo2-Wheel fährt seine Referenzpunkte an.
|-
| reset_color
| Löst am entsprechenden Gerät einen Reset des Color Motors aus.
| Das Color-Wheel fährt seine Referenzpunkte an.
|-
| reset_color2
| Löst am entsprechenden Gerät einen Reset des Color2 Motors aus.
| Das Color2-Wheel 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]]
[[Kategorie: Handbuch DMXControl 3]]

Aktuelle Version vom 10. November 2024, 15:06 Uhr

Blockdevice.png Artikel beschreibt
DMXControl 3.3.0		 DDF DMXC3
Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


DDF ist die Abkürzung für "Device Definition File". DDFs werden von DMXControl verwendet, um Informationen über die verwendeten Geräte zu erhalten:

  • welche DMX-Kanäle werden überhaupt belegt?
  • welche Funktionen habe die verschiedenen DMX-Kanäle?
  • wie sehen die Farben auf einem Farbrad bzw. die Gobo auf einem Goborad aus?
  • gibt es verschiedene Strobe-Funktionen und wenn ja, welche?

Dies und viele weitere Informationen sind in einem vollständigen DDF enthalten. DMXControl 3 benötigt die Informationen, um anhand dessen die Bedienoberfläche in Form der Gerätesteuerung (Device Control) und den Steuerfenster (Control Panel) aufzubauen. Darüber hinaus ermöglicht DMXControl 3 unter Einbeziehung des Hardware Abstraktions-Layers (HAL) auch das Ansteuern unterschiedlicher Geräte. Alle Informationen werden in der Datei in einer klassischen XML-Struktur beschrieben, sodass alle Angaben auch nur mit dem klassischen Editor von Windows oder Notepad++[1] und dem dort verfügbaren Plugin XML-Tools[2] im Klartext lesbar sind.

Dieser Teil des Handbuchs über DMXControl 3 beschäftigt mit der Erstellung von DDFs. Die Unterteilung der Artikel orientiert sich dabei an den vorhandenen Steuerfenster in DMXControl 3 selbst. Der Teil des Handbuchs zu den DDFs in DMXControl 3 gliedert sich in vier Bereiche:

  • Grundlagen und wichtige Hinweise zur DDF-Erstellung
  • Syntax der unterstützten Funktionen
  • Procedures zum Aufrufen bestimmter Gerätefunktionen
  • Beispiele zur manuellen Programmierung von DDFs für DMXControl 3


Wichtiger Hinweis Der aktuelle DDFCreator unterstützt auf Grund seines Alters nicht alle Funktionen, die in den DDFs für DMXControl 3 abgebildet werden können. Unter Umständen löscht der DDFCreator Bestandteile im DDF, die dieser nicht kennt. Daher ist es empfehlenswert, den DDFCreator nicht mehr zu verwenden, sobald im DDF manuell zusätzliche Funktionen hinzugefügt wurden.
Achtung, wichtiger Hinweis! DDFs für DMXControl 2 sind nicht mit den DDFs für DMXControl 3 kompatibel, da sich der interne Aufbau komplett unterscheidet. DMXControl 3 benötigt für den Hardware Abstraktions-Layers (HAL) zusätzliche Informationen. Auch bringen die DDFs keine selbst gebaute Bedienoberfläche mit. Alle Steuerelemente generiert DMXControl 3 einheitlich über die GUI.


Grundlagen

Kapitel Zusammenfassung
Allgemeine Einführung Die allgemeine Einführung gibt einen groben Überblick, was DDFs im Kontext von DMXControl 3 sind, nach welchen Merkmalen die DDFs in DMXControl 3 zum Einsatz kommen und welche Verzeichnisse auf dem PC für die DDFs genutzt werden.
Grundaufbau Dieser Artikel beschreibt die grundlegende Struktur eines DDFs für DMXControl 3 sowie die Angaben wie Informationen zum Gerät, die im Informationsteil zu machen sind.
Funktionselemente In diesem Artikel werden verschiedene Gemeinsamkeiten erläutert, die unabhängig von der verwendeten Funktion zu einer vollständigen Definition von insbesondere komplexeren DMX-Kanälen benötigt werden und daher in den meistern DDFs zu finden sind.
Grundregeln Die Grundregeln fassen zusammen, von welchen Einheiten der HAL beispielsweise bei der Festlegung der maximalen Strobefrequenz ausgeht.


Wichtiger Hinweis DMXControl 3.2 unterstützt noch keine Multibeam-Geräte (Geräte mit seperat gesteuerten Lampen). Dies kann mithilfe mehrerer einzelner DDFs, bzw. einem DDF und Generic RGB, Dimmer, etc. umgangen werden.

Funktionsübersicht

In den DDFs werden folgende Funktionen direkt von der HAL unterstützt. Die Tabelle verweist euch auf die verschiedenen Artikel, in denen euch die jeweiligen Funktionen inklusive aller möglichen Varianten mit entsprechenden Beispielen erklärt werden.

Bereich Funktionen
Intensität Dimmer, Switch, Shutter, Strobe
Position Position, Pan-Tilt-Geschwindigkeit
Farbe RGBx-Farbmischung, CMY-Farbmischung, HSV-Farbmischung, Farbrad, Farbtemperatur
Pixel-Effekte Matrix, Radix
Gobo Goborad
Lichtstrahl Fokus, Frost, Iris, Zoom
Blendenschieber Blendenschieber
Effektrad Prisma, Effektrad
Bühneneffekte Nebel, Ventilator
Allgemeine Funktionen Index, Rotation, Cool, Heat
Freie Funktionen rawstep, raw, rawranges, const

Procedures

Kapitel Zusammenfassung
Funktionen Dieser Artikel listet alle in DMXControl 3 verfügbaren Procedures auf.
Beispiele Der Artikel zeigt ein paar Beispiele für vorgegebene, aber auch für eigene Procedures.

Tutorials

Kapitel Zusammenfassung
LED-Scheinwerfer Im ersten von insgesamt drei Tutorials wird das DDF für einen einfachen LED-Scheinwerfer erstellt. Als Vorlage dient Cameo LED Mini Tri Par Can 3W.
4er-LED-Bar Das zweite Tutorial behandelt die manuelle Erstellung eines DDFs für einer 4er-LED-Bar am Beispiel der Eurolite LED KLS-2500.
Moving Head Das dritte Beispiel zeigt, wie das DDF für einen einfachen Moving Head erstellt wird. Als Vorlage dient hier der Showtec Indigo 150 LED, der teilweise auch unter anderen Marken vertrieben wurde.

Links und Referenzen

Links

  1. ↑ Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen auf der Herstellerseite: https://notepad-plus-plus.org/
  2. ↑ Installationsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Pluginadministrator von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2

Videotutorials

Auf unserem YouTube-Kanal findet ihr zu diesem Thema folgende Videos.

Spot on: Wir bauen uns DDFs
Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=DDF_DMXC3&oldid=18406“