DDF DMXC2

Template:Chaptertitle DMXC

This section is actively undergoing a major edit for a while. To help avoid edit conflicts, please do not edit this section while this message is displayed or contact the editor (Steiny) of this page.

This page was last edited at 16:26, 10 November 2013 (UTC) 4032 days ago.

Hint:
25.10.2013: UPrenner: create the article page
07.11.2013 UPrenner: work-in-progress

Pack And Go Function DDFCreator Contents Chapter 1: Foreword Chapter 2: Introduction Chapter 3: Installation Chapter 4: Control center Chapter 5: Graphical view Chapter 6: Devices Chapter 7: Output plugins Chapter 8: Channel overview Chapter 9: Scenes Chapter 10: Cue list Chapter 11: Chasers tool Chapter 12: Submaster Chapter 13: Master Chapter 14: Sound analyzer Chapter 15: BeatTool Chapter 16: Command Box Chapter 17: Audioplayer Chapter 18: Timecode player Chapter 19: Textbook Chapter 20: Command line Chapter 21: Scheduler Chapter 22: Motion cue Editor Chapter 23: Shape editor Chapter 24: PDA remote control Chapter 25: Keyboard control Chapter 26: Joystick control Chapter 27: MIDI remote control Chapter 28: DMXIn remote control Chapter 29: Program settings Chapter 30: Plugins Chapter 31: Pack And Go Function Chapter 32: DDF basic Appendix 1: Glossary Appendix 2: Command overview

 

Overview

Picture 1: Graphical view with DDF icon

Picture 1: Graphical view with DDF icon

Picture 2: Opened DDF window with control elements

DDF is the abbreviation of Device Definition File. The DDF are the device description (Fixtures) in DMXControl, they serve to inform DMXControl about the functions of the attached DMX device to this. In the DDF the number becomes this one how channels of the DMX device defined and as well these use possible control elements:

• Position input control element e.g. at Movingheads and Scanners.
• RGB or CMY color choice control element to the color mixture at e.g. LED headlight or color mixed units at Movingheads.
• Dropdown control elements
• Button control elements.

Become the DDF in the « graphical view » with an icon of the device shown (see figure 1), then also can here be accessed the icon, the DDF window by a click with the control elements (see figure 2). XML format which is translated by DMXControl into the internal device description is carried out the description the DMX equipment in one. The DDF are found the DMXControl main directory in the sub-folder DEVICEs. The accompanying icon pictures, which one in the & laquo; Graphic stage view & raquo; be, lie in another sub-folder named shown images.

You get prefabricated DDFs, which weren't enclosed at the installation, can you perhaps of the DMXControl home page in the device library. DDF can be made in a simple way with a XML editor (e. g. PSPad) or also with the DDFCreator. There are advantages and disadvantages with the DDFCreator as also the construction of a DDF with a XML editor. With a XML editor, paraphrasing an existing DDF can be managed considerably faster than with the DDFCreator, against this one is fundamentally faster with the DDFCreator at the construction of a new DDF surface with slidern, button etc.

At both one needs a corresponding knowledge to make an operating DDF no matter whether one now the DDFCreator preferred or the XML editor. Shall the following chapters be conveyed for you, this knowledge among other things the language reference serves as a reference book

Description

A very common language syntax which e.g. is also used in the other dialects at web pages or WAP in the Internet sides is XML (eXtensible Markup Language). But you don't have to be an expert to make a new device description too manually. The following simple notes suffice:

Please take care that your editor doesn't store any (invisible) control characters. There won't be any problems at the Windows editor or PSPad. If you want to use Word or similar software, you should save the file in the raw document format (*.txt).

• The DMXControl dialect of XML requires for every opening tag always one (<tag>) closing (</tag>) tag. Only this one gets the last level completed just by implication day (e. g. <item caption= "white" value="0" />).
• The final signs /> and </tag> are semantically equivalent, also <item caption="white" value="0" > </item> is valid in this case.
• Every day can have attributes which you find professed in the table below. Every attribute value is started with an equals sign and the value must always be included in double apostrophes.
• All day and attribute identifiers are noted down at DMXControl in a small letter.
• The day has to be defined hierarchically. They also should make this recognizable about corresponding indents.
• As a rule, not cares about the order of the attributes of a day. Where it for once depends on the order anyway, you describe below explicitly.
• Comment are noted down in the form <!- This is a comment —>.
• E.g. you can have a look at xml files (therefore also the DMX DEVICEs files) in open form with the Internet Explorer.

So it was already this - we have a look at a simple example.

Example: dimmed spotlight

Every device should get an apt icon to receive an adapted representation in stage representation. This icon will be find in the subdirectory Images (Root:\Programme\DMXControl\Devices\Images).

The icons afterwards still can be changed in DMXControl. (In the context menu of the graphical view).

The preceding line numbers of the following XML example file cannot be inserted; they serve only the description of the example:

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="Intensity" 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>

Row   1		the Parser will informed about the used XML version.
Row   2		the global description of the new type of device defines inclusive reference to the icon to be put and one ( initialization of the device the optional initsequence was demonstrated here, is but at a headlight only conditionally appropriately. The dimmer channel is (50%) ) put on DMX value 128 at the initialization here.
Row   3		the DMX channels of the device are defined between line 3 and 5.
Row   4		the channel description of the first channel is. This is always the channel numbers at zero important begin, i. e. the first channel is channel="0". In addition, other parameters as well as the channel name are still put here.
Row   6		the lines 6-9 describe the form, that is this one, to graphic coordinates in the context menu for the device picture, names and start address in the unity „Pixel“.
Row 10		here the operating devices follow a slider with his graphic coordinates and the assignment to the channel in question with her qualities, in this example now. Operating devices like radio badges also could, drop down or badges are declared for other types of device here.

Picture 3: Dimmer-DDF

Picture 3: Dimmer-DDF

Three button become Pinup button, Move button, Close button will be generatedly per default generatedly on the top right side (see figure 3).

Create a DDF

Before you make a new DDF, please have a look on our webside in the device library whether a suitable or similar already give it to definitions for your device. To make a new DDF, you modify an existing DDF of a similar device best. This goes text been based change considerably faster than with the DDF Creator just with this. If you have completed your work, you simply put the xml file in the subdirectory in the DMXControl list „DEVICEs“himself has in your DMX installation as of and store the corresponding gif picture (in the format 32 x32 pixels, the transparency fashion proves itself) in the subdirectory „images“in this „DEVICE“List-. The device should be visible at the next start of DMXControl so.

Syntax overview

Every description contains four main parts (see figure 4):

• Description of global qualities device (in the example dimmed spotlight line 1-2)
• Description of the individual DMX channels channels (in the example dimmed spotlight line 3-5)
• Description of the graphic context menu form (in the example dimmed spotlight line 6-11)
• Prozedure code (not contained, optionally in the example)

Picture 4: Basic structure of a DDF

Picture 4: Basic structure of a DDF

All form elements must on the will provide DDF form with graphic coordinates to the positioning. The elements „Label“ and „Line“ are passive and serve only the design of the surface. The remaining active elements of the form (also control element mentioned, e.g. on/off) can be used for the active control of the DMX device.

Graphical elements

The figure 5 shows a survey of all supported graphic elements. An assignment to the required syntax elements is carried out in the explanation texts.

Picture 5: Graphic elements

Picture 5: Graphic elements

The following figure 6 illustrates the meaning of the graphic coordinates of the control elements:

Picture 6: Graphic coordinates of the control elements

Picture 6: Graphic coordinates of the control elements

Functional elements

The active control elements interact in 3 possible concepts with DMXControl or the device in which exactly one concept is selected at the definition of a concrete control element:

	Konzept	Beschreibung	Beispiel
1	Channel/Value concept	The control element is assigned via the channel attribute to a concrete channel. Concrete values or ranges of values which are put at the activity of the control element are defined in the control element.	- option list   caption="Star sky" value="165" - Value range of the slider   startvalue="0" endvalue="255"
2	Sequences	An instruction consequence which is executed when operating is defined in the control element as a string.	clicksequence= “set 1 75; set 2 100“
3	Action/Procedures	A separately defined procedure contains more complex program instructions. The procedure is operate assigned via the action attribute and at everybody the control element executed.	action="SetGobo"

This which Channel attribute and the action attribute can want to use alternatively in the control elements particularly means.

For many applications the first two concepts are sufficient.

Like the complexity and cardinality of the 3 concepts grows, the running time requirements also increase. The simplest variant on the solution of a task should therefore always be chosen. Also at the channel description an action attribute can be used. This means that the procedure is called at every change of the channel value. In figure 7 an example is shown how different control elements can interact with the channels. „So like the complexity and channel_n“address and can over the 3 mentioned above concepts be put. The current value, obliged to it for a control element are, are addressed more than one name freely eligible for office (reference) assigned to the control element here „control_n“bezeichnet. Im following example is for three control elements „Actionses“and additional „Reference names“assigned. And therefore should, as a rule these Actionses be able to do one or put several Channel values „set name“being described. Furthermore there is one „action“ assigned to the channel_3. This is intended to read and to inform about to the control elements the current channel values „assigned to the channel_3. Scheduled, this one are Get name this for this“get since she must read current channel values.

Picture 7: Interaction of control elements

Picture 7: Interaction of control elements

The markings of the buttons don't have a meaning here.

Syntax

This chapter describes the syntax of the device and form configuration files of DMXControl.

Generic attributs

Attributes often recurring are described to it globally once for the shortening with the same meaning after the following tables here.

Reference	Attribute	Hierachie and properties	Notice	Example
GP1	value	Assigned DMX value	byte	0, 128, 255
GP2	caption	Descriptive enumeration value. Explanatory name for an attitude.	string	Dimmer, Strobe, usw.
GP3	top	Relative x-coordinate of the element of the left upper corner	integer	top=“150“
GP4	left	Relative x-coordinate of the element of the left upper corner.	integer	left=“100“
GP5	width	Width of the element	integer	width=“80“
GP6	height	Height of the element	integer	height=“30“

All coordinate details (top, left, width, height) are indicated in pixel.

Device description

Tag	Attribute	Hierachie and properties	Notice	Example
<device>		Level 1
	image	Icon filename.	string, Filename.gif	Moon.gif
	initsequence	Sets initial values for the individual DMX channels of the device	Optional use e.g. for scanner/moving head's start position	set 0 15; set 7 128;
<information>		Level 2 Supplementary comment.
<name>		Level 3 Arbitrary text.		Custom Scanner
<vendor>		Level 3 Arbitrary text (manufacturer).	optional	Showtec
<deviceidentifier>		Level 3 Arbitrary text (manufacturer identifier.	optional	TG-3
<author>		Level 3 Arbitrary text (originator).	optional
<comment>		Level 3 Arbitrary text (comment).	optional
<help>		Level 2 Help text (ASCII).	optional

Channel description

Tag	Attribute	Hierachie and properties	Notice	Example
<channels>		Level 2 For every DMX channel is one “<function>”-part to define
<function>		Level 3 Subtag from “<channels>“
	channel	Internal DMX channel number channel no. must always of 0 climbing without interruption be defined for the individual channels	integer
	minvalue	Minimal DMX value	integer
	maxvalue	Maximal DMX value	integer
	name	Descripting name for the channel.	string	Intensity
	fade	Channel fading	string	yes,no
	type	Channel typ Important for the internal data handling	string	dimmer, r,g,b, pan, panfine, tilt, tiltfine, color, gobo
	action	Call of a procedure at change of the channel value	string optional
<virtual>		Level 3 Subtag from “<channels>“
<channel>		Level 4 Subtag from “<virtual>“
	channel	Internal DMX channel number The three rgb channels assigned to the virtual dimmer	integer

The channel type (type) also should allocate channel for everybody become provided that this channel to the type matches. E.g. it doesn't make sense to describe every channel as a dimmer.

dimmer	reserved for channels these regulate the intensity
r,g,b	reserve for channels of RGB LED equipment, r for the red channel, g for the green channel, b for the blue channel. On the one hand, r, g, b are for the type it HAL needs in DMXControl. This also means, this in the graphical view the colors of the spotlights be shown. One can one racks use this in the program configuration under « graphical view » and then at « symbol » « representation of the colors instead of graphic ». On the other hand, the type also for the one into the 2.12 new one LED's run light generator required becomes.
a,w	reserve for channels of (RGB)A as and (RGB)W LED devices, a for the amber channel, W for the white channel. The type a and w aren't supported by DMXControl yet the device, however, is appropriately since amber or white channel make a bigger and bigger contribution to the market and therefore perhaps are supported by DMXControl soon, too with additional.
pan, panfine	reserve for the Pan channels of scanners, moving heads or similar equipment. How pan is and panfine assigned to the channel for the rough control the channel for the fine control at 16 bits of device.
tilt, tiltfine	as in the case of pan and panfine but for the tilt axis.
color, gobo	The appropriate Farb and Goborad channels can be assigned to (importantly to color & gobo lists)
c, m, y	reserviert für Kanäle von CMY-Geräten, c für den Cyan Kanal, m für den magenta Kanal und y für den gelben Kanal. Die types c, m, y werden noch nicht von DMXControl unterstützt sind aber sinnvoll. reserved for CMY devices, c for the cyan channel, m for the magenta channel, y for the yellow channel. The type c, m, y aren't supported by DMXControl make sense, however, yet.
other	all other channels don't need a type description

The ones for RGB devices reserved type's are important the HAL (Hardware Abstraction Layer) since version 2. 11 in which then be able to the adjusted colors of the spotlight, be represented in the graphical view too. Also for version 2.12, here they also are needed for the RGB running light generator.

Menue description

Tag	Attribute	Hierachie and properties	Notice	Example
<form>		Level 2 Subtag from “<device>“
	width height	See generic attribute GP5; GP6	integer
<deviceimage>		'Level 3 Subtag from “<form>“; Absolute position of the shown picture
	top left width height	See generic attribute GP3 bis GP6	integer
<devicename>		'Level 3 Subtag from “<form>“; Absolute position of the shown name
	top left width height	See generic attribute GP3 bis GP6	integer
<deviceaddress>		'Level 3 Subtag von “<form>“; Absolute position of the shown base address
	top left width height	See generic attribute GP3 bis GP6	integer

Control elements

Position control

Tag	Attribute	Hierachie and properties	Notice	Example
<position>		Level 3 Subtag from “<form>“; Creates a positioning field for positioning from scanners or moving heads.	By a click on the button down on the right in the DDF you can switch between a cartesian and polar positioning.
	top left width height	See generic attribute GP3 bis GP6	integer

The position pointer can be placed by initsequenz

Slider

Tag	Attribute	Hierachie and properties	Notice	Example
<slider>		Level 3 Subtag from “<form>“; Creates a slider
	top left width height	See generic attribute GP3 bis GP6	integer
	channel	assigned channel alternative for action	integer optional
	startvalue	Value range of the Slider (lower value)	integer	startvalue="0"
	endvalue	Value range of the Slider (uper value)	integer	endvalue="255"
	tickfreq	Scaling, distance of the scale subdivision	integer	tickfreq="32"
	smallchange	Change rate e.g. at the up down keys	integer (VB-properties)	smallchange="20"
	largechange	Change rate e.g. at the mouse click (not draged)	integer (VB-properties)	largechange="50"
	name	Referenz name for procedure code (variable name)	string optional	StrobeSpeed
	action	Call of a procedure at change at the Slider alternative channel	string optional	SetSpeed

Dropdown

Tag	Attribute	Hierachie and properties	Notice	Example
<dropdown>		Level 3 Subtag from“<form>“; Creates a dropdown menu.
	top left width	See generic attribute GP3 bis GP5	integer
	channel	Assigned channel alternative for action	integer optional
	name	Referenz name for procedure code (variable name)	string optional	Gobo
	action	Call of a procedure at change of a dropdown entries, alternative for channel	string optional	SetGobo
<item>		Level 4 Subtag from “<dropdown>“
	caption	Explanatory name	string	Clear
	value	DMX value for caption	integer	value="0"
	minvalue maxvalue	Value range for caption for the diplayed of the dropdown entry.	integer	minvalue="10" maxvalue="26"
	color	Show a square with the assigned color before caption.	hex	color="#ff0000" Color Red
<colorlist>		Level 4 Subtag from “<dropdown>“ All entries of the in color list assigned to the device insert.	optional a substitute/ addition for Item
<gobolist>		Level 4 Subtag from“<dropdown>“ All entries of the in gobo list assigned to the device insert.	optional a substitute/ addition for Item

Options

Tag	Attribute	Hierachie and properties	Notice	Example
<options>		Level 3 Subtag from “<form>“; Creates a radio button field
	top left	See generic attribute GP3 & GP4	integer
	channel	Assigned channel alternative foraction	integer optional
	action	Call of a procedure at change of a radio buttons, alternative for channel	optional	SetGoboSpeed
	name	Referenz name for procedure code (variable name)	string optional	GoboSpeed
<option>		Level 4 Subtag from “<options>“
	caption	See generic attribute GP2	string	off
	value	DMX value for caption	integer	0
	top left	See generic attribute GP3 & GP4, relativ position for positioning from “<options>“	integer	left="0" top="0"

On/Off-Button

Tag	Attribute	Hierachie and properties	Notice	Example
<onoff>		Level 3 Subtag from “<form>“; Creates a button as switch
	top left width height	See generic attribute GP3 bis GP6	integer
	channel	Assigned channel alternative for action	integer optional
	action	Call of a procedure at pushing the buttons alternative for channel	string optional	SetLampOnOff
	name	Referenz name for procedure code (variable name)	string optional	LampOnOff
	caption	Explanatory name	string	On/Off
	color	Hex RGB color value of the button	hex	color="#00ff00" color green
	onvalue	DMX value for button ON	integer	onvalue="150"
	offvalue	DMX value for button OFF	integer	offvalue="0"
	onsequence	Execute a Sequence, by switching to ON	string	"set 0 230; set 1 25"
	offsequence	Execute a Sequence, by switching to OFF	string	"set 0 0; set 1 0"

Command-Button

Tag	Attribute	Hierachie and properties	Notice	Example
<command>		Level 3 Subtag for “<form>“; Creates a button as push button.
	top left width height	See generic attribute GP3 bis GP6	integer
	action	Call of a procedure at pushing the button.	string optional	SetReset
	name	Referenz name for procedure code (variable name)	string optional	Reset
	caption	Explanatory name	string	Reset
	color	Hex RGB color value of the button	string	color="#0000ff" color blue
	clicksequence	Activity to be started at the button click is specified in the attribute	string	"save 0; set 0 230; hold 5500; restore 0"
	downsequence	Activity to be started at push down the button is specified in the attribute	string	"save 0; set 0 230; hold 5500; restore 0"
	upsequence	Activity to be started at relase the button is specified in the attribute	string	"save 0; set 0 230; hold 5500; restore 0"

Colorpicker

Tag	Attribute	Hierachie and properties	Notice	Example
<colorpicker>		Level 3 Subtag von “<form>“; Erzeugt einen Colorpicker.
	top left width height	Siehe Generische Attribute GP3 bis GP6	integer
	channel1	Zuordnung zum 1. Kanal Rot oder Cyan, alternativ zu action	integer optional
	channel2	Zuordnung zum 2. Kanal Grün oder Magenta, alternativ zu action	integer optional
	channel3	Zuordnung zum 3. Kanal Blau oder Yellow, alternativ zu action	integer optional
	name	Referenzname für procedure code (Variablenname)	string optional	ColRGB
	action	Aufruf einer Prozedur bei Änderung einer Farbe, alternativ zu channel1-3	string optional	SetColRGB
	mode	Auswahl der zwei Modi RGB oder CMY	string	mode=“cmy“
	layout	Auswahl von zwei verschiedenen Layouts des Colorpickers	integer	layout="1"

Beispiel:

<colorpicker mode="rgb" channel1="0" channel2="1" channel3="2" layout="2" top="40"
left="0" height="75" width="177"/>

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 design elements

Tag	Attribute	Hierachie and properties	Notice	Example
Bild:DMXC2_Manual_DDF_Line.png
<line>		Level 3 Subtag von “<form>“; Gestaltungselement; Erzeugt eine Linie.
	x1; y1	Startkoordinate der Linie	integer
	x2; y2	Endkoordinate der Linie	integer
Bild:DMXC2_Manual_DDF_Label.png
<label>		Level 3 Subtag von “<form>“; Gestaltungselement; zusätzliche Beschreibung eines Bedienelementes.
	top left width height	Siehe Generische Attribute GP3 bis GP6	integer
	caption	Anzuzeigender Text	string	CMY Mischung

Beispiel: miniatur|zentriert|600px|Bild 8: DDF Giotto Spot 400

Help

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.

Sequences

Operation	Bedeutung	Beispiel
save >channel<	Zwischenspeichern des aktuellen Kanal- werts des DMX-Kanals >channel<	"save 0; set 0 230; hold 5500; restore 0"
set >channel< >value<	Setzt den Kanal >channel< auf Wert >value<	"save 0; set 0 230; hold 5500; restore 0"
hold >time<	Timer (wartet >time< in msec.)	"save 0; set 0 230; hold 5500; restore 0"
restore >channel<	Setzt den zwischengespeicherten Wert des DMX-Kanals >channel< wieder zurück	"save 0; set 0 230; hold 5500; restore 0"

Procedurs (advanced programming options)

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.

General principles

Die Prozeduren werden als Action-Attribut den <function>-Tags (Kanälen) oder den Steuerungselementen z.B. <onoff>, <slider> oder <dropdown> zugeordet. Bei Bedienung entsprechender Steuerungselemente wird der Code der Prozedur automatisch interpretiert und ausgeführt. Ist das Action-Attribut dagegen einem Kanal in den <function>-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 Name-Attribut deklariert sind, z.B.

<dropdown top="16" left="207" width="113" name="color_color" action="SetColor">

Dies bedeutet: Die Prozedur SetColor wird bei Bedienung des Dropdown-Menüs ausgeführt und der Wert des Dropdown-Menüs wird als Variable color_color an die aufgerufene Prozedur SetColor übergeben.

Weiterhin existieren implizite Referenzen als standardmäßige Zuordnung zu den Kanälen. So ist z.B. channel_2 implizit mit dem Kanal (function) mit channel=2 verbunden, dem auch die Action GetColor zugeordnet ist.

<function channel="2" minvalue="0" maxvalue="255" name="Farbe" fade="no" 
action="GetColor" colorchannel="yes"/>

Variablen im eigentlichen Sinne als frei belegbare Speicherwerte sind bisher nicht definiert.

Basic syntax elements and conventions

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:

Operation	Bedeutung
!	beginnt einen Befehl
|	separiert die einzelnen Bestandteile
$	beendet einen Befehl

Es werden folgende arithmetische Operationen unterstützt:

Operation	Bedeutung
+	Addition
-	Subtraktion
*	Multiplikation
/	Division
mod	Modulo-Operation (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:

DMXControl code	Generische Sprachvariante
!set_channel|2|(227+{color_speed})$	channel_2 := 227 + color_speed
!set_channel|3|((({gobos_gobo}-1)*51)+25)$	channel_3 := (gobos_gobo-1)*51+25
!set_control|gobos_speed|((({channel_3}-1) mod 51)-26)$	gobos_speed := ((channel_3 -1) mod 51)-26

Die verwendeten Standardoperatoren haben folgende Semantik:

Operation	Bedeutung
set_control | >cntr< | >val<	setzt das Steuerelement mit dem angegebenen Namen >cntr< auf den Wert des Ausdruckes >val<
set_channel | >ch< | >val<	Übergibt an den angegebenen Kanal >ch< den Wert >val<

Folgende Vergleichsoperatoren können verwendet werden:

Operation	Alternative Schreibweise	Bedeutung
>	> |gt|	größer
<	< |lt|	kleiner
=	&eq; |eq|	gleich

Mit Hilfe der Vergleichsoperationen können Bedingungen formuliert werden, da DMXControl die if-Anweisung unterstützt.

DMXControl code	Generische Sprachvariante
!if|{channel_3} < 1|	if channel_3 < 1 then

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 of the procedure code

Tag	Attribut	Hierachie und Eigenschaft	Bemerkung	Beispiel
<code>		Level 2 Subtag von "<device>" enthält alle Proceduren
<procedure>		Level 3 Subtag von "<code>" enthält den Code der Procedure
	name	Name der Prozedur	string	SetGobo

An example prozedure

Dieses Beispiel zeigt eine Prozedure, 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:

<function channel="2" minvalue="0" maxvalue="255" name="Farbe" fade="no" 
action="GetColor"/>

“color_color” ist die Referenz auf den Wert der Klappbox zur Farbauswahl.

<dropdown top="16" left="207" width="113" name="color_color" action="SetColor">

“color_speed” ist die Referenz auf den Wert des Schiebereglers zur Geschwindigkeit:

<slider top="16" left="320" height="25" width="65" startvalue="0" endvalue="18" 
tickfreq="9" smallchange="1" largechange="5" name="color_speed" action="SetColor"/>

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.

DMXControl code	Generische Sprachvariante
<procedure name='GetColor'>	Procedure GetColor( )
!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)$ $ $	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; ;
</procedure>	end

Tip(s)

Neu in DMXControl 2.12 sind die 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 and references

Links

 

Pack And Go Function DDFCreator Contents Chapter 1: Foreword Chapter 2: Introduction Chapter 3: Installation Chapter 4: Control center Chapter 5: Graphical view Chapter 6: Devices Chapter 7: Output plugins Chapter 8: Channel overview Chapter 9: Scenes Chapter 10: Cue list Chapter 11: Chasers tool Chapter 12: Submaster Chapter 13: Master Chapter 14: Sound analyzer Chapter 15: BeatTool Chapter 16: Command Box Chapter 17: Audioplayer Chapter 18: Timecode player Chapter 19: Textbook Chapter 20: Command line Chapter 21: Scheduler Chapter 22: Motion cue Editor Chapter 23: Shape editor Chapter 24: PDA remote control Chapter 25: Keyboard control Chapter 26: Joystick control Chapter 27: MIDI remote control Chapter 28: DMXIn remote control Chapter 29: Program settings Chapter 30: Plugins Chapter 31: Pack And Go Function Chapter 32: DDF basic Appendix 1: Glossary Appendix 2: Command overview