Intensity (DDF-Syntax) DMXC3: Difference between revisions

From English DMXC-Wiki
No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Chaptertitle |Version = DMXControl 3.2.3}}
{{Manual Header
 
| Type = DMXC3 DDFs
{{DMXC3_Manual-Navigation_DDF
| Version = 3.2.3
| backLink = Basic rules (DDF-Syntax) DMXC3
| LinkBackwards = Basic rules (DDF-Syntax) DMXC3
| backText = Basic Rules of DDF Creation
| TextBackwards = Basic Rules of DDF Creation
| forwardLink = Position_(DDF-Syntax)_DMXC3
| LinkForwards = Position (DDF-Syntax) DMXC3
| forwardText = Position
| TextForwards = Position
}}
}}


{{Manual_Windowcaption| Dimmer}}, {{Manual_Windowcaption| Switch}}, {{Manual_Windowcaption| Shutter}}, and {{Manual_Windowcaption| Strobe}} are functions in the DDFs for DMXControl 3, which are assigned to the group {{Manual_Objectcaption| Intensity}} and thereby influence the brightness of a device. For this purpose, the GUI provides a corresponding {{Manual_Windowcaption| [[Control Panel DMXC3|control panel]]}}.
{{Manual Windowcaption| Dimmer}}, {{Manual Windowcaption| Switch}}, {{Manual Windowcaption| Shutter}}, and {{Manual Windowcaption| Strobe}} are functions in the DDFs for DMXControl 3, which are assigned to the group {{Manual Objectcaption| Intensity}} and thereby influence the brightness of a device. For this purpose, the GUI provides a corresponding {{Manual Windowcaption| [[Control Panel DMXC3|control panel]]}}.


= Dimmer =
= Dimmer =
Line 37: Line 37:
* Linear dimming behavior from {{Manual Value || 0%}} brightness (off) at DMX value {{Manual Value | DMX value | 0}} to maximum brightness of {{Manual Value || 100%}} at DMX value {{Manual Value | DMX value | 127}}.
* Linear dimming behavior from {{Manual Value || 0%}} brightness (off) at DMX value {{Manual Value | DMX value | 0}} to maximum brightness of {{Manual Value || 100%}} at DMX value {{Manual Value | DMX value | 127}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | range-generic }}
|-
! style="vertical-align:top" | Description
! Attribute !! type !! mindmx !! maxdmx !! minval !! maxval
|
|-
| DMX value for low brightness
! style="width: 200px; vertical-align:top" | Description
| DMX value for maximum brightness
| style="width: 175px" |  
| Lowest brightness
| style="width: 175px" | DMX value for low brightness
| Maximum brightness
| style="width: 175px" | DMX value for maximum brightness
| style="width: 175px" | Lowest brightness
| style="width: 175px" | Maximum brightness
|-
|-
! style="vertical-align:top" | Permissible attribute value  
! style="vertical-align:top" | Permissible attribute value  
Line 88: Line 85:
* Shutter {{Manual Value || open}} at DMX values between {{Manual Value | DMX value | 234}} and {{Manual Value | DMX value | 255}}.
* Shutter {{Manual Value || open}} at DMX values between {{Manual Value | DMX value | 234}} and {{Manual Value | DMX value | 255}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | step-generic }}
! style="vertical-align:top"| Description
|
| Lower DMX value for the state
| Upper DMX value for the state
|-
|-
! Attribute !! type !! mindmx !! maxdmx
! style="vertical-align:top" | Permissible attribute value
|-
! style="width: 200px; vertical-align:top"| Description
| style="width: 175px" |
| style="width: 175px" | Lower DMX value for the state
| style="width: 175px" | Upper DMX value for the state
|-
! style="vertical-align:top"| Permissible attribute value
| <code>closed</code><br /> <code>open</code>
| <code>closed</code><br /> <code>open</code>
| <code>0</code> to <code
| <code>0</code> to <code>255</code>
 
>255</code>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
|}
|}


= Strobe =
= Strobe =
== Basic Functions ==
== Basic functions ==
Various functions such as different strobe effects can be assigned to the strobe channel. The following strobe effects are common:
Various functions such as different strobe effects can be assigned to the strobe channel. The following strobe effects are common:
* <code>linear</code>: Strobe frequency steadily increases to almost continuous lighting
* <code>linear</code>: Strobe frequency steadily increases to almost continuous lighting
Line 130: Line 122:
* {{Manual Value | Caption | Random}} strobe at DMX values between {{Manual Value | DMX value | 173}} and {{Manual Value | DMX value | 255}} with a speed of {{Manual Value || 1 Hz}} to {{Manual Value || 12 Hz}}.
* {{Manual Value | Caption | Random}} strobe at DMX values between {{Manual Value | DMX value | 173}} and {{Manual Value | DMX value | 255}} with a speed of {{Manual Value || 1 Hz}} to {{Manual Value || 12 Hz}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | range-generic }}
|-
! style="vertical-align:top" | Description
! Attribute !! type !! mindmx !! maxdmx !! minval !! maxval
|
|-
| DMX value for minimum strobe frequency
! style="width: 200px; vertical-align:top" | Description
| DMX value for maximum strobe frequency
| style="width: 175px" |  
| Minimum strobe frequency
| style="width: 175px" | DMX value for minimum strobe frequency
| Maximum strobe frequency
| style="width: 175px" | DMX value for maximum strobe frequency
| style="width: 175px" | Minimum strobe frequency
| style="width: 175px" | Maximum strobe frequency
|-
|-
! style="vertical-align:top" | Permissible attribute value
! style="vertical-align:top" | Permissible attribute value
Line 153: Line 142:
* <code>strobetype</code>: Selection of the strobe effect via a separate DMX channel
* <code>strobetype</code>: Selection of the strobe effect via a separate DMX channel


=== Strobe Type ===
=== Strobe type ===
The <code>strobetype</code> selects the strobe effect via a separate DMX channel. This function is usually available when the device can generate many different strobe effects, and the strobe frequency should still be precisely adjusted in this context.
The <code>strobetype</code> selects the strobe effect via a separate DMX channel. This function is usually available when the device can generate many different strobe effects, and the strobe frequency should still be precisely adjusted in this context.


Line 175: Line 164:
* {{Manual Value | Caption | Random}} strobe in the range between DMX values {{Manual Value | DMX value | 6}} and {{Manual Value | DMX value | 255}} with speeds from {{Manual Value || 0.5 Hz}} to {{Manual Value || 25 Hz}}, with DMX values between {{Manual Value | DMX value | 43}} and {{Manual Value | DMX value | 85}} on DMX channel {{Manual Value | DMX channel | 2}}.
* {{Manual Value | Caption | Random}} strobe in the range between DMX values {{Manual Value | DMX value | 6}} and {{Manual Value | DMX value | 255}} with speeds from {{Manual Value || 0.5 Hz}} to {{Manual Value || 25 Hz}}, with DMX values between {{Manual Value | DMX value | 43}} and {{Manual Value | DMX value | 85}} on DMX channel {{Manual Value | DMX channel | 2}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | step-generic }}
|-
! style="vertical-align:top" | Description
! Attribute !! handler !! mindmx !! maxdmx
|
|-
| Minimum DMX value
! style="width: 200px; vertical-align:top" | Description
| Maximum DMX value
| style="width: 175px" |  
| style="width: 175px" | Minimum DMX value
| style="width: 175px" | Maximum DMX value
|-
|-
! style="vertical-align:top" | Permissible attribute value  
! style="vertical-align:top" | Permissible attribute value  
| <code>strobetype</code>
| <code>strobetype</code>
| <code>0</code> to <code>255</code
| <code>0</code> to <code>255</code>
 
>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
|}
|}


== Additional Functions ==
== Additional functions ==
The following additional functions are possible for the entire strobe channel:
The following additional functions are possible for the entire strobe channel:
* <code>duration</code>: Setting the duration of a single flash
* <code>duration</code>: Setting the duration of a single flash
Line 214: Line 198:
* {{Manual Value | Caption | Linear}} strobe in the range between DMX values {{Manual Value | DMX value | 6}} and {{Manual Value | DMX value | 255}} with speeds from {{Manual Value || 1 Hz}} to {{Manual Value || 12 Hz}}. Flash duration from {{Manual Value || 0 ms}} to {{Manual Value || 650 ms}} via DMX channel {{Manual Value | DMX channel | 2}} in the range between DMX values {{Manual Value | DMX value | 0}} and {{Manual Value | DMX value | 255}}.
* {{Manual Value | Caption | Linear}} strobe in the range between DMX values {{Manual Value | DMX value | 6}} and {{Manual Value | DMX value | 255}} with speeds from {{Manual Value || 1 Hz}} to {{Manual Value || 12 Hz}}. Flash duration from {{Manual Value || 0 ms}} to {{Manual Value || 650 ms}} via DMX channel {{Manual Value | DMX channel | 2}} in the range between DMX values {{Manual Value | DMX value | 0}} and {{Manual Value | DMX value | 255}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic }}
|-
! style="vertical-align:top" | Description
! Attribute !! type !! mindmx !! maxdmx !! minval !! maxval
|
|-
| DMX value for shortest flash duration
! style="width: 200px; vertical-align:top" | Description
| DMX value for longest flash duration
| style="width: 175px" |  
| Shortest flash duration
| style="width: 175px" | DMX value for shortest flash duration
| Longest flash duration
| style="width: 175px" | DMX value for longest flash duration
| style="width: 175px" | Shortest flash duration
| style="width: 175px" | Longest flash duration
|-
|-
! style="vertical-align:top" | Permissible attribute value  
! style="vertical-align:top" | Permissible attribute value  
Line 233: Line 214:
|}
|}


[[de:Intensity (DDF-Syntax) DMXC3]]
[[Category: DDF DMXControl 3]]
[[Category: DDF DMXControl 3]]

Latest revision as of 16:56, 2 March 2025

Blockdevice.png Article describe
DMXControl 3.2.3
Stand: 02.03.2025		 Intensity (DDF-Syntax) DMXC3
Arrow back.png Basic Rules of DDF Creation
Position Arrow forw.png
Table of contents
Part 1: Basics
Part 2: Functions
Part 3: Procedures
Part 4: Examples

Dimmer, Switch, Shutter, and Strobe are functions in the DDFs for DMXControl 3, which are assigned to the group Intensity and thereby influence the brightness of a device. For this purpose, the GUI provides a corresponding control panel.

Dimmer

The dimmer channel controls the brightness of a device. LED PAR spotlights or moving heads usually have only one dimmer channel. Depending on the configuration, resolutions ranging from the standard resolution of 8 bits to finer resolutions up to 32 bits are possible. For this purpose, the element is expanded to <dimmer dmxchannel="0" finedmxchannel="1" ultraddmxchannel="2" ultrafinedmxchannel="3" />. DMXControl automatically handles the corresponding calculation of which DMX channel to control.


Important Hint Unlike LED PARs, scanners, or moving heads, dimmer packs have multiple dimmer channels. However, it is not necessary to map the dimmer pack with its four, six, or twelve dimmer channels itself. It is more helpful and easier to add the connected halogen PAR spotlights to the project accordingly.


Case Code example
Standard 
<dimmer dmxchannel="0" />

Dimmer on DMX channel 1 with a standard linear dimming behavior from 0% brightness (off) at DMX value 0 to maximum brightness of 100% at DMX value 255.

Dimmer with 16-bit resolution 
<dimmer dmxchannel="0" finedmxchannel="1" />

Dimmer with 16-bit resolutions on DMX channels 1 and 2

Simple dimmer in a specific DMX value range 
<dimmer dmxchannel="0">
  <range type="linear" mindmx="0" maxdmx="127" minval="0" maxval="100" />
</dimmer>

Dimmer on DMX channel 1:

  • Linear dimming behavior from 0% brightness (off) at DMX value 0 to maximum brightness of 100% at DMX value 127.
Attribute type mindmx maxdmx minval maxval
Description DMX value for low brightness DMX value for maximum brightness Lowest brightness Maximum brightness
Permissible attribute value linear 0 to 255 0 to 255 0 % to 100 % 0 % to 100 %

Switch

The function switch is used whenever only two states need to be toggled, for example, the state "work light on" and the state "work light off".

Apart from the DMX channel, no further information needs to be provided for this element. DMXControl 3 automatically outputs a DMX value of 0 for brightness values less than 50% and a DMX value of 255 for brightness values above 50%.

It is recommended to use this function only with a switch pack. For activating another operating mode, such as sound-to-light control, the rawstep element is better suited.


Case Code example
Standard 
<switch dmxchannel="0" />

Switch on DMX channel 1

Shutter

The shutter is usually found in moving heads or scanners with a discharge lamp. Mechanical shutters are inserted into the light beam when the device should not emit light. Additionally, the strobe effect is generated via the shutter. For moving heads or scanners with LEDs as a light source, this behavior is simulated electronically.

Usually, several functions need to be assigned to the shutter channel, but at least the functions "shutter closed" and "shutter open".


Case Code example
Standard 
<shutter dmxchannel="0">
  <step type="closed" mindmx="0" maxdmx="21" />
  <step type="open" mindmx="234" maxdmx="255" />
</shutter>

Shutter on DMX channel 1:

  • Shutter closed at DMX values between 0 and 21.
  • Shutter open at DMX values between 234 and 255.
Attribute type mindmx maxdmx
Description Lower DMX value for the state Upper DMX value for the state
Permissible attribute value closed
open 		0 to 255 0 to 255

Strobe

Basic functions

Various functions such as different strobe effects can be assigned to the strobe channel. The following strobe effects are common:

  • linear: Strobe frequency steadily increases to almost continuous lighting
  • pulse: Pulsating strobe effect
  • random: Flashes occur at random intervals with increasing intensity
  • ramp up: Flashes become brighter up to the maximum value and then go out abruptly
  • spikes: Individual flashes are generated


Case Code example
Standard 
<strobe dmxchannel="0">
  <step type="open" mindmx="0" maxdmx="5" />
  <range type="linear" mindmx="6" maxdmx="89" minval="1" maxval="12" />
  <range type="pulse" mindmx="90" maxdmx="172" minval="0.5" maxval="6" />
  <range type="random" mindmx="173" maxdmx="255" minval="1" maxval="12" />
</strobe>

Strobe on DMX channel 1:

  • No strobe at DMX values between 0 and 5.
  • Linear strobe with speed increasing from 1 Hz at DMX value 6 to 12 Hz at DMX value 89.
  • Pulsating strobe at DMX values between 90 and 172 with a speed of 0.5 Hz to 6 Hz.
  • Random strobe at DMX values between 173 and 255 with a speed of 1 Hz to 12 Hz.
Attribute type mindmx maxdmx minval maxval
Description DMX value for minimum strobe frequency DMX value for maximum strobe frequency Minimum strobe frequency Maximum strobe frequency
Permissible attribute value linear
pulse
random
ramp up
ramp down
ramp up/down
lightning
spikes 		0 to 255 0 to 255 0 Hz to 50 Hz 0 Hz to 50 Hz

Subfunctions

The following subfunctions are possible for individual functions of the strobe channel:

  • strobetype: Selection of the strobe effect via a separate DMX channel

Strobe type

The strobetype selects the strobe effect via a separate DMX channel. This function is usually available when the device can generate many different strobe effects, and the strobe frequency should still be precisely adjusted in this context.


Case Code example
Standard 
<strobe dmxchannel="0">
  <strobetype dmxchannel="1" />
  <step type="open" mindmx="0" maxdmx="5" />
  <range type="linear" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
    <step handler="strobetype" mindmx="6" maxdmx="42" />
  </range>
  <range type="random" mindmx="6" maxdmx="255" minval="0.5" maxval="25" >
    <step handler="strobetype" mindmx="43" maxdmx="85" />
  </range>
</strobe>

Strobe frequency on DMX channel 1, strobe effect on DMX channel 2:

  • No strobe at DMX values between 0 and 5.
  • Linear strobe in the range between DMX values 6 and 255 with speeds from 0.5 Hz to 25 Hz, with DMX values between 6 and 42 on DMX channel 2.
  • Random strobe in the range between DMX values 6 and 255 with speeds from 0.5 Hz to 25 Hz, with DMX values between 43 and 85 on DMX channel 2.
Attribute type mindmx maxdmx
Description Minimum DMX value Maximum DMX value
Permissible attribute value strobetype 0 to 255 0 to 255

Additional functions

The following additional functions are possible for the entire strobe channel:

  • duration: Setting the duration of a single flash

Duration

The duration sets the length of the flash duration of a single flash. The maximum flash duration corresponds to the strobe frequency. For certain combinations of strobe frequency and duration, a continuous lighting is generated if technically possible.


Case Code example
Standard 
<strobe dmxchannel="0">
  <step type="open" mindmx="0" maxdmx="5" />
  <range type="linear" mindmx="6" maxdmx="255" minval="1" maxval="12" />
  <duration dmxchannel="1" >
    <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="650" />
  </duration>
</strobe>

Strobe frequency on DMX channel 1, flash duration on DMX channel 2:

  • No strobe at DMX values between 0 and 5.
  • Linear strobe in the range between DMX values 6 and 255 with speeds from 1 Hz to 12 Hz. Flash duration from 0 ms to 650 ms via DMX channel 2 in the range between DMX values 0 and 255.
Attribut type mindmx maxdmx minval maxval
Description DMX value for shortest flash duration DMX value for longest flash duration Shortest flash duration Longest flash duration
Permissible attribute value linear 0 to 255 0 to 255 0 ms to 2000 ms 0 ms to 2000 ms
Retrieved from "https://wiki-en.dmxcontrol-projects.org/index.php?title=Intensity_(DDF-Syntax)_DMXC3&oldid=4183"