Version vom 15. August 2011, 14:02 Uhr

[[Bild:{{{Logo}}}|48px|link=]]

{{{Überschrift}}}

Überblick

In dieser Lektion lernst Du, wie das Erstellen und Hinzufügen neuer Gerätedefinitionen funktioniert. Du mußt diese Action nur machen, wenn Dein Gerät noch nicht als Standardgerät von DMXControl3 definiert ist.

Lektion 20: Neue Gerätedefinitionen erstellen

Eine Gerätedefinitionsdatei (kurz: DDF) wird verwendet, um DMXControl über die Eigenschaften eines Gerätes zu informieren. Ein DDF ist in XML-Sprache geschrieben und die Datei befindet sich im Ordner

<DMXControl program path>\kernel\devices

Wenn Du mit DDFs von DMXControl 2 vertraut bist, dann kannst Du einige wichtige Unterschiede feststellen:

Es gibt keine grafische Oberfläche (GUI), da DMXControl 3 kein Gerätekontextmenü unterstützt
Einige Syntaxelemente sind sehr ähnlich (speziell im Informations-Teil), d.h. Du kannst die bestehenden DDFs wiederverwenden
Der Funktionsteil ist viel abstrakter: Du machst die Definition vor allem durch die Eigenschaften und nicht durch die DMX-Kanäle

Derzeit gibt es keinen "DDF Creator" für DMXControl 3, wir empfehlen, einen Text-Editor oder XML-Editor-Tool zu verwenden. (Hinweis: Wir brauchen Unterstützung für die Adaption eines bestehenden php-Tool von DMXControl 2 zu DMXControl 3)

Als erstes schauen wir uns ein sehr einfaches DDF an ("Generic RGB Par"):

 01 <?xml version="1.0" encoding="utf-8" ?>
 02 <device image="bild" type="DMXDevice">
 03  <information>
 04    <modell>Generic RGB PAR</modell>
 05    <vendor>Generic</vendor>
 06    <author>Arne Luedtke</author>
 07  </information>
 08  <functions>
 09    <rgb>
 10      <red dmxchannel="0" />
 11      <green dmxchannel="1" />
 12      <blue dmxchannel="2" />
 13    </rgb>
 14  </functions>
 15 </device>

Zeile 01 ist zwingend notwendig für die Beschreibung der XML-Version. Zeile 02 und 15 bilden den Rahmen für die Geräte-Definition, die aus zwei Teilen besteht:

Informationsbereich (Zeile 03 bis 07), keine weitere Erklärung notwendig.
Funktionsbereich (Zeile 08 to 14)

Das Gerät in unserm Beispiel hat eine Eigenschaft: RGB color Modus. Die Zuordnung der DMX Kanäle wird in den Zeilen 10 bis 12 beschrieben.

Das ist alles!

Folgende Tabelle zeigt die vorhandenen Eigenschaften

Property	Description	Comment
switch	fixture has a switch channel	<switch dmxchannel="0" />
dimmer	fixture has a dimmer channel	<dimmer dmxchannel="0" />
fog	fog property	<fog dmxchannel="0" />
shutter	fixture has a shutter	<shutter dmxchannel="4" />
strobe	fixture has a strobe channel	<strobe dmxchannel="7" />
iris	fixture has a Iris	<iris dmxchannel="0"/>
focus	fixture has a Focus	<focus dmxchannel="0"/>
zoom	fixture has a Zoom	<zoom dmxchannel="0"/>
rgb	fixture uses RGB color mode	<rgb> <red dmxchannel="0" /> <green dmxchannel="1" /> <blue dmxchannel="2" /> </rgb>
cmy	fixture uses CMY color mode	<cmy> <cyan dmxchannel="0"/> <magenta dmxchannel="1"/> <yellow dmxchannel="2"/> </cmy>
position	fixture has pan/tilt control	<position> <pan dmxchannel="0" > <range range="170" /> </pan> <tilt dmxchannel="1" > <range range="110" /> </tilt> </position>
color wheel	fixtures contains color wheel	<colorwheel dmxchannel="2"/>
gobo wheel	fixtures contains gobo wheel	<gobowheel dmxchannel="2"/>

Wenn ein Gerät über feine Kanäle für z.B Zoom, dann schreibt man das so:

<zoom dmxchannel="0" finedmxchannel="1"/>

das funktioniert bei jedem Property.

Die verschiedenen Interwalle in einem DMX Kanal werden von der „Step“ Variablen definiert:

<step val="0" mindmx="0" maxdmx="127" />
<step val="100" mindmx="128" maxdmx="255" />

oder:

<step type="color" val="#FFFFFF" caption="Weiß" mindmx="0" maxdmx="31" />
<step type="color" val="#FF0000" caption="Rot" mindmx="32" maxdmx="63" />

Zusätzliche Themen (von beta testern)

Bitte die Beschreibung vervollständigen
Während des Beta Tests gibt es keine Uploadmöglichkeit für neue DDFs. Dies muß noch aktualisiert werden.

Übung

Wirf einen Blick in einige Definitionen von Geräten, bevor Du eigene DDFs erstellst.
Öffne das DDF für den TS255. Trenne die unterschiedlichen Eigenschaften durch Leerzeilen, um es besser zu verstehen
Erstelle ein DDF für Dein eigenes Gerät.

Zusätzliche Links

Zertifikat

Ich habe die Themen in dieser Lektion verstanden und möchte mit der nächsten Lektion weitermachen: Lektion 21

FB_Addon_TelNo{height:15px !important; white-space: nowrap !important; background-color: #0ff0ff;}

@@ Zeile 52: / Zeile 52: @@
 Das ist alles!
-Folgende Tabelle zeigt die vorhandenen Eigenschaften
+Folgende Tabelle zeigt die vorhandenen Eigenschaften<br>
-fixture has a shutter
 {| class="wikitable"
@@ Zeile 97: / Zeile 95: @@
 | fixture uses RGB color mode
 |
 &lt;rgb&gt;<br>
 &nbsp; &lt;red dmxchannel="0" /&gt;<br>
 &nbsp; &lt;green dmxchannel="1" /&gt;<br>
 &nbsp; &lt;blue dmxchannel="2" /&gt;<br>
 &lt;/rgb&gt;<br>
 |-
@@ Zeile 125: / Zeile 123: @@
 | fixture has pan/tilt control
 | nowrap="nowrap" |
 &lt;position&gt;
 &nbsp;&nbsp; &lt;pan dmxchannel="0" &gt;
 &nbsp;&nbsp;&nbsp; &lt;range range="170" /&gt;
 &nbsp; &lt;/pan&gt;
 &nbsp; &lt;tilt dmxchannel="1" &gt;
 &nbsp;&nbsp;&nbsp; &lt;range range="110" /&gt;
 &nbsp; &lt;/tilt&gt;
 &lt;/position&gt;<br>
 |-
@@ Zeile 150: / Zeile 148: @@
 | &lt;gobowheel dmxchannel="2"/&gt;
 |}
+Wenn ein Gerät über feine Kanäle für z.B Zoom, dann schreibt man das so:<br>
+<source lang="xml"><zoom dmxchannel="0" finedmxchannel="1"/></source><br>
+das funktioniert bei jedem Property.
+<br>
 Die verschiedenen Interwalle in einem DMX Kanal werden von der „Step“ Variablen definiert:
@@ Zeile 156: / Zeile 162: @@
   &lt;step val="100" mindmx="128" maxdmx="255" /&gt;
-or:
+oder:
   &lt;step type="color" val="#FFFFFF" caption="Weiß" mindmx="0" maxdmx="31" /&gt;
@@ Zeile 195: / Zeile 201: @@
 FB_Addon_TelNo{height:15px !important; white-space: nowrap !important; background-color: #0ff0ff;}
+<br>
 <br>
 [[de:Lektion 20|de:Lektion 20]] [[en:Lesson 20|en:Lesson 20]]