DDF DMXC2, Steuerzentrum DMXC2

Aus DMXCWiki
(Unterschied zwischen Seiten)
Wechseln zu: Navigation, Suche
(Kanalbeschreibung)
 
(Bedienelemente)
 
Zeile 1: Zeile 1:
{{Kapitelüberschrift}}
+
{{Kapitelüberschrift}}  
 
{{NavigationTop-Man2
 
{{NavigationTop-Man2
|zurückLink = Pack And Go_DMXC2
+
|zurückLink = Installation_DMXC2
|zurückText = Pack And Go Funktion
+
|zurückText = Installation
|vorLink = DDF Creator_DMXC2
+
|vorLink = Grafische Bühnenansicht_DMXC2
|vorText = DDF Creator
+
|vorText = Grafische Bühnenansicht
 
}}
 
}}
 +
 
{{Hinweis
 
{{Hinweis
|Text = Baustelle!! Wird bearbeitet von Uwe (Multipar fertiggestellt am [21.07.2012 13:30].<br />
+
|Text = 04.08.2012 Review Frank: OK<br />
Bitte Korrektur lesen.
+
07.09.2012 Review Uwe: I.O.<br />
 +
04.10.2012 Uwe und Jens-Peter: "Links und Referenzen" aus Arikel nehmen, da keine wichtigen Links enthalten
 
}}
 
}}
 +
  
 
==Überblick==
 
==Überblick==
[[Bild:DMXC2_Manual_DDF_Buehnenansicht.png|miniatur|250px|Bild 1: Grafische Bühnenansicht mit DDF-Icon]]
 
  
[[Bild:DMXC2_Manual_DDF_Beispiel.png|miniatur|250px|Bild 2: Geöffnetes DDF-Fenster mit Steuerelementen]]
+
{{Bild_mit_Unterschrift |DMXC2_Manual_Steuerzentrum_Programmicon.png|1|DMXControl<br>Programmicon|right}}
 +
Nachdem Start von DMXControl über das Programmicon (siehe Bild 1), öffnet sich das Steuerzentrum von DMXControl (siehe Bild 2).
 +
Dieses Fenster bietet dem Bediener den Zugriff auf alle Module, Wekkzeuge und Konfigurationen von DMXControl.
 +
Ausser über die Menüpunkte ''Datei'', ''Fenster'', ''Konfiguration'' und ''?'', besteht für die wichtigsten Module
 +
und Werkzeuge die Möglichkeit diese über die Icon's in der Icon-Leiste aufzurufen.
  
DDF ist die Abkürzung für "''Device Definition File''". Die DDF's sind die Gerätebeschreibung (Fixtures) in DMXControl, sie dienen dazu DMXControl die Funktionen des angeschlossenen DMX-Geräts mitzuteilen. Im DDF wird die Anzahl der benuzten Kanäle des DMX-Geräts definiert und ebenso die mögliche Steuerelemente wie:
+
Desweiteren gibt Ihnen die Statuszeile am unteren Fensterrand des Steuerzentrums Auskunft über den Pfad und die Datei des geladenen Projekts, sowie die ungefähre Belastung des internen Nachrichtensystems angezeigt. Ausserdem werden hier noch Datum, aktuelle System-Uhrzeit und die Versionsnummer von DMXControl.
*Positionseingabe-Steuerelement z.B. bei Movingheads und Scannern.
+
*RGB- bzw. CMY-Farbauswahl-Steuerelement zur Farbmischung bei z.B LED-Scheinwerfer oder Farbmischeinheiten bei Movingheads.
+
*Dropdown-Steuerelement
+
*Button-Steuerelement usw.
+
  
Die DDF's werden in der "''Grafischen Bühnenansicht''" mit einem Icon des Geräts angezeigt (siehe Bild 1), hier kann dann auch durch einen Klick auf das Icon, auf das DDF-Fenster mit den Steuerelementen zugegriffen werden (siehe Bild 2). Die Beschreibung der DMX-Geräten erfolgt in einem XML-Format, das durch DMXControl in die interne Gerätebeschreibung übersetzt wird.Die DDF's finden sich im Unterordner "''Devices''" des DMXControl-Hauptverzeichnisses. Die zugehörigen Icon-Bilder, welche in der "''Grafischen Bühnenansicht''" angezeigt werden, liegen in einem weiteren Unterordner namens "''Images''".
+
{{Bild_mit_Unterschrift |DMXC2_Manual_Steuerzentrum_Fenster.png|2|Das Steuerzentrum von DMXControl|center}}
 
+
Vorgefertigte DDFs, die nicht bei der Installation mitgeliefert wurden, können Sie evtl. von der DMXControl-Homepage in der Gerätebibliothek<ref name="GB">Link Gerätebibliothek:http://www.DMXControl.de/Geraetedefinitionen/Geraetebibliothek.html</ref> beziehen.DDF's können auf einfache Weise mit einem XML-Editor (z.B. PSPad<ref>Link XML-Editor PSPad:http://www.PSPad.de</ref>) oder auch mit dem [[DDF_Creator|DDFCreator]] erstellt werden. Sowohl die Erstellung eines DDF's mit einem XML-Editor als auch mit dem DDFCreator haben Vor- und Nachteile. Das Umschreiben eines bestehenden DDF's läst sich mit einem XML-Editor wesentlich schneller bewerkstelligen als mit dem DDFCreator, dagegen ist man mit dem DDFCreator wesentlich schneller bei der Erstellung einer neuen DDF-Oberfläche, mit Slidern, Buttons usw.''Egal ob man nun den DDFCreator bevorzugt oder den XML-Editor, bei beiden benötigt man ein entsprechendes Hintergrundwissen um ein funktionierendes DDF zu erstellen. Dieses Wissen sollen Ihnen die nachfolgenden Kapitel vermittelt werden, unter anderem dient die Sprachreferenz als Nachschlagewerk''
+
  
 +
* das Öffnen, Speichern und Beenden Ihrer Show (Menüpunkt "Datei")
 +
* den Aufruf sämtlicher Werkzeuge von DMXControl (Menüpunkt "Fenster")
 +
* die [[Programmkonfiguration_DMXC2|Konfiguration]] ihres Systems (Menüpunkt "Konfiguration")
 +
* den Aufruf von Supportfunktionen  (Menüpunkt "?")
  
 
==Beschreibung==
 
==Beschreibung==
XML (e''X''tensible ''M''arkup ''L''anguage) ist eine im Internet sehr gebräuchliche Sprachsyntax, die z.B. in anderen Dialekten bei Webseiten oder WAP-Seiten verwendet wird. Aber sie müssen kein Experte sein, um eine neue Gerätebeschreibung zu manuell zu erstellen. Folgende einfache Hinweise genügen:
+
 
+
Über die Iconleiste können die einzelnen DMXControl-Tools aufgerufen werden. Über Tooltipps wird die Bedeutung der Buttons angezeigt. Zusätzliche Funktionen sind
Bitte achten Sie darauf, dass Ihr Editor keine (unsichtbaren) Steuerzeichen abspeichert. Beim Windows-Editor oder PSPad wird es keine Probleme geben. Falls Sie Word o.ä. verwenden wollen, sollten Sie die Datei im Textformat speichern.
+
* '''Blackout''' - Alle Geräte mit einem Dimmerkanal werden global ausgeschaltet.  
* Der DMXControl-Dialekt von XML verlangt zu jedem öffnenden Tag („''<tag>''“) immer ein schliessendes Tag („''</tag>''“). Nur die Tags der letzten Ebene werden gleich implizit abgeschlossen (z.B. ''<item caption= "Weiss" value="0" />'').
+
* '''Freeze''' - Stoppt die aktuelle Ausgabe der DMX-Werte auf das DMX-Universum (Output), hierbei verharren alle Geräte in der Funktion Ihrer letzten DMX-Werte vor dem betätigen des Freez-Buttons. Alle Einstellungen die während der aktivierten Freeze Funktion gemacht werden werden nicht nach aussen weitergeleitet.  
* Die Endzeichen „''/>''“ und „''</tag>''“ sind semantisch äquivalent, also auch „''<item caption="Weiss" value="0" > </item>''“ ist gültig.
+
* '''Audiowiedergabe abbrechen''' - Eine gestartete Audioszene kann mit diesem Button vorzeitig abgebrochen werden.
* Jeder Tag kann Attribute besitzen, die Sie unten in der Tabelle erklärt finden. Jeder Attributwert wird mit einem Gleichheitszeichen eingeleitet und der Wert muss immer in Doppelapostrophe eingeschlossen sein.
+
* Alle Tag- und Attribut-Bezeichner werden bei DMXControl in kleinen Buchstaben notiert.
+
* Die Tags sind hierarchisch zu definieren. Das sollten sie über entsprechende Einrückungen auch kenntlich machen.
+
* Die Reihenfolge der Attribute eines Tags ist in der Regel egal. Wo es ausnahmsweise doch auf die Reihenfolge ankommt, wird unten explizit beschrieben.
+
* Kommentarzeilen werden in der Form notiert „''<! —Das ist ein Kommentar —>''
+
* Sie können sich xml-files (somit auch die DMX devices files) in übersichtlicher Form z.B. mit dem Internet Explorer anschauen.
+
<br>
+
So, das war es schon - schauen wir uns ein einfaches Beispiel an.
+
 
+
 
+
===Beispiel: Gedimmter Scheinwerfer===
+
Jedes Gerät sollte ein treffendes Icon erhalten, um in Bühnendarstellung eine angepasste Darstellung zu erhalten. Dieses Icon wird im Unterverzeichnis Images (''Root:\Programme\DMXControl\Devices\Images'') abgelegt.
+
 
+
{{ BoxHinweis
+
| Text= Die Icons können in DMXControl hinterher noch geändert werden. (Kontextmenü der grafischen Bühnenansicht).
+
}}
+
 
+
Die vorangestellten Zeilennummern des folgenden XML-Beispielfiles sind nicht einzufügen; sie dienen nur der Beschreibung des Beispiels:
+
<source lang=xml>
+
1 <?xml version="1.0" encoding="ISO-8859-1"?>
+
2 <device image="light.gif" initsequence=“set 0 128“ >
+
3  <channels>
+
4    <function channel="0" minvalue="0" maxvalue="255" name="Helligkeit" fade="yes" />
+
5  </channels>
+
6  <form width="177" height="85">
+
7    <deviceimage top="0" left="0" />
+
8    <devicename top="0" left="40" />
+
9    <deviceadress top="16" left="40" />
+
10    <slider channel="0" startvalue="0" endvalue="255" top="40" left="0" height="41" width="176" default="0" />
+
11  </form>
+
12 </device>
+
</source>
+
 
+
<br>
+
 
+
{| cellpadding="5" style="width: 100%;"
+
|- style="vertical-align:top;"
+
|style="width: 50px; margin: 5px;"|'''Zeile&nbsp;&nbsp;&nbsp;1'''
+
|
+
|teilt dem Parser die verwendete XML-Version mit.
+
|- style="vertical-align:top;"
+
|valign="top" style="width: 50px; valign: top; margin: 5px;"|'''Zeile&nbsp;&nbsp;&nbsp;2'''
+
|
+
|definiert die globale Beschreibung des neuen Gerätetyps inklusive Verweis auf das zu verwendende Icon und einer Initialisierung des Gerätes (die optionale initsequence wurde hier demonstriert, ist aber bei einem Scheinwerfer nur bedingt sinnvoll. Der Dimmerkanal wird hier bei der Initialisierung auf DMX-Wert 128 gesetzt (50%)).
+
|- style="vertical-align:top;"
+
|valign="top" style="width: 50px; valign: top; margin: 5px;"|'''Zeile&nbsp;&nbsp;&nbsp;3'''
+
|
+
|zwischen Zeile 3 und 5 werden die DMX-Kanäle des Geräts definiert.
+
|- style="vertical-align:top;"
+
|valign="top" style="width: 50px; valign: top; margin: 5px;"|'''Zeile&nbsp;&nbsp;&nbsp;4'''
+
|
+
|ist die Kanalbeschreibung des ersten Kanals. Wichtig ist das die Kanalnummern immer bei Null anfangen, d.h. der erste Kanal ist channel="0" . Außerdem werden hier noch andere Parameter, sowie der Kanalname gesetzt.
+
|- style="vertical-align:top;"
+
|valign="top" style="width: 50px; valign: top; margin: 5px;"|'''Zeile&nbsp;&nbsp;&nbsp;6'''
+
|
+
|die Zeilen 6-9 beschreiben das Form, also die grafischen Koordinaten im Kontextmenü für das Gerätebild, Namen und Startadresse in der Einheit „Pixel“.
+
|- style="vertical-align:top;"
+
|valign="top" style="width: 50px; valign: top; margin: 5px;"|'''Zeile 10'''
+
|
+
|hier folgen nun die Bedienelemente mit ihren Eigenschaften, in diesem Beispiel ein slider mit seinen grafischen Koordinaten und der Zuordnung zum betreffenden Kanal. Für andere Gerätetypen könnten hier auch Bedienelemente wie Radiobuttons, Dropdowns oder Buttons deklariert werden.
+
|}
+
 
+
[[Bild:DMXC2_Manual_DDF_Dimmer.png|miniatur|200px|Bild 3: Dimmer-DDF]]
+
 
+
Die drei Buttons rechts oben (siehe Bild 3) Pin-Button, Move-Button, Close-Button werden standardmäßig generiert.
+
 
+
 
+
===DDF erstellen===
+
Bevor Sie ein neues DDF erstellen, schauen Sie bitte auf unserer Webseite in der Gerätebibliothek<ref name="GB" /> nach, ob es schon eine passende oder ähnliche Definitionen für Ihr Gerät gibt. Um ein neues DDF zu erstellen, modifizieren Sie am besten ein existierendes DDF eines ähnlichen Gerätes. Dies geht gerade mit dem textbasierten Ändern wesentlich schneller als mit dem DDF Creator. Wenn Sie Ihre Arbeit abgeschlossen haben, legen Sie einfach das xml-file im DMXControl-Verzeichnis in das Unterverzeichnis „devices“ in Ihrer DMX-Installation ab und speichern das entsprechende gif-Bild (im Format 32x32 Pixel, dabei hat sich der Transparenzmode bewährt) im Unterverzeichnis „images“ im „device“-Verzeichnis ab. Das Gerät sollte so beim nächsten Start von DMXControl sichtbar sein.
+
 
+
 
+
===Sprachübersicht===
+
Jede Beschreibung enthält vier Hauptteile (siehe Bild 4):
+
*Beschreibung globaler Eigenschaften "''device''" (im Beispiel Gedimmter Scheinwerfer Zeile 1-2)
+
*Beschreibung der einzelnen DMX-Kanäle "''channels''" (im Beispiel Gedimmter Scheinwerfer Zeile 3-5)
+
*Beschreibung des grafischen Kontextmenüs "''form''" (im Beispiel Gedimmter Scheinwerfer Zeile 6-11)
+
*Prozedurcode (optional, im Beispiel nicht enthalten)
+
 
+
 
+
[[Bild:DMXC2_Manual_DDF-Aufbau1.png|miniatur|zentriert|500px|Bild 4: Grundsätzlicher DDF-Aufbau]]
+
 
+
 
+
Alle Forms-Elemente müssen mit grafischen Koordinaten zur Positionierung auf dem DDF-Form versehen werden. Die Elemente „Label“ und „Line“ sind passiv und dienen nur der Gestaltung der Oberfläche. Die restlichen aktiven Elemente der Form (auch Steuerelemente genannt, z.B. onoff) können zur aktiven Steuerung des DMX-Gerätes eingesetzt werden.
+
 
+
 
+
====Grafische Elemente====
+
Das Bild 5 zeigt eine Übersicht über alle unterstützten grafischen Elemente. In den Erklärungstexten ist eine Zuordnung zu den erforderlichen Syntaxelementen vorgenommen.
+
 
+
 
+
[[Bild:DDF-Aufbau2.png|miniatur|zentriert|500px|Bild 5: Grafische Elemente]]
+
 
+
 
+
Das nachfolgende Bild 6 illustriert die Bedeutung der grafischen Koordinaten der Steuerelemente:
+
 
+
 
+
[[Bild:DDF-Aufbau3.png|miniatur|zentriert|600px|Bild 6: Grafische Koordinaten der Steuerelemente]]
+
 
+
 
+
====Funktionale Elemente====
+
Die aktiven Steuerungselemente interagieren in 3 möglichen Konzepten mit DMXControl bzw. dem Gerät, wobei bei der Definition eines konkreten Steuerelementes genau ein Konzept ausgewählt wird:
+
 
+
  
 +
==Bedienelemente==
 +
===Das Menü Datei===
 +
Im Menü Datei befinden sich vor allem die Windows Standard-MenüPunkte.
 
{| class="wikitable centered"
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
!  
+
! Icon
! Konzept
+
! Menü
! Beschreibung
+
! Menüpunkt
! Beispiel
+
! Shortcut
 +
! Beschreibung
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 10px"| 1
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Neu.png|Neu]]
|style="width: 150px"| Channel/Value concept
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Über das channel-Attribut wird das Steuerelement einem konkreten Kanal zugeordnet. Im Steuer- element werden konkrete Werte oder Wertebereiche definiert, die bei der Betätigung des Steuer- elementes gesetzt werden.
+
|style="width: 175px"| Neues Projekt...
|style="width: 200px"| - option Liste<br>&nbsp;&nbsp;caption="Sternenhimmel"<br>&nbsp;&nbsp;value="165"<br>- Wertebereich des<br>&nbsp;&nbsp;Schiebereglers<br>&nbsp;&nbsp;startvalue="0"<br>&nbsp;&nbsp;endvalue="255"
+
|style="width: 65px; text-align: center"| n.a.
 +
|style="width: 235px"| Erstellen eines neuen Projekts
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 10px"| 2
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Öffnen.png|Öffnen]]
|style="width: 150px"| Sequences
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Eine Anweisungsfolge wird im Steuerelement als String definiert, die beim Betätigen ausgeführt wird.
+
|style="width: 175px"| Öffnen...
|style="width: 200px"| clicksequence=<br>“set 1 75; set 2 100“
+
|style="width: 65px; text-align: center"| n.a.
 +
|style="width: 235px"| Projekt Öffnen
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 10px"| 3
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Speichern.png|Speichern]]
|style="width: 150px"| Action/Procedures
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Eine separat definierte Prozedur enthält komplexere Programm- anweisungen. Die Prozedur wird über das Action-Attribut zuge- ordnet und bei jedem Betätigen des Steuerelementes ausgeführt.
+
|style="width: 175px"| Speichern...
|style="width: 200px"| action="SetGobo"
+
|style="width: 65px; text-align: center"| STRG+S
|}
+
|style="width: 235px"| Überschreibt das aktuell ausgewählte Projekt
 
+
 
+
Insbesondere bedeutet das, das Channel-Attribut und das Action-Attribut alternativ in den Steuerelementen verwenden werden können.
+
 
+
 
+
{{BoxHinweis
+
| Text=Für viele Anwendungen sind die ersten beiden Konzepte ausreichend.
+
}}
+
 
+
 
+
So wie die Komplexität und Mächtigkeit der 3 Konzepte anwächst, steigen auch die Laufzeitanforderungen. Daher sollte immer die einfachste Variante zur Lösung einer Aufgabe gewählt werden. Auch bei der Kanalbeschreibung kann ein Action-Attribut verwendet werden. Das bedeutet, dass die Prozedur bei jeder Änderung des Kanal-Wertes aufgerufen wird. In Bild 7 ist ein Beispiel aufgezeigt, wie verschiedene Steuerelemente mit den Kanälen interagieren können. Die Kanalwerte werden über „channel_n“ adressiert und können über die oben genannten 3 Konzepte gesetzt werden. Der aktuelle Wert, der mit einem Steuerelement verbunden ist, wird über ein dem Steuerelement zugeordneten frei wählbaren Namen (Referenz) adressiert, hier mit „control_n“ bezeichnet.Im nachfolgenden Beispiel sind drei Steuerelementen „actions“ und zusätzlich „Referenznamen“ zugeordnet. Diese actions können einen oder mehrere Channel-Werte '''setzen''' und sollten daher in der Regel mit „'''Set'''Name“ bezeichnet werden. Weiterhin ist eine „action“ den channel_3 zugeordnet.Das ist dafür vorgesehen, die aktuellen Kanal-Werte zu lesen und den Steuerelementen mitzuteilen. Daher wird eine solche Prozedur in der Regel den Namen „'''Get'''Name“ bekommen, da sie aktuelle Kanalwerte '''lesen''' muss.
+
 
+
 
+
[[Bild:DDF-Aufbau4.png|miniatur|zentriert|600px|Bild 7: Interaction der Steuerelemente]]
+
 
+
 
+
{{BoxHinweis
+
| Text=Die Beschriftungen der Buttons haben hier keine Bedeutung.
+
}}
+
 
+
===Syntax===
+
Dieses Kapitel beschreibt die Syntax der Device- und Forms-Konfigurationsfiles von DMXControl.
+
 
+
 
+
====Generische Attribute====
+
{{BoxHinweis
+
| Text=Zur Verkürzung der nach folgenden Tabellen werden sich oft wiederholende Attribute mit gleicher Bedeutung hier einmal global beschrieben.
+
}}
+
 
+
 
+
{| class="wikitable centered"
+
|- style="vertical-align:top;"
+
! Referenz
+
! Attribut
+
! Hierachie und Eigenschaft
+
! Bemerkung
+
! Beispiel
+
|- style="vertical-align:top;"
+
|style="width: 50px"| GP1
+
|style="width: 75px"| <span style="color:#8B0000">value</span>
+
|style="width: 200px"| Zugeordneter DMX-Wert
+
|style="width: 100px"| Byte
+
|style="width: 100px"| 0, 128, 255
+
|- style="vertical-align:top;"
+
|style="width: 50px"| GP2
+
|style="width: 75px"| <span style="color:#8B0000">caption</span>
+
|style="width: 200px"| Beschreibender Aufzählungs-<br>wert. Erklärender Name für<br>eine Einstellung.
+
|style="width: 100px"| string
+
|style="width: 100px"| Dimmer,<br>Strobe,<br>usw.
+
|- style="vertical-align:top;"
+
|style="width: 50px"| GP3
+
|style="width: 75px"| <span style="color:#8B0000">top</span>
+
|style="width: 200px"| Relative y-Koordinate des<br>Elementes von der linken<br>oberen Ecke
+
|style="width: 100px"| integer
+
|style="width: 100px"| top=“150“
+
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 50px"| GP4
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"| <span style="color:#8B0000">left</span>
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Relative x-Koordinate des<br>Elementes von der linken<br>oberen Ecke.
+
|style="width: 175px"| Speichern unter...
|style="width: 100px"| integer
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| left=“100“
+
|style="width: 235px"| Speichert das Projekt im ausgewählten Ordner
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 50px"| GP5
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"| <span style="color:#8B0000">width</span>
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Breite des Elements
+
|style="width: 175px"| Pack & Go...
|style="width: 100px"| integer
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| width=“80“
+
|style="width: 235px"| Komplettes Projekt archivieren, für den Umzug auf einen neuen Rechner
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 50px"| GP6
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"| <span style="color:#8B0000">height</span>
+
|style="width: 75px; text-align: center"| Datei
|style="width: 200px"| Höhe des Elements
+
|style="width: 175px"| Beenden
|style="width: 100px"| integer
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| height=“30“
+
|style="width: 235px"| Beendet DMXControl mit den üblichen Sicherheits und Speicherabfragen
 
|}
 
|}
  
 
+
===Das Menü Fenster===
{{BoxHinweis
+
Das Menü Fenster enthält alle für DMXControl wichtigen Menüpunkte zum aufruf der Module, ebenso werden hier zusätzlich instllierte Plugins angezeigt.
| Text=Alle Koordinatenangaben <span style="color:#8B0000">(top, left, width, height)</span> werden in Pixel angegeben.
+
}}
+
 
+
 
+
====Gerätebeschreibung====
+
 
{| class="wikitable centered"
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
! Tag
+
! Icon
! Attribut
+
! Menü
! Hierachie und Eigenschaft
+
! Menüpunkt
! Bemerkung
+
! Shortcut
! Beispiel
+
! Beschreibung
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><device></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Neu.png|Neu]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 1'''
+
|style="width: 175px"| Geräte
|style="width: 100px"|
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"|
+
|style="width: 235px"| Erstellen eines neuen Projekts
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"|
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Öffnen.png|Öffnen]]
|style="width: 75px"| <span style="color:#8B0000">image</span>
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| Dateiname des Icons.
+
|style="width: 175px"| Grafische Bühnenansicht
|style="width: 100px"| string,<br>Filename.gif
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| Moon.gif
+
|style="width: 235px"| Projekt Öffnen
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"|
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Speichern.png|Speichern]]
|style="width: 75px"| <span style="color:#8B0000">initsequence</span>
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| Setzt Initialwerte für die<br>einzelnen DMX-Kanäle des<br>Gerätes
+
|style="width: 175px"| Gruppenauswahl
|style="width: 100px"| Optionale Benutzung z.B. für Scanner/MH Startposition
+
|style="width: 65px; text-align: center"| STRG+S
|style="width: 100px"| set 0 15;<br>set 7 128;
+
|style="width: 235px"| Überschreibt das aktuell ausgewählte Projekt
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><information></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 2'''<br>Ergänzender Kommentar.
+
|style="width: 175px"| Kanalübersicht
|style="width: 100px"|
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"|
+
|style="width: 235px"| Speichert das Projekt im ausgewählten Ordner
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><name></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 3'''<br>Beliebiger Text
+
|style="width: 175px"| BeatTool
|style="width: 100px"|
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| Custom Scanner
+
|style="width: 235px"|  
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><vendor></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 3'''<br>Beliebiger Text<br/>(Hersteller)
+
|style="width: 175px"| DMXIn-Fernsteuerung
|style="width: 100px"| optional
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| Showtec
+
|style="width: 235px"| Speichert das Projekt im ausgewählten Ordner
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><deviceidentifier></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 3'''<br>Beliebiger Text<br/>(Herstellerbezeichnung)
+
|style="width: 175px"| Joystickfernsteuerung
|style="width: 100px"| optional
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"| TG-3
+
|style="width: 235px"|  
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"
|style="width: 100px"| <span style="color:#8B0000"><author></span>
+
|style="width: 50px"| [[Bild:DMXC2_Manual_Steuerzentrum_Icon-Space.png]]
|style="width: 75px"|
+
|style="width: 75px; text-align: center"| Fenster
|style="width: 200px"| '''Level 3'''<br>Beliebiger Text<br/>(Ersteller)
+
|style="width: 175px"| Kommandobox
|style="width: 100px"| optional
+
|style="width: 65px; text-align: center"| n.a.
|style="width: 100px"|
+
|style="width: 235px"| Projekt Speichern
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><comment></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3'''<br>Beliebiger Text<br/>(Kommentar).
+
|style="width: 100px"| optional
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><help></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 2'''<br>Hilfetext (ASCII).
+
|style="width: 100px"| optional
+
|style="width: 100px"|
+
 
|}
 
|}
  
 +
Drei Funktionen aus der Menüleiste "Fenster" sind hier hervorzuheben: 
 +
* '''Szenenbibliothek''' - Hier kann man direkt Einblick in alle gespeicherten Szenen nehmen.
 +
* '''Bearbeitungsansicht''' - Bei aktivierter Bearbeitungsansicht werden sämtliche Funktionen angezeigt, die man zum Programmieren von Shows benötigt. Wird die Option deaktiviert, werden Funktionen ausgeblendet, die man normalerweise im live-Betrieb nicht benötigt. Hierdurch werden die Fenster kleiner und es wird Platz auf dem Bildschirm eingespart. 
 +
* '''Alle Fenster auf primären Bildschirm holen''' - Beim Arbeiten mit mehreren Monitoren kann es passieren, das man vergisst die Fenster wieder auf den primären Monitor zurückzuholen, wenn man nur noch mit dem primären Monitor arbeiten möchte. In diesem Fall lassen sich alle Fenster auf den primären Monitor holen.
  
====Kanalbeschreibung====
+
==Tipps==
{| class="wikitable centered"
+
|- style="vertical-align:top;"
+
! Tag
+
! Attribut
+
! Hierachie und Eigenschaft
+
! Bemerkung
+
! Beispiel
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><channels></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 2'''<br/>Pro DMX-Kanal<br/>ist ein “<span style="color:#8B0000"><function></span>”-Teil zu<br/>definieren
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><function></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level '''<br/>Subtag von “<span style="color:#8B0000"><channels></span>“
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">channel</span>
+
|style="width: 200px"| Interne DMX-Kanal-Nummer<br/>Kanalnr. müssen immer<br/>von 0 aufsteigend ohne<br/>Unterbrechung für die<br/>einzelnen Kanäle definiert<br/>werden
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">minvalue</span>
+
|style="width: 200px"| Minimaler DMX Wert
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">maxvalue</span>
+
|style="width: 200px"| Maximaler DMX Wert
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">name</span>
+
|style="width: 200px"| Beschreibender Name<br/>für den Kanal
+
|style="width: 100px"| string
+
|style="width: 100px"| Helligkeit
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">fade</span>
+
|style="width: 200px"| Kanal-Überblendung
+
|style="width: 100px"| string
+
|style="width: 100px"| yes,no
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">type</span>
+
|style="width: 200px"| Kanal-Typ<br/>Wichtig für die Interne Daten-<br/>verarbeitung
+
|style="width: 100px"| string
+
|style="width: 100px"| dimmer, r,g,b,<br/>pan, panfine,<br/>tilt, tiltfine,<br/>color, gobo
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">action</span>
+
|style="width: 200px"| Aufruf einer Prozedur bei<br/>Änderung des Kanalwerts
+
|style="width: 100px"| string<br/>optional
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><virtual></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><channels></span>“
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><channel></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 4'''<br/>Subtag von “<span style="color:#8B0000"><virtual></span>“
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">channel</span>
+
|style="width: 200px"| Interne DMX-Kanal-Nummer<br/>Der drei dem virtuellen<br/>Dimmer zugeordneten Kanäle
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|}
+
  
 +
Projekte sollten in der Erstellungsphase sicherheitshalber regelmäßig gespeichert werden, insbesondere auch unter einem anderen Namen, um gegebenenfalls auf eine ältere Version zurückgreifen zu können. 
 +
Die experimentellen Programmteile (z.B. neue Tools in der beta-Test Phase) erscheinen nur im Menü, wenn unter Konfiguration die entsprechende Option gewählt wurde.
  
{{ BoxHinweis
 
| Text= Der Kanaltyp (<span style="color:#8B0000">type</span>) sollte für jeden Kanal auch vergeben
 
werden, sofern dieser Kanal zum Typ passt. Es macht z.B. keinen Sinn jeden Kanal als Dimmer zu bezeichnen.
 
}}
 
  
 +
== Links und Referenzen==
  
{|
+
*früherer Wiki-Artikel: http://www.dmxcontrol.de/wiki/Steuerzentrum
|- style="vertical-align:top;"
+
|style="width: 100px"| dimmer
+
|style="width: *"| reserviert für Kanäle die die Helligkeit regeln
+
|- style="vertical-align:top;"
+
|style="width: 100px"| r,g,b
+
|style="width: *"| reserviert für Kanäle von RGB LED-Geräten, "r" für den roten Kanal, "g" für den grünen Kanal, "b" für den blauen Kanal.
+
|- style="vertical-align:top;"
+
|style="width: 100px"| pan, panfine
+
|style="width: *"| reserviert für die Pan Kanäle von Scannern, Movingheads oder ähnlichen Geräten. Wobei pan dem  Kanal  für  die  Grobsteuerung  zugeordnet  wird  und  panfine  dem Kanal für die Feinsteuerung, bei 16 Bit Geräten
+
|- style="vertical-align:top;"
+
|style="width: 100px"| tilt, tiltfine
+
|style="width: *"| wie bei pan und panfine aber für die Tiltachse
+
|- style="vertical-align:top;"
+
|style="width: 100px"| color, gobo
+
|style="width: *"| Können den entsprechenden Farb- und Goborad Kanälen zugeordnet werden
+
|- style="vertical-align:top;"
+
|style="width: 100px"| sonstige
+
|style="width: *"| alle anderen Kanäle benötigen keine Typbeschreibung
+
|}
+
  
  
{{ BoxHinweis
 
| Text= Die für RGB-Geräte reservierten <span style="color:#8B0000">type</span>'s sind seit der Version 2.11 wichtige für die HAL (Hardware Abstractions Layer), wobei die eingestellten Farben des Scheinwerfers, dann auch in der Grafischen Bühneansicht dargestellt werden können. Ab Version 2.12 werden sie auch für den RGB-Lauflicht-Generator benötigt.
 
}}
 
  
==== Menübeschreibung====
+
{{NavigationTop-Man2
{| class="wikitable centered"
+
|zurückLink = Installation_DMXC2
|- style="vertical-align:top;"
+
|zurückText = Installation
! Tag
+
|vorLink = Grafische Bühnenansicht_DMXC2
! Attribut
+
|vorText = Grafische Bühnenansicht
! Hierachie und Eigenschaft
+
! Bemerkung
+
! Beispiel
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><form></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 2'''<br />Subtag von “<span style="color:#8B0000"><device></span>“
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">width<br />height</span>
+
|style="width: 200px"| Siehe Generische Attribute<br />GP5; GP6
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><deviceimage></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Absolute Position des<br />angezeigten Bildes
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
+
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><devicename></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Absolute Position des<br />angezeigten Namens
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
+
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000"><deviceaddress></span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Absolute Position des<br />angezeigten Basisadresse
+
|style="width: 100px"|
+
|style="width: 100px"|
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
+
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|}
+
 
+
====Steuerungselemente====
+
=====Positionsfeld=====
+
{| class="wikitable centered"
+
|- style="vertical-align:top;"
+
! Tag
+
! Attribut
+
! Hierachie und Eigenschaft
+
! Bemerkung
+
! Beispiel
+
|- style="vertical-align:top;"
+
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Positionsfeld_kartesisch.png]]&nbsp;&nbsp;[[Bild:DMXC2_Manual_DDF_Positionsfeld_polar.png]]
+
|- style="vertical-align:top;"
+
|style="width: 100px"| <span style="color:#8B0000">'''<position>'''</span>
+
|style="width: 75px"|
+
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt ein Positionierungs-<br />feld zur Positionierung von<br />Scannern oder Movingheads.
+
|colspan="2" style="width: 100px"| <small>Durch einen Klick auf den Button<br />unten rechts im DDF kann zwischen<br />kartesischer und polarer<br />Positionierung umgeschaltet werden.</small>
+
|- style="vertical-align:top;"
+
|style="width: 100px"|
+
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
+
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
+
|style="width: 100px"| integer
+
|style="width: 100px"|
+
|}
+
 
+
{{BoxHinweis
+
| Text=Der Positions-Pointer kann per Initsequenz positioniert werden
+
 
}}
 
}}
  
=====Slider=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Datei:DMXC2_Manual_DDF_Slider.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<slider>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt einen Schieberegler
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel</span>
 
|style="width: 200px"| Zugeordneter Kanal<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">startvalue</span>
 
|style="width: 200px"| Wertebereich des<br />Schiebers (unterer Wert)
 
|style="width: 100px"| integer
 
|style="width: 100px"| startvalue="0"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">endvalue</span>
 
|style="width: 200px"| Wertebereich des<br />Schiebers (oberer Wert)
 
|style="width: 100px"| integer
 
|style="width: 100px"| endvalue="255"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">tickfreq</span>
 
|style="width: 200px"| Skalierung, Abstand der<br />Skalenunterteilung
 
|style="width: 100px"| integer
 
|style="width: 100px"| tickfreq="32"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">smallchange</span>
 
|style="width: 200px"| Änderungsrate z.B. beim<br />Pfeiltastenscrollen
 
|style="width: 100px"| integer<br />(VB-Eigenschaft)
 
|style="width: 100px"| smallchange="20"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">largechange</span>
 
|style="width: 200px"| Änderungsrate z.B. beim<br />Mausklicken (nicht ziehen)
 
|style="width: 100px"| integer<br />(VB-Eigenschaft)
 
|style="width: 100px"| largechange="50"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Referenzname für procedure<br />code (Variablenname)
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| StrobeSpeed
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur bei<br />Änderung am Slider<br />alternativ zu <span style="color:#8B0000">channel</span>
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| SetSpeed
 
|}
 
 
=====Dropdown=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Dropdown.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<dropdown>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt ein Dropdown-Menü.
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP5
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel</span>
 
|style="width: 200px"| Zugeordneter Kanal<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Referenzname für procedure<br />code (Variablenname)
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| Gobo
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur bei<br />Aufruf eines Dropdown-<br />eintrags, alternativ zu <span style="color:#8B0000">channel</span>
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| SetGobo
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"><item></span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 4'''<br/>Subtag von “<span style="color:#8B0000"><dropdown></span>“
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">caption</span>
 
|style="width: 200px"| Erklärender Name
 
|style="width: 100px"| string
 
|style="width: 100px"| Clear
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">value</span>
 
|style="width: 200px"| DMX-Wert zu <span style="color:#8B0000">caption</span>
 
|style="width: 100px"| integer
 
|style="width: 100px"| value="0"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">minvalue<br />maxvalue</span>
 
|style="width: 200px"| Wertebereich zu <span style="color:#8B0000">caption</span> zur<br />Anzeige des Dropdown-Eintrags.
 
|style="width: 100px"| integer
 
|style="width: 100px"| minvalue="10"<br />maxvalue="26"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">color</span>
 
|style="width: 200px"| Zeigt ein Quadrat mit der zuge-<br />ordneten Farbe vor <span style="color:#8B0000">caption</span> an
 
|style="width: 100px"| hex
 
|style="width: 100px"| color="#ff0000"<br />Farbe Rot
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"><colorlist></span>
 
|style="width: 75px"|
 
|style="width: 200px"| Fügen alle Einträge der<br />dem Gerät zugewiesenen<br />Colorliste ein.
 
|style="width: 100px"| optional Ersatz/<br />Ergänzung für<br />Item
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"><gobolist></span>
 
|style="width: 75px"|
 
|style="width: 200px"| Fügen alle Einträge der<br />dem Gerät zugewiesenen<br />Goboliste ein.
 
|style="width: 100px"| optional Ersatz/<br />Ergänzung für<br />Item
 
|style="width: 100px"|
 
|}
 
 
=====Options=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Datei:DMXC2_Manual_DDF_Options.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<options>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt einen Schieberegler
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 & GP4
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel</span>
 
|style="width: 200px"| Zugeordneter Kanal<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur bei<br />Auswahl im Dropdowneintrag,<br />alternativ zu <span style="color:#8B0000">channel</span>
 
|style="width: 100px"| optional
 
|style="width: 100px"| SetGoboSpeed
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"><option></span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 4'''<br/>Subtag von “<span style="color:#8B0000"><option></span>“
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">caption</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP2
 
|style="width: 100px"| string
 
|style="width: 100px"| off
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">value</span>
 
|style="width: 200px"| DMX-Wert zu <span style="color:#8B0000">caption</span>
 
|style="width: 100px"| integer
 
|style="width: 100px"| 0
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 & GP4, relative Position<br />zur Position von “<span style="color:#8B0000"><options></span>“
 
|style="width: 100px"| integer
 
|style="width: 100px"| left="0"<br />top="0"
 
|}
 
 
=====On/Off-Button=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Onoff.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<onoff>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt Button’s als Schalter
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel</span>
 
|style="width: 200px"| Zugeordneter Kanal<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Referenzname für procedure<br />code (Variablenname)
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| Gobo
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur beim<br />betätigen des Buttons<br />alternativ zu <span style="color:#8B0000">channel</span>
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| SetOnOff
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">caption</span>
 
|style="width: 200px"| Erklärender Name
 
|style="width: 100px"| string
 
|style="width: 100px"| An/Aus
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">color</span>
 
|style="width: 200px"| Hex RGB-Farbwert des Button
 
|style="width: 100px"| string
 
|style="width: 100px"| color="#00ff00"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">onvalue</span>
 
|style="width: 200px"| DMX-Wert für ON
 
|style="width: 100px"| integer
 
|style="width: 100px"| onvalue="150"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">offvalue</span>
 
|style="width: 200px"| DMX-Wert für OFF
 
|style="width: 100px"| integer
 
|style="width: 100px"| offvalue="0"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000"><small>onsequence</small></span>
 
|style="width: 200px"| Sequence, die bei ON<br />ausgeführt wird
 
|style="width: 100px"| string
 
|style="width: 100px"| "set 0 230;<br />set 1 25"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000"><small>offsequence</small></span>
 
|style="width: 200px"| Sequence, die bei OFF<br />ausgeführt wird
 
|style="width: 100px"| string
 
|style="width: 100px"| "set 0 0;<br />set 1 0"
 
|}
 
 
{{BoxWichtig
 
| Text=Das Channel-Attribut muss unbedingt vor den Wert-Attributen kommen, ansonsten wird der Button nicht automatisch aktualisiert.<br />
 
Ab Version 2.12 sollte dieses Problem behoben sein.}}
 
 
=====Command-Button=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Datei:DMXC2_Manual_DDF_Command.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<command>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt Button’s als Taster
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 & GP4
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Referenzname für procedure<br />code (Variablenname)
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| Gobo
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur beim<br />betätigen des Buttons
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| SetOnOff
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">caption</span>
 
|style="width: 200px"| Erklärender Name
 
|style="width: 100px"| string
 
|style="width: 100px"| An/Aus
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">color</span>
 
|style="width: 200px"| Hex RGB-Farbwert des Button
 
|style="width: 100px"| string
 
|style="width: 100px"| color="#00ff00"
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000"><small>clicksequence</small></span>
 
|style="width: 200px"| Beim Buttonclick zu<br />startende Aktivität ist im<br />Attribut spezifiziert
 
|style="width: 100px"| string
 
|style="width: 100px"| <small>"save 0;<br />set 0 230;<br />hold 5500;<br />restore 0"</small>
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000"><small>downsequence</small></span>
 
|style="width: 200px"| Beim Niederdrücken zu<br />startende Aktivität ist im<br />Attribut spezifiziert
 
|style="width: 100px"| string
 
|style="width: 100px"| <small>"save 0;<br />set 0 230;<br />hold 5500;<br />restore 0"</small>
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000"><small>upsequence</small></span>
 
|style="width: 200px"| Beim Loslassen zu<br />startende Aktivität ist im<br />Attribut spezifiziert
 
|style="width: 100px"| string
 
|style="width: 100px"| <small>"save 0;<br />set 0 230;<br />hold 5500;<br />restore 0"</small>
 
|}
 
 
=====Colorpicker=====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Colorpicker.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<colorpicker>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Erzeugt ein Dropdown-Menü.
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left<br />width<br />height</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP6
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel1</span>
 
|style="width: 200px"| Zuordnung zum 1. Kanal<br />Rot oder Cyan,<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel2</span>
 
|style="width: 200px"| Zuordnung zum 2. Kanal<br />Grün oder Magenta,<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">channel3</span>
 
|style="width: 200px"| Zuordnung zum 3. Kanal<br />Blau oder Yellow,<br />alternativ zu <span style="color:#8B0000">action</span>
 
|style="width: 100px"| integer<br />optional
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Referenzname für procedure<br />code (Variablenname)
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| ColRGB
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">action</span>
 
|style="width: 200px"| Aufruf einer Prozedur bei<br />Änderung einer Farbe,<br />alternativ zu <span style="color:#8B0000">channel1-3</span>
 
|style="width: 100px"| string<br />optional
 
|style="width: 100px"| SetColRGB
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">mode</span>
 
|style="width: 200px"| Auswahl der zwei Modi RGB<br />oder CMY
 
|style="width: 100px"| string
 
|style="width: 100px"| mode=“cmy“
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">layout</span>
 
|style="width: 200px"| Auswahl von zwei<br />verschiedenen Layouts des<br />Colorpickers
 
|style="width: 100px"| integer
 
|style="width: 100px"| layout="1"
 
|}
 
 
'''Beispiel:'''
 
<source lang=xml>
 
<colorpicker mode="rgb" channel1="0" channel2="1" channel3="2" layout="2" top="40"
 
left="0" height="75" width="177"/>
 
</source>
 
 
{{ BoxHinweis
 
| Text= Bitte halten Sie die Maustaste gedrückt, wenn Sie über das Dropdown-Menü die Einstellung im Farbbalken ändern wollen.  Eine Direkteingabe des numerischen Wertes ist ebenfalls möglich.
 
In Proceduren werden die Farbwerte über name:Farbkanal referenziert ({ColRGB:1}; {ColRGB:2}; {ColRGB:3})
 
}}
 
 
====Passive Gestaltungselemente====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Line.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<line>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Gestaltungselement;<br />Erzeugt ein Linie.
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">x1; y1</span>
 
|style="width: 200px"| Startkoordinate Linie
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">x2; y2</span>
 
|style="width: 200px"| Endkoordinate Linie
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|colspan="5" style="text-align:center"| [[Bild:DMXC2_Manual_DDF_Label.png]]
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000">'''<nowiki><label></nowiki>'''</span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br/>Subtag von “<span style="color:#8B0000"><form></span>“;<br />Gestaltungselement;<br />zusätzliche Beschreibung<br />eines Bedienelementes.
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">top<br />left</span>
 
|style="width: 200px"| Siehe Generische Attribute<br />GP3 bis GP4
 
|style="width: 100px"| integer
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">caption</span>
 
|style="width: 200px"| Anzuzeigender Text
 
|style="width: 100px"| string
 
|style="width: 100px"|
 
|}
 
 
'''Beispiel:'''
 
[[Bild:DMXC2_Manual_DDF_Giotto-Spot.png|miniatur|zentriert|600px|Bild 8: DDF Giotto Spot 400]]
 
 
{{ BoxReferenz
 
| Text= Dieses DDF-File finden Sie in der [http://www.dmxcontrol.de/Geraetedefinitionen/Geraetebibliothek.html#SGM Gerätebibliothek] auf der DMXControl Website.
 
}}
 
 
====Hilfe====
 
Das Bild 9 zeigt ein Beispiel für ein Hilfemenü, Hilfemenüs sind optional. Es wird empfohlen, hier die DMX Belegung des Gerätes anzuzeigen. Die Hilfebeschreibung erfolgt im ASCII-Format. Bitte erhöhen Sie die Übersichtlichkeit durch Formatierung mit Tabulator-Zeichen oder Unterstreichungen. Die Hilfe kann durch Klick auf den Fragezeichen-Button (neben dem Pin-Button) ein- und  ausgeschaltet werden.
 
 
[[Bild:DMXC2_Manual_DDF_Help.png|miniatur|zentriert|600px|Bild 9: Hilfemenü eines DDF's]]
 
 
====Sequences====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Operation
 
! Bedeutung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|style="width: 150px"| <span style="color:#8B0000">save >channel<</span>
 
|style="width: 250px"| Zwischenspeichern des aktuellenKanal-<br />werts des DMX-Kanals <span style="color:#8B0000">>channel<</span>
 
|style="width: 200px"| <small>"<span style="color:#0000FF">save 0;</span> set 0 230; hold 5500;restore 0"</small>
 
|- style="vertical-align:top;"
 
|style="width: 150px"| <span style="color:#8B0000">set >channel< >value<</span>
 
|style="width: 250px"| Setzt den Kanal <span style="color:#8B0000">>channel<</span> auf Wert<br /><span style="color:#8B0000">>value<</span>
 
|style="width: 200px"| <small>"save 0; <span style="color:#0000FF">set 0 230;</span> hold 5500;restore 0"</small>
 
|- style="vertical-align:top;"
 
|style="width: 150px"| <span style="color:#8B0000">hold >time<</span>
 
|style="width: 250px"| Timer (wartet <span style="color:#8B0000">>time<</span> in msec.)
 
|style="width: 200px"| <small>"save 0; set 0 230; <span style="color:#0000FF">hold 5500;</span>restore 0"</small>
 
|- style="vertical-align:top;"
 
|style="width: 150px"| <span style="color:#8B0000">restore >channel<</span>
 
|style="width: 250px"| Setzt den zwischengespeicherten Wert<br />des DMX-Kanals <span style="color:#8B0000">>channel<</span> wieder zurück
 
|style="width: 200px"| <small>"save 0; set 0 230; hold 5500;<span style="color:#0000FF">restore 0</span>"</small>
 
|}
 
 
===Proceduren (erweiterte Programmiermöglichkeiten)===
 
Die Device- und Form-Konfiguration von DMXControl erlaubt auch die Programmierung von algorithmischen Veränderungen der DMX-Signale, die bei der Bedienung von Steuerelementen wie onoff-Button, Klappmenü (dropdown) oder Schieberegler (slider) automatisch  ausgeführt werden (siehe actions in Kapitel Funktionale Elemente).
 
 
Sie können also die Werte, die den Steuerelementen zugeordnet sind, über logische Bedingungen und Formeln setzen. Die Prozeduren dienen dazu, z.B. Mehrfachbelegungen von einem Kanal behandeln zu können (z.B. Gobodrehung liegt auf gleichem Kanal wie die Goboauswahl), so dass der  Wert je nach Drehgeschwindigkeit anders berechnet werden kann.
 
 
Diese Prozeduren erlauben Ihnen auch die Programmierung von Abhängigkeiten der Kanäle oder Bedienelemente eines Gerätes, z.B. verbinden Sie bestimmte Farben mit Gobos in fester oder algorithmischer Zuordnung oder Sie ordnen bestimmte Geschwindigkeiten irgendwelche Farben zu.
 
 
Auch lassen sich so bei Geräte mit zwei Farbrädern, die Farben dann über ein Dropdown auswählen oder bei RGB bzw. CMY Geräten lassen sich vordefinierte Farben einem Dropdown zuordnen.
 
 
 
====Generelle Prinzipien====
 
Die Prozeduren werden als Action-Attribut den <span style="color:#8B0000"><function></span>-Tags (Kanälen) oder den Steuerungselementen z.B. <span style="color:#8B0000"><onoff></span>, <span style="color:#8B0000"><slider></span> oder  <span style="color:#8B0000"><dropdown></span> zugeordet. Bei Bedienung entsprechender Steuerungselemente wird der Code der Prozedur automatisch interpretiert und ausgeführt. 
 
Ist das Action-Attribut dagegen einem Kanal in den <span style="color:#8B0000"><function></span>-Tags zugeordnet, so wird sie bei jeder Änderung des zugehörenden Kanalwertes ausgeführt. 
 
Die Prozeduren verwenden „Referenzen“ auf die Werte der Steuerelemente, die innerhalb der Form-Definition der Steuerungselemente durch das <span style="color:#8B0000">Name</span>-Attribut deklariert sind, z.B.
 
 
 
<source lang=xml>
 
<dropdown top="16" left="207" width="113" name="color_color" action="SetColor">
 
</source>
 
 
 
Dies  bedeutet:  Die  Prozedur  SetColor  wird  bei  Bedienung  des  Dropdown-Menüs  ausgeführt und  der  Wert  des  Dropdown-Menüs  wird  als  Variable  “<span style="color:#8B0000">color_color</span>”  an  die  aufgerufene  Prozedur “<span style="color:#8B0000">SetColor</span>“ übergeben.
 
 
Weiterhin existieren implizite Referenzen als standardmäßige Zuordnung zu den Kanälen. So ist z.B. “<span style="color:#8B0000">channel_2</span>“  implizit  mit  dem  Kanal  (<span style="color:#8B0000">function</span>)  mit  channel=2  verbunden,  dem  auch  die  Action “<span style="color:#8B0000">GetColor</span>“ zugeordnet ist.
 
 
 
<source lang=xml>
 
<function channel="2" minvalue="0" maxvalue="255" name="Farbe" fade="no"
 
action="GetColor" colorchannel="yes"/>
 
</source>
 
 
 
Variablen im eigentlichen Sinne als frei belegbare Speicherwerte sind bisher nicht definiert.
 
 
====Elementare Sprachelemente und Konventionen====
 
Während die Referenzen mit ihrem Namen bezeichnet werden ( '''"color_color"''' ), wird der aktuelle Wert vom zugeordneten Steuerelement durch geschweifte Klammern adressiert ('''"{color_color}"''').
 
 
Um die Interpretation des Prozedurcodes durch einen Parser zu vereinfachen, sind in der jetzigen Programmversion einige Konventionen vereinbart, die Sie leider einhalten müssen, obwohl sie nicht sehr  nutzerfreundlich  erscheinen.  Zum  Vergleich  und  zur  leichteren  Erlernbarkeit  liefern  die nachfolgenden Tabellen auf der rechten Seiten immer eine generische Sprachvariante.
 
 
Folgende Zeichen dienen als Separatoren:
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Operation
 
! Bedeutung
 
|- style="vertical-align:top;"
 
|style="width: 75px"| !
 
|style="width: 300px"| beginnt einen [[Befehl]]
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;&#124;
 
|style="width: 300px"| separiert die einzelnen Bestandteile
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;$
 
|style="width: 300px"| beendet einen [[Befehl]]
 
|}
 
 
Es werden folgende arithmetische Operationen unterstützt:
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Operation
 
! Bedeutung
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;+
 
|style="width: 300px"| Addition
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;-
 
|style="width: 300px"| Subtraktion
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;*
 
|style="width: 300px"| Multiplikation
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;/
 
|style="width: 300px"| Division
 
|- style="vertical-align:top;"
 
|style="width: 75px"| &nbsp;mod
 
|style="width: 300px"| Modulo-Operation<br />(gibt den Rest der Mod-Division als Ergebnis aus)
 
|}
 
 
Jeder Ausdruck muss von einer Klammer umgeben sein, um berechnet zu werden. 
 
Folgende Beispiele illustrieren die Verwendung arithmetischer Operationen:
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! DMXControl code
 
! Generische Sprachvariante
 
|- style="vertical-align:top;"
 
|style="width: 280px"| !set_channel|2|(227+{color_speed})$
 
|style="width: 280px"| channel_2 := 227 + color_speed
 
|- style="vertical-align:top;"
 
|style="width: 280px"| !set_channel|3|((({gobos_gobo}-1)*51)+25)$
 
|style="width: 280px"| channel_3 := (gobos_gobo-1)*51+25
 
|- style="vertical-align:top;"
 
|style="width: 280px"| !set_control|gobos_speed|((({channel_3}-1) mod 51)-26)$
 
|style="width: 280px"| gobos_speed := ((channel_3 -1) mod 51)-26
 
|}
 
 
Die verwendeten Standardoperatoren haben folgende Semantik:
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Operation
 
! Bedeutung
 
|- style="vertical-align:top;"
 
|style="width: 160px"| set_control | >cntr< | >val<
 
|style="width: 400px"| setzt das Steuerelement mit dem angegebenen Namen >cntr< auf<br />den Wert des Ausdruckes >val<
 
|- style="vertical-align:top;"
 
|style="width: 160px"| set_channel | >ch< | >val<
 
|style="width: 400px"| Übergibt an den angegebenen Kanal >ch< den Wert >val<
 
|}
 
 
Folgende Vergleichsoperatoren können verwendet werden:
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Operation
 
! Alternative Schreibweise
 
! Bedeutung
 
|- style="vertical-align:top;"
 
|style="width: 185px"| >
 
|style="width: 185px"| &gt; |gt|
 
|style="width: 185px"| größer
 
|- style="vertical-align:top;"
 
|style="width: 185px"| <
 
|style="width: 185px"| &lt; |lt|
 
|style="width: 185px"| kleiner
 
|- style="vertical-align:top;"
 
|style="width: 185px"| =
 
|style="width: 185px"| &eq; |eq|
 
|style="width: 185px"| gleich
 
|}
 
 
Mit Hilfe der Vergleichsoperationen können Bedingungen formuliert werden, da DMXControl die if-Anweisung unterstützt.
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! DMXControl code
 
! Generische Sprachvariante
 
|- style="vertical-align:top;"
 
|style="width: 280px"| !if|{channel_3} &lt; 1|
 
|style="width: 280px"| if channel_3 < 1 then
 
|}
 
 
{{ BoxHinweis
 
| Text= Die Prozedur “INITCONTROLS” wird beim Öffnen der Form ausgeführt, um die Controls auf die Werte zu setzten, die durch die aktuellen DMX-Werte vorgegeben werden. Darin sollten also nur "Get"-Funktionen aufgerufen werden! Initcontrols muss nicht  definiert sein, ist aber empfohlen, damit die Controls immer den aktuellen Zustand des Gerätes abbilden.
 
}}
 
 
 
====XML Syntax des Procedure-Codes====
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! Tag
 
! Attribut
 
! Hierachie und Eigenschaft
 
! Bemerkung
 
! Beispiel
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"> '''&#60;code&#62;''' </span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 2'''<br />Subtag von “<span style="color:#8B0000"><device></span>“<br />enthält alle Proceduren
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"| <span style="color:#8B0000"><procedure></span>
 
|style="width: 75px"|
 
|style="width: 200px"| '''Level 3'''<br />Subtag von “<span style="color:#8B0000"><code></span>“<br />enthält die einzelnen Proceduren
 
|style="width: 100px"|
 
|style="width: 100px"|
 
|- style="vertical-align:top;"
 
|style="width: 100px"|
 
|style="width: 75px"| <span style="color:#8B0000">name</span>
 
|style="width: 200px"| Name der Prozedur
 
|style="width: 100px"| string
 
|style="width: 100px"| SetGobo
 
|}
 
 
 
====Eine Beispiel-Prozedur====
 
Dieses Beispiel zeigt eine Prozedur, die die Werte der Steuerungselemente „color_color“ und „color_speed“ eines Movingheads in Abhängigkeit vom aktuellen DMX-Wert des Kanals 2 (Farbwechsler) setzt. Der Mac 250+ hat 4 Möglichkeiten für das Farbrad:
 
 
 
* Feste Farbe (erstes If im Beispiel unten), 
 
* Drehung mit Uhrzeigersinn (2. If im Beispiel unten),
 
* Drehung gegen Uhrzeigersinn (3. If im Beispiel unten) sowie 
 
* zufällige Farben mit unterschiedlicher Geschwindigkeit (4. If im Beispiel unten). 
 
 
 
Hier die Deklarationen im Konfigurationsfile, die relevanten Variablen sind fett hervorgehoben:
 
 
 
<source lang=xml>
 
<function channel="2" minvalue="0" maxvalue="255" name="Farbe" fade="no"
 
action="GetColor"/>
 
</source>
 
 
 
“color_color” ist die Referenz auf den Wert der Klappbox zur Farbauswahl.
 
 
 
<source lang=xml>
 
<dropdown top="16" left="207" width="113" name="color_color" action="SetColor">
 
</source>
 
 
 
“color_speed” ist die Referenz auf den Wert des Schiebereglers zur Geschwindigkeit:
 
 
 
<source lang=xml>
 
<slider top="16" left="320" height="25" width="65" startvalue="0" endvalue="18"
 
tickfreq="9" smallchange="1" largechange="5" name="color_speed" action="SetColor"/>
 
</source>
 
 
 
Die Prozedur unterteilt die DMX_Werte des Kanal 2 in 4 Intervalle und führt unterschiedliche Zuweisungen aus. Der aktuelle Wert wird also geprüft und die Controls werden entsprechend eingestellt.
 
 
 
{| class="wikitable centered"
 
|- style="vertical-align:top;"
 
! DMXControl code
 
! Generische Sprachvariante
 
|- style="vertical-align:top;"
 
|style="width: 280px"| <source lang=XML><procedure name='GetColor'></source>
 
|style="width: 280px"| <source lang=C>Procedure GetColor( )</source>
 
|- style="vertical-align:top;"
 
|style="width: 280px"| <br />
 
<source lang=xml>
 
!if|{channel_2} &lt; 208|
 
  !set_control|color_color|
 
  {channel_2}$
 
  !set_control|color_speed|0$
 
|
 
!if|({channel_2} &gt; 207) and 
 
({channel_2} &lt; 227)|
 
  !set_control|color_color|-1$
 
  !set_control|color_speed|
 
  (226-{channel_2})$
 
$
 
!if|({channel_2} &gt; 226) and 
 
({channel_2} &lt; 246)|
 
  !set_control|color_color|-2$
 
  !set_control|color_speed|
 
  ({channel_2}-227)$
 
$
 
!if|({channel_2} &gt; 245) and 
 
({channel_2} &lt; 256)|
 
  !set_control|color_color|-3$
 
  !set_control|color_speed|
 
  ((255-{channel_2}) * 2)$
 
$
 
$</source>
 
|style="width: 280px"| <source lang=C>
 
begin
 
if channel_2 < 208 then
 
  color_color := channel_2;
 
 
  color_speed := 0;
 
(else) 
 
if (channel_2 > 207)  and 
 
(channel_2 < 227) then
 
  color_color := -1;
 
  color_speed := 226-channel_2;
 
 
(else) 
 
if (channel_2 > 226) and 
 
(channel_2 < 246) then
 
  color_color := -2;
 
  color_speed :=channel_2-227
 
 
(else)
 
if (channel_2 > 245) and 
 
  (channel_2 < 256) then
 
  color_color := -3;
 
  color_speed := (255-channel_2) * 2;
 
 
;</source>
 
|- style="vertical-align:top;"
 
|style="width: 280px"| <source lang=XML></procedure></source>
 
|style="width: 280px"| <source lang=C>end</source>
 
|}
 
 
==Tipps==
 
'''Neu in DMXControl 2.12'''<br />
 
 
Sind sie Attribute 'minvalue' und 'maxvalue' beim Steuerelement Dropdown.
 
Durch setzen dieser Attribute wird auch der richtige Dopdowneintrag angezeigt wenn der aktuelle
 
DMX-Wert von value abweicht, sich aber noch im Bereich min/maxvalue befindet.
 
 
== Links und Referenzen==
 
<references/>
 
{{NavigationTop-Man2
 
|zurückLink = Pack And Go_DMXC2
 
|zurückText = Pack And Go Funktion
 
|vorLink = DDF Creator_DMXC2
 
|vorText = DDF Creator
 
}}
 
  
[[Kategorie:DMXControl 2]]
+
[[Kategorie: DMXControl 2]]

Version vom 5. Oktober 2012, 08:04 Uhr

Books.png Steuerzentrum DMXC2
Arrow back.png Installation
Grafische Bühnenansicht Arrow forw.png
Inhaltsverzeichnis

Hinweis:
{{{1}}}


Inhaltsverzeichnis

Überblick

Abbildung 1:DMXControlProgrammicon
Abbildung 1: DMXControl
Programmicon

Nachdem Start von DMXControl über das Programmicon (siehe Bild 1), öffnet sich das Steuerzentrum von DMXControl (siehe Bild 2). Dieses Fenster bietet dem Bediener den Zugriff auf alle Module, Wekkzeuge und Konfigurationen von DMXControl. Ausser über die Menüpunkte Datei, Fenster, Konfiguration und ?, besteht für die wichtigsten Module und Werkzeuge die Möglichkeit diese über die Icon's in der Icon-Leiste aufzurufen.

Desweiteren gibt Ihnen die Statuszeile am unteren Fensterrand des Steuerzentrums Auskunft über den Pfad und die Datei des geladenen Projekts, sowie die ungefähre Belastung des internen Nachrichtensystems angezeigt. Ausserdem werden hier noch Datum, aktuelle System-Uhrzeit und die Versionsnummer von DMXControl.

Abbildung 2:Das Steuerzentrum von DMXControl
Abbildung 2: Das Steuerzentrum von DMXControl


  • das Öffnen, Speichern und Beenden Ihrer Show (Menüpunkt "Datei")
  • den Aufruf sämtlicher Werkzeuge von DMXControl (Menüpunkt "Fenster")
  • die Konfiguration ihres Systems (Menüpunkt "Konfiguration")
  • den Aufruf von Supportfunktionen (Menüpunkt "?")

Beschreibung

Über die Iconleiste können die einzelnen DMXControl-Tools aufgerufen werden. Über Tooltipps wird die Bedeutung der Buttons angezeigt. Zusätzliche Funktionen sind

  • Blackout - Alle Geräte mit einem Dimmerkanal werden global ausgeschaltet.
  • Freeze - Stoppt die aktuelle Ausgabe der DMX-Werte auf das DMX-Universum (Output), hierbei verharren alle Geräte in der Funktion Ihrer letzten DMX-Werte vor dem betätigen des Freez-Buttons. Alle Einstellungen die während der aktivierten Freeze Funktion gemacht werden werden nicht nach aussen weitergeleitet.
  • Audiowiedergabe abbrechen - Eine gestartete Audioszene kann mit diesem Button vorzeitig abgebrochen werden.

Bedienelemente

Das Menü Datei

Im Menü Datei befinden sich vor allem die Windows Standard-MenüPunkte.

Icon Menü Menüpunkt Shortcut Beschreibung
Neu Datei Neues Projekt... n.a. Erstellen eines neuen Projekts
Öffnen Datei Öffnen... n.a. Projekt Öffnen
Speichern Datei Speichern... STRG+S Überschreibt das aktuell ausgewählte Projekt
DMXC2 Manual Steuerzentrum Icon-Space.png Datei Speichern unter... n.a. Speichert das Projekt im ausgewählten Ordner
DMXC2 Manual Steuerzentrum Icon-Space.png Datei Pack & Go... n.a. Komplettes Projekt archivieren, für den Umzug auf einen neuen Rechner
DMXC2 Manual Steuerzentrum Icon-Space.png Datei Beenden n.a. Beendet DMXControl mit den üblichen Sicherheits und Speicherabfragen

Das Menü Fenster

Das Menü Fenster enthält alle für DMXControl wichtigen Menüpunkte zum aufruf der Module, ebenso werden hier zusätzlich instllierte Plugins angezeigt.

Icon Menü Menüpunkt Shortcut Beschreibung
Neu Fenster Geräte n.a. Erstellen eines neuen Projekts
Öffnen Fenster Grafische Bühnenansicht n.a. Projekt Öffnen
Speichern Fenster Gruppenauswahl STRG+S Überschreibt das aktuell ausgewählte Projekt
DMXC2 Manual Steuerzentrum Icon-Space.png Fenster Kanalübersicht n.a. Speichert das Projekt im ausgewählten Ordner
DMXC2 Manual Steuerzentrum Icon-Space.png Fenster BeatTool n.a.
DMXC2 Manual Steuerzentrum Icon-Space.png Fenster DMXIn-Fernsteuerung n.a. Speichert das Projekt im ausgewählten Ordner
DMXC2 Manual Steuerzentrum Icon-Space.png Fenster Joystickfernsteuerung n.a.
DMXC2 Manual Steuerzentrum Icon-Space.png Fenster Kommandobox n.a. Projekt Speichern

Drei Funktionen aus der Menüleiste "Fenster" sind hier hervorzuheben:

  • Szenenbibliothek - Hier kann man direkt Einblick in alle gespeicherten Szenen nehmen.
  • Bearbeitungsansicht - Bei aktivierter Bearbeitungsansicht werden sämtliche Funktionen angezeigt, die man zum Programmieren von Shows benötigt. Wird die Option deaktiviert, werden Funktionen ausgeblendet, die man normalerweise im live-Betrieb nicht benötigt. Hierdurch werden die Fenster kleiner und es wird Platz auf dem Bildschirm eingespart.
  • Alle Fenster auf primären Bildschirm holen - Beim Arbeiten mit mehreren Monitoren kann es passieren, das man vergisst die Fenster wieder auf den primären Monitor zurückzuholen, wenn man nur noch mit dem primären Monitor arbeiten möchte. In diesem Fall lassen sich alle Fenster auf den primären Monitor holen.

Tipps

Projekte sollten in der Erstellungsphase sicherheitshalber regelmäßig gespeichert werden, insbesondere auch unter einem anderen Namen, um gegebenenfalls auf eine ältere Version zurückgreifen zu können. Die experimentellen Programmteile (z.B. neue Tools in der beta-Test Phase) erscheinen nur im Menü, wenn unter Konfiguration die entsprechende Option gewählt wurde.


Links und Referenzen


Arrow back.png Installation
Grafische Bühnenansicht Arrow forw.png
Inhaltsverzeichnis
Meine Werkzeuge
Namensräume

Varianten
Aktionen
Navigation
DMXControl 2
DMXControl 3
Tipps und Tricks
Hardware
Berichte
Werkzeuge