Skistner at 11:47, 2 March 2025

2025-03-02T11:47:31Z

← Older revision		Revision as of 13:47, 2 March 2025
Line 1:		Line 1:
	{{~~Chaptertitle~~\|Version=~~DMXControl~~ 3.2.3}}		{{Manual Header
			\| Type = DMXC3 DDFs
	~~{{DMXC3_Manual-Navigation_DDF~~		\| Version = 3.2.3
	~~\|backLink =~~		\| LinkForwards = DDF-Tutorial 4-Spot-Bar DMXC3
	~~\|backText =~~		\| TextForwards = 4-Spot-LED-Bar
	\|~~forwardLink~~ = DDF-~~Tutorial_4er~~-~~Bar_DMXC3~~
	\|~~forwardText~~ = ~~4er~~-Bar
	}}		}}

Line 152:		Line 150:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<rawstep dmxchannel="4" name="Macros">		<rawstep dmxchannel="4" name="Macros">
	<step caption="No function" mindmx="0" maxdmx="9" />		<step caption="No function" mindmx="0" maxdmx="4" />
	<step caption="Color macro" mindmx="5" maxdmx="84" />		<step caption="Color macro" mindmx="5" maxdmx="84" />
	<step caption="Color jump" mindmx="85" maxdmx="169" />		<step caption="Color jump" mindmx="85" maxdmx="169" />
Line 198:		Line 196:
	</rgb>		</rgb>
	<rawstep dmxchannel="4" name="Macros">		<rawstep dmxchannel="4" name="Macros">
	<step caption="No function" mindmx="0" maxdmx="9" />		<step caption="No function" mindmx="0" maxdmx="4" />
	<step caption="Color macro" mindmx="5" maxdmx="84" />		<step caption="Color macro" mindmx="5" maxdmx="84" />
	<step caption="Color jump" mindmx="85" maxdmx="169" />		<step caption="Color jump" mindmx="85" maxdmx="169" />
Line 217:		Line 215:
	[[Category: DDF DMXControl 3]]		[[Category: DDF DMXControl 3]]
	[[Category: Tutorials DMXControl 3]]		[[Category: Tutorials DMXControl 3]]
			[[de: DDF-Tutorial LED-Scheinwerfer DMXC3]]

Unknown user: Created page with "{{Chaptertitle|Version=DMXControl 3.2.3}} {{DMXC3_Manual-Navigation_DDF |backLink = |backText = |forwardLink = DDF-Tutorial_4er-Bar_DMXC3 |forwardText = 4er-Bar }} Image:C..."

2024-02-07T23:15:02Z

Created page with "{{Chaptertitle|Version=DMXControl 3.2.3}} {{DMXC3_Manual-Navigation_DDF |backLink = |backText = |forwardLink = DDF-Tutorial_4er-Bar_DMXC3 |forwardText = 4er-Bar }} Image:C..."

New page

{{Chaptertitle|Version=DMXControl 3.2.3}}

{{DMXC3_Manual-Navigation_DDF
|backLink =
|backText =
|forwardLink = DDF-Tutorial_4er-Bar_DMXC3
|forwardText = 4er-Bar
}}

[[Image:Cameo LED Mini Tri Par Can 3W.png|thumb|300px]]In front of us is the '''Cameo LED Mini Tri Par Can 3W''', which is also identical in construction to the '''lightmaXX Platinum LED MINI PAR Tri-LED 7x 3 Watt'''. In the following, we will create a DDF for this simple LED PAR fixture with its own dimmer and strobe channel, as well as a DMX channel for macros. The LED PAR fixture thus has six DMX channels.

= Initial Data: User Manual =
Before we start programming the actual DDF, it's always worth taking a look at the user manual. There you will generally find a table listing all DMX channels and their respective functions – in short, the channel assignment.

However, sometimes it's also useful to additionally look at the technical data of your device. Here you'll find information that may not always be apparent from the channel assignment. This includes, for example, the maximum strobe frequency.

== Channel Assignment ==
The table for the channel assignment looks like this for the LED PAR fixture:
{| class="wikitable toptextcells"
|-
! Channel !! Value !! Function
|-
|style="width: 10em"| <code>CH1</code>
|style="width: 10em"| <code>000 - 255</code>
|style="width: 40em"| Master Dimmer (0% - 100%)
|-
| <code>CH2</code>
| <code>000 - 255</code>
| Red (0% - 100%)
|-
| <code>CH3</code>
| <code>000 - 255</code>
| Green (0% - 100%)
|-
| <code>CH4</code>
| <code>000 - 255</code>
| Blue (0% - 100%)
|-
|rowspan="3"| <code>CH5</code>
| <code>000 - 004</code>
| No function
|-
| <code>005 - 084</code>
| Color macro
|-
| <code>170 - 255</code>
| Color fade
|-
| <code>CH6</code>
| <code>000 - 255</code>
| Strobe
|}

== Technical Data ==
As indicated earlier, the channel assignment does not specify the maximum strobe frequency of the LED PAR fixture. Therefore, let's now take a look at the technical data.

'''Control Functions'''
* 6-channel DMX control
* Separate control of colors Red, Green, and Blue

'''Features'''
* 7 powerful TRI-color LEDs (3 W)
* Music control via built-in microphone
* Color change speed and strobe effect controllable via control panel
* Multicolor color change
* Strobe frequency: max. 15 Hz
* Master/Slave functionality
* Robust, compact housing
* Power consumption: 30 W
* Long-life LEDs with particularly long lifespan
* Double bracket

From the technical data, it is evident that the maximum strobe frequency is 15 Hz. With this information gathered, we can now start programming the DDF.

= Programming: XML Code =
First, open a blank file in a text editor of your choice, such as the classic Editor from Windows or Notepad++, and save it directly in the file format *.xml. This has the advantage, especially with Notepad++, that the XML code is automatically colored differently depending on the code type.

== Base Section ==
The first line in a DDF is always:

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8" ?>
</syntaxhighlight>
 

This specifies how this file is to be read by DMXControl and all other programs accessing this file.

After the information about the document standard, the <code>device</code> tag opens the area for the actual information stored in the DDF. The image file for the icon in the Stage View is named <code>Cameo LED Mini Tri Par Can 3W.png</code>. The device is a <code>DMXDevice</code> with <code>6</code> DMX channels. The DDF is created for DMXControl 3 with version <code>3.2.3</code> and has so far only been edited once, which is why it is version <code>1.0.0</code>. The specification of version <code>3.2.3</code> specifically has the effect that the DDF can only be used for this and all newer versions of DMXControl 3. If someone wants to use your DDF with DMXControl 3.2.2 instead, this would not be possible.

<syntaxhighlight lang="xml">
<device image="Cameo LED Mini Tri Par Can 3W.png" type="DMXDevice" dmxaddresscount="6" dmxcversion="3.2.3" ddfversion="1.0.0">
</syntaxhighlight>

== Information Section ==
In the information section, the designation of the device, in this case <code>LED Mini Tri Par Can 3W</code> provided by the manufacturer <code>Cameo</code>, is stored. This DDF was created by <code>Stefan Kistner</code>. All this information is enclosed by the element <code><information> ... </information></code>.

<syntaxhighlight lang="xml">
<information>
<model>LED Mini Tri Par Can 3W</model>
<vendor>Cameo</vendor>
<author>Stefan Kistner</author>
</information>
</syntaxhighlight>
 

== Function Section ==
The function section is always opened by the <code>functions</code> tag.

=== Dimmer Channel ===
The first DMX channel is the Dimmer channel. The corresponding element is also called <code>dimmer</code>. Since programming always starts counting from 0, the value {{Manual Value | DMX channel | 0}} must be entered for the <code>dmxchannel</code> attribute. At DMX value {{Manual Value | DMX value | 0}}, the LED PAR fixture is completely off, meaning {{Manual Value || 0%}} brightness. From this, the value {{Manual Value | DMX value | 0}} for the <code>mindmx</code> attribute and also {{Manual Value || 0}} for <code>minval</code> are derived. The maximum brightness of {{Manual Value || 100%}} is reached by the LED PAR fixture at DMX value {{Manual Value | DMX value | 255}}. Consequently, the value for the <code>maxdmx</code> attribute is {{Manual Value | DMX value | 255}} and for <code>maxval</code> it is {{Manual Value || 100}}. At the beginning of the line, we need to add a fifth attribute named <code>type</code>, which receives the entry <code>linear</code> as its value. This informs the HAL that the <code>range</code> element is a slider where the output values <code>mindmx</code> and <code>maxdmx</code> increase in a consistent ratio (hence <code>linear</code>) with the input values (<code>minval</code> and <code>maxval</code>).

The XML code section looks like this:

<syntaxhighlight lang="xml">
<functions>
<dimmer dmxchannel="0">
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</dimmer>
</syntaxhighlight>
 

However, it's worth mentioning that this is the cumbersome definition of the dimmer. If the dimmer behaves as described above (0% brightness at DMX value {{Manual Value | DMX value | 0}} and full brightness at DMX value {{Manual Value | DMX value | 255}}), we can use the internal standard definition of the HAL. This simplifies the first part as follows:

<syntaxhighlight lang="xml">
<functions>
<dimmer dmxchannel="0" />
</syntaxhighlight>
 

=== Channels for Red, Green, and Blue ===
Since this LED PAR fixture only has red, green, and blue LEDs for color mixing, a simple RGB element is used in the DDF. The DMX channel {{Manual Value | DMX channel | 2}} controls the red LEDs, DMX channel {{Manual Value | DMX channel | 3}} controls the green, and DMX channel {{Manual Value | DMX channel | 4}} controls the blue LEDs.

The <code>rgb</code> element consists of three subordinate elements, <code>red</code>, <code>green</code>, and <code>blue</code> – one element for each color. For the <code>dmxchannel</code> attributes, we enter the values {{Manual Value | DMX channel | 1}}, {{Manual Value | DMX channel | 2}}, and {{Manual Value | DMX channel | 3}}.

<syntaxhighlight lang="xml">
<rgb>
<red dmxchannel="1" />
<green dmxchannel="2" />
<blue dmxchannel="3" />
</rgb>
</syntaxhighlight>
 

=== Macro Channel ===
Through the fifth DMX channel of this LED PAR fixture, we can call various automatic programs.

To best represent this channel in the DDF, we use the <code>rawstep</code> element. With the subordinate elements, the <code>rawstep</code> element creates a selection list in the {{Manual Windowcaption|[[Device Control DMXC3|Device Control]]}}.

For each <code>step</code>, there is a short description stored in the <code>caption</code> attribute. For example, for the first option, it is {{Manual Value | Caption | No function}}. Additionally, there are values for the <code>mindmx</code> and <code>maxdmx</code> attributes. You can transfer all this information from the user manual.

<syntaxhighlight lang="xml">
<rawstep dmxchannel="4" name="Macros">
<step caption="No function" mindmx="0" maxdmx="9" />
<step caption="Color macro" mindmx="5" maxdmx="84" />
<step caption="Color jump" mindmx="85" maxdmx="169" />
<step caption="Color fade" mindmx="170" maxdmx="255" />
</rawstep>
</syntaxhighlight>
 

=== Strobe Channel ===
The Strobe channel is on DMX channel {{Manual Value | DMX channel | 6}}. The present LED PAR fixture only has a simple strobe function, which is off at DMX value {{Manual Value | DMX value | 0}} ({{Manual Value ||0 Hz}}) and continuously speeds up until DMX value {{Manual Value | DMX value | 255}}, reaching a strobe frequency of {{Manual Value || 15 Hz}}. Thus, the values of the attributes <code>mindmx</code>, <code>maxdmx</code>, <code>minval</code>, and <code>maxval</code> are already determined. The value for the <code>type</code> attribute is still open. In the DDF, you must specify <code>linear</code> as the value, since the strobe frequency increases steadily with increasing DMX values.

It is important to mention at this point that the unit (here, Hertz) is not entered. Additionally, for DMXControl 3 to know that you want to adjust the strobe frequency variably, the subordinate element must be a <code>range</code> element.

<syntaxhighlight lang="xml">
<strobe dmxchannel="5" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
</strobe>
</functions>
</syntaxhighlight>
 

Since there are no further functions after the Strobe element, the <code><functions></code> element is closed with the end tag <code></functions></code>.

== Procedures ==
For this simple LED PAR fixture, there are no special functions, such as initiating a reset of the device. Therefore, the element for Procedures is completely omitted.
Finally, the <code><device></code> element must be closed with the end tag <code></device></code>.

= Result: the finished DDF =
The complete DDF for the Cameo LED Mini Tri Par Can 3W looks like this:

<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<device image="Cameo LED Mini Tri Par Can 3W.png" type="DMXDevice" dmxaddresscount="6" dmxcversion="3.2.3" ddfversion="1.0.0">
<information>
<model>LED Mini Tri Par Can 3W</model>
<vendor>Cameo</vendor>
<author>Stefan Kistner</author>
</information>
<functions>
<dimmer dmxchannel="0" />
<rgb>
<red dmxchannel="1" />
<green dmxchannel="2" />
<blue dmxchannel="3" />
</rgb>
<rawstep dmxchannel="4" name="Macros">
<step caption="No function" mindmx="0" maxdmx="9" />
<step caption="Color macro" mindmx="5" maxdmx="84" />
<step caption="Color jump" mindmx="85" maxdmx="169" />
<step caption="Color fade" mindmx="170" maxdmx="255" />
</rawstep>
<strobe dmxchannel="5" >
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
</strobe>
</functions>
</device>
</syntaxhighlight>
 

= Links and References =
== Links ==
<references/>

[[Category: DDF DMXControl 3]]
[[Category: Tutorials DMXControl 3]]

DDF-Tutorial LED-Spotlight DMXC3 - Revision history

Skistner at 11:47, 2 March 2025

Unknown user: Created page with "{{Chaptertitle|Version=DMXControl 3.2.3}} {{DMXC3_Manual-Navigation_DDF |backLink = |backText = |forwardLink = DDF-Tutorial_4er-Bar_DMXC3 |forwardText = 4er-Bar }} Image:C..."