No edit summary |
No edit summary |
||
| Line 93: | Line 93: | ||
|- | |- | ||
| switch | | switch | ||
| colspan="2" | | | colspan="2" | fixture has a switch channe<br> | ||
| colspan="3" | <pre><switch dmxchannel="0" /></pre> | | colspan="3" | <pre><switch dmxchannel="0" /></pre> | ||
|- | |- | ||
| dimmer | | dimmer | ||
| colspan="2" | | | colspan="2" | fixture has a dimmer channel<br> | ||
| colspan="3" | <pre><dimmer dmxchannel="0" /> </pre> | | colspan="3" | <pre><dimmer dmxchannel="0" /> </pre> | ||
|- | |- | ||
| fog | | fog | ||
| colspan="2" | | | colspan="2" | fod property <br> | ||
| colspan="3" | <pre><fog dmxchannel="0" /></pre> | | colspan="3" | <pre><fog dmxchannel="0" /></pre> | ||
|- | |- | ||
| shutter | | shutter | ||
| colspan="2" | | | colspan="2" | fixture has a shutter <br> | ||
| colspan="3" | <pre><shutter dmxchannel="0" /></pre> | | colspan="3" | <pre><shutter dmxchannel="0" /></pre> | ||
|- | |- | ||
| strobe | | strobe | ||
| colspan="2" | | | colspan="2" | fixture has a strobe channel<br> | ||
| colspan="3" | <pre><strobe dmxchannel="0" /></pre> | | colspan="3" | <pre><strobe dmxchannel="0" /></pre> | ||
|- | |- | ||
| iris<br> | | iris<br> | ||
| colspan="2" | | | colspan="2" | fixture has a iris channel<br> | ||
| colspan="3" | <pre><iris dmxchannel="0"/></pre> | | colspan="3" | <pre><iris dmxchannel="0"/></pre> | ||
|- | |- | ||
| focus<br> | | focus<br> | ||
| colspan="2" | | | colspan="2" | fixture has a fokus channel<br> | ||
| colspan="3" | <pre><focus dmxchannel="0"/></pre> | | colspan="3" | <pre><focus dmxchannel="0"/></pre> | ||
|- | |- | ||
| zoom<br> | | zoom<br> | ||
| colspan="2" | | | colspan="2" | fixture has a zoom channel<br> | ||
| colspan="3" | <pre><zoom dmxchannel="0"/></pre> | | colspan="3" | <pre><zoom dmxchannel="0"/></pre> | ||
|- | |- | ||
| rgb | | rgb | ||
| colspan="2" | | | colspan="2" | fixture has RGB function | ||
| colspan="3" | <pre><rgb> | | colspan="3" | <pre><rgb> | ||
<red dmxchannel="0" /> | <red dmxchannel="0" /> | ||
| Line 134: | Line 134: | ||
|- | |- | ||
| cmy<br> | | cmy<br> | ||
| colspan="2" | | | colspan="2" | fixture has CMY function<br> | ||
| colspan="3" | <pre><cmy> | | colspan="3" | <pre><cmy> | ||
<cyan dmxchannel="0"/> | <cyan dmxchannel="0"/> | ||
| Line 143: | Line 143: | ||
|- | |- | ||
| position | | position | ||
| colspan="2" | | | colspan="2" | fixture has Pan and/ or Tilt | ||
| nowrap="nowrap" colspan="3" | <pre><position> | | nowrap="nowrap" colspan="3" | <pre><position> | ||
<pan dmxchannel="0"> | <pan dmxchannel="0"> | ||
| Line 155: | Line 155: | ||
|- | |- | ||
| color wheel | | color wheel | ||
| colspan="2" | | | colspan="2" | fixtures contains gobo wheel | ||
| colspan="3" | <pre><colorwheel dmxchannel="0"> | | colspan="3" | <pre><colorwheel dmxchannel="0"> | ||
<step type="color" val="#ffffff" caption="Weiß" mindmx="0" maxdmx="0" /> | <step type="color" val="#ffffff" caption="Weiß" mindmx="0" maxdmx="0" /> | ||
| Line 167: | Line 167: | ||
|- | |- | ||
| rowspan="4" | gobo wheel | | rowspan="4" | gobo wheel | ||
| rowspan="3" | | | rowspan="3" | fixture with Gobo wheel | ||
| valign="top" nowrap="nowrap" | | | valign="top" nowrap="nowrap" | | ||
<br> | <br> | ||
Gobo rotation | |||
| valign="top" nowrap="nowrap" rowspan="3" | <pre><gobowheel dmxchannel="0"> | | valign="top" nowrap="nowrap" rowspan="3" | <pre><gobowheel dmxchannel="0"> | ||
| Line 192: | Line 192: | ||
|- | |- | ||
| valign="top" | | | valign="top" | | ||
Goboposition | |||
|- | |- | ||
Revision as of 09:00, 6 January 2013
{{#tree:id=dmxc3|openlevels=1|root=DMXC 3 lessons|
- preamble
- lesson 1: Installation and configuration
- lesson 2: The GUI panel concept
- lesson 3: Creating and patching fixtures
- lesson 4: The live view panel
- lesson 5: Setting properties with property panels
- lesson 6: Output plugins
- lesson 7: Summery and details - Setting
- lesson 8: Scenes (cues) and scene lists
- lesson 9: Fanning, chasers and other effects
- lesson 10: The programmer view
- lesson 11: Trigger concepts
- lesson 12: Editing scenes and scenelists
- lesson 13: Presets
- lesson 14: Summary and details - Programming
- lesson 15: Working with parallel scene lists
- lesson 16: Softpult
- lesson 17: Artnet
- lesson 18: Multi-media: Beamer tool, Matrix etc.
- lesson 19: Other clients and plugins (Android, iOS, ...
- lesson 20: Create new device definitions
- lesson 21: free topic
- lesson 22: Hints for testers and test reporting
- appendix1: Summary of commands ans shortcuts
- appendix2: Kernel menu tree
}}
Overview
In this lesson we will learn how to create and add new device definitions. You need to do this acivity only, if your device is not yet defined in the default set of DMXControl 3 device definitions.
Lecture 20: Create new device definitions
A device definition file (short: DDF) is used to inform DMXControl about the properties of a device. A DDF is wiritten in XML language and stored in the path
<DMXControl program path>\kernel\devices
If you are familar with DDFs of DMXControl 2.0 you will see some important differences:
- There is no GUI description part, because DMXControl 3 doesn't provide the device context menues
- Sone syntax elements are very similar (esp. in information part), i.e. you can reuse the existing DDFs
- The function part is much more abstract: You make the definition mainly by properties and not by DMX channels
Currently there is no "DDF creator" available fpr DMXControl 3, we recommend to use a text editor or XML editor tool. (Hint: We need support for adaption of an existing DMXControl 2 php tool towards DMXControl 3)
At first lets have a view to a very simple DDF ("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>
<comment>KLEINER TEXT</comment>
07 </information>
08 <functions>
09 <rgb>
10 <red dmxchannel="0" />
11 <green dmxchannel="1" />
12 <blue dmxchannel="2" />
13 </rgb>
14 </functions>
15 </device>
|
|
Line 01 is mandatory default line for describing the XML version. Lines 02 and 15 provide the frame for the device definition that contains of two parts:
- information part (lines 03 to 07), no need for further explanation.
- function(property) specification part (lines 08 to 14)
The "image" can be replaced by another .gif or .png file.
The example device posesses one property: RGB colar mode. The mapping to DMX channels is described in lines 10 to 12.
Thats all!
Following table shows the supported properties:
| Property | Description | Comment | |||
|---|---|---|---|---|---|
| switch | fixture has a switch channe |
<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="0" /> | |||
| strobe | fixture has a strobe channel |
<strobe dmxchannel="0" /> | |||
| iris |
fixture has a iris channel |
<iris dmxchannel="0"/> | |||
| focus |
fixture has a fokus channel |
<focus dmxchannel="0"/> | |||
| zoom |
fixture has a zoom channel |
<zoom dmxchannel="0"/> | |||
| rgb | fixture has RGB function | <rgb> <red dmxchannel="0" /> <green dmxchannel="1" /> <blue dmxchannel="2" /> </rgb> | |||
| cmy |
fixture has CMY function |
<cmy> <cyan dmxchannel="0"/> <magenta dmxchannel="1"/> <yellow dmxchannel="2"/> </cmy> | |||
| position | fixture has Pan and/ or Tilt | <position>
<pan dmxchannel="0">
<range range="540" />
</pan>
<tilt dmxchannel="1">
<range range="246" />
</tilt>
</position>
| |||
| color wheel | fixtures contains gobo wheel | <colorwheel dmxchannel="0"> <step type="color" val="#ffffff" caption="Weiß" mindmx="0" maxdmx="0" /> <step type="color" val="#00bd52" caption="Grün 203" mindmx="32" maxdmx="32" /> <step type="color" val="#080094" caption="Blau 108" mindmx="64" maxdmx="64" /> <step type="color" val="#8e10bc" caption="UV" mindmx="96" maxdmx="96" /> <step type="color" val="#eedefe" caption="1/2 Minus Green" mindmx="128" maxdmx="128" /> <step type="color" val="#ffffff" caption="Weiß" mindmx="160" maxdmx="160" /> </colorwheel> | |||
| gobo wheel | fixture with Gobo wheel |
Gobo rotation |
<gobowheel dmxchannel="0">
<goborotation dmxchannel="12" finedmxchannel="13">
<step type="stop" mindmx="0" maxdmx="2" />
<step type="stop" mindmx="253" maxdmx="255" />
<range type="cw" mindmx="3" maxdmx="127" minval="0,1" maxval="8" />
<range type="ccw" mindmx="252" maxdmx="128" minval="0,1" maxval="8" />
</goborotation>
<goboindex dmxchannel="8" finedmxchannel="9">
<range mindmx="0" maxdmx="255" range="395" />
</goboindex>
<step type="open" caption="Open" mindmx="0" maxdmx="11" />
<step type="gobo" caption="Gobo 1" mindmx="12" maxdmx="15" val="gobo1.png">
<step for="goborotation" mindmx="36" maxdmx="39" />
<step handler="shake" mindmx="60" maxdmx="71" minval="0,1" maxval="3" />
</step>
...
</gobowheel>
| ||
|
Goboposition | |||||
|
Rotation Gobo 1 Shake Gobo 1
| |||||
Wenn das Fixture über ein Farb/Goborad verfügt , das sich Kontinuirlich drehen kann, dann schreibt man das so:
<gobowheel dmxchannel="0">
<step type="open" caption="Open" mindmx="0" maxdmx="0" />
<step type="gobo" caption="Gobo 1" mindmx="11" maxdmx="11" />
...
<wheelrotation>
<range type="cw" mindmx="221" maxdmx="203" minval="0,1" maxval="2" />
<range type="ccw" mindmx="222" maxdmx="240" minval="0,1" maxval="2" />
</wheelrotation>
</gobowheel>
Wenn das Fixture über ein Farb/Goborad verfügt , das sich auf zufällige positionen drehen kann, dann schreibt man das so:
<gobowheel dmxchannel="0">
<step type="open" caption="Open" mindmx="0" maxdmx="0" />
...
<random>
<step type="fast" mindmx="241" maxdmx="245" />
<step type="medium" mindmx="246" maxdmx="250" />
<step type="slow" mindmx="251" maxdmx="255" />
</random>
</gobowheel>
Wenn ein Gerät über feine Kanäle für z.B Zoom verfügt, dann schreibt man das so:
<zoom dmxchannel="0" finedmxchannel="1"/>
das funktioniert bei jedem Property.
The different intervals in a DMX channel are defined by the "step" tag:
<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" />
 |
Ein DDF-Creator für DMXControl 3 ist bereits in Arbeit. Bis dahin bitte 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.
Bitte sendet uns Eure neuen DDFs, damit wir sie in die Bibliothek aufnehmen können. |
Excercise
- Have a look into several device definitions before creating your own DDF.
- Open the DDF for TS255. Separate the different properties by blank lines to get a better understanding.
- Create the DDF for your own device.
Certificate
I have understood the topics of this lecture and want to continue with next course: Lesson 21
| |||||||||