Lektion 20 Tut3

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

{{{Überschrift}}}

Vorlage:DMXC3 lesson

Ü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	fod property	<fog dmxchannel="0" />
shutter	fixture has a shutter	<shutter dmxchannel="4" />
strobe	fixture has a strobe channel	<strobe dmxchannel="7" />
rgb	fixture uses RGB color mode	<red dmxchannel="0" /> <green dmxchannel="1" /> <blue dmxchannel="2" />
position	fixture has pan/tilt control	<position> <pan dmxchannel="0" > <range range="170" /> </pan> <tilt dmxchannel="1" > <range range="110" /> </tilt>
color wheel	fixtures contains color wheel	<colorwheel dmxchannel="2"/>
gobo wheel	fixtures contains gobo wheel	<gobowheel dmxchannel="2"/>

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" />

or:

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

Zertifikat

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