Beam (DDF-Syntax) DMXC3: Difference between revisions

From English DMXC-Wiki
(Created page with "{{Chaptertitle | Version=DMXControl 3.2.1}} {{DMXC3_Manual-Navigation_DDF |backLink = Gobo_(DDF-Syntax)_DMXC3 |backText = Gobo |forwardLink = Blades_(DDF-Syntax)_DMXC3 |forwa...")
 
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Chaptertitle | Version=DMXControl 3.2.1}}
{{Manual Header
 
| Type = DMXC3 DDFs
{{DMXC3_Manual-Navigation_DDF
| Version = 3.2.1
|backLink = Gobo_(DDF-Syntax)_DMXC3
| LinkBackwards = Gobo (DDF-Syntax) DMXC3
|backText = Gobo
| TextBackwards = Gobo
|forwardLink = Blades_(DDF-Syntax)_DMXC3
| LinkForwards = Blades (DDF-Syntax) DMXC3
|forwardText = Shutter Blades
| TextForwards = Shutter blades
}}
}}


{{Manual_Windowcaption|Focus}}, {{Manual_Windowcaption|Frost}}, {{Manual_Windowcaption|Iris}}, and {{Manual_Windowcaption|Zoom}} are functions in the DDFs for DMXControl 3, which are assigned to the group {{Manual_Objectcaption|Light beam}} and primarily affect the width of the light beam. The GUI provides a corresponding {{Manual_Windowcaption|[[Control_Panel_DMXC3|Control Panel]]}} for this purpose.
{{Manual Windowcaption|Focus}}, {{Manual Windowcaption|Frost}}, {{Manual Windowcaption|Iris}}, and {{Manual Windowcaption|Zoom}} are functions in the DDFs for DMXControl 3, which are assigned to the group {{Manual Objectcaption|Light beam}} and primarily affect the width of the light beam. The GUI provides a corresponding {{Manual Windowcaption|[[Control Panel DMXC3|Control Panel]]}} for this purpose.


= Focus =
= Focus =
The focus function is particularly used for the motorized "sharp focusing" of gobos for moving heads and scanners and can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.
The focus function is particularly used for the motorized "sharp focusing" of gobos for moving heads and scanners and can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.


{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en }}
|-
| Standard
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Standard
| style="width: 1000px" | <syntaxhighlight lang="xml">
<focus dmxchannel="0">
<focus dmxchannel="0">
   <range mindmx="255" maxdmx="0" minval="0" maxval="100" />
   <range mindmx="255" maxdmx="0" minval="0" maxval="100" />
</focus>
</focus>
</syntaxhighlight>
</syntaxhighlight>
Focus on DMX channel 1:
Focus on DMX channel {{Manual Value | DMX channel | 1}}:
* Linear adjustment of the focus from close at DMX value 255 to far at DMX value 0.
* Linear adjustment of the focus from {{Manual Value || close (0%)}} at DMX value {{Manual Value | DMX value | 255}} to {{Manual Value || far (100%)}} at DMX value {{Manual Value | DMX value | 0}}.
|}
|}
{| 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 close focus
! style="width: 200px; vertical-align:top" | Description
| DMX value for far focus
| style="width: 175px" |
| Close focus
| style="width: 175px" | DMX value for close focus
| Far focus
| style="width: 175px" | DMX value for far focus
| style="width: 175px" | Close focus
| style="width: 175px" | Far focus
|-
|-
! style="vertical-align:top" | Permissible attribute value  
! style="vertical-align:top" | Permissible attribute value  
Line 53: Line 47:
The frost filter can be used to soften a light beam. Some devices have a so-called linear frost filter, where the light beam can be increasingly softened. Other devices, on the other hand, only insert a disk with a frost filter into the light beam.
The frost filter can be used to soften a light beam. Some devices have a so-called linear frost filter, where the light beam can be increasingly softened. Other devices, on the other hand, only insert a disk with a frost filter into the light beam.


{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en }}
|-
| Linear frost filter
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Linear Frost Filter
| style="width: 1000px" | <syntaxhighlight lang="xml">
<frost dmxchannel="0">
<frost dmxchannel="0">
   <range mindmx="0" maxdmx="255" minval="0" maxval="100" />
   <range mindmx="0" maxdmx="255" minval="0" maxval="100" />
</frost>
</frost>
</syntaxhighlight>
</syntaxhighlight>
Frost on DMX channel 1:
Frost on DMX channel {{Manual Value | DMX channel | 1}}:
* Linear adjustment of the frost from no frost filter at DMX value 0 to fully inserted frost filter at DMX value 255.
* Linear adjustment of the frost from {{Manual Value || no frost filter (0%)}} at DMX value {{Manual Value | DMX value | 0}} to {{Manual Value || fully inserted frost filter (100%)}} at DMX value {{Manual Value | DMX value | 255}}.
|-
|-
| style="width: 200px" | Simple Frost Filter
| Simple frost filter
| style="width: 1000px" | <syntaxhighlight lang="xml">
| <syntaxhighlight lang="xml">
<frost dmxchannel="0">
<frost dmxchannel="0">
   <step type="open" mindmx="0" maxdmx="127" />
   <step type="open" mindmx="0" maxdmx="127" />
Line 73: Line 64:
</frost>
</frost>
</syntaxhighlight>
</syntaxhighlight>
Frost on DMX channel 1:
Frost on DMX channel {{Manual Value | DMX channel | 1}}:
* No frost filter between DMX value 0 and 127.
* {{Manual Value || No frost filter}} between DMX value {{Manual Value | DMX value | 0}} and {{Manual Value | DMX value | 127}}.
* Frost filter fully inserted at DMX value between 128 and 255.
* {{Manual Value || Frost filter fully inserted}} at DMX value between {{Manual Value | DMX value | 128}} and {{Manual Value | DMX value | 255}}.
|}
|}
{| 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 no frost filter
! style="width: 200px; vertical-align:top" | Description
| DMX value for frost filter inserted
| style="width: 175px" |
| No frost
| style="width: 175px" | DMX value for no frost filter
| Frost inserted
| style="width: 175px" | DMX value for frost filter inserted
| style="width: 175px" | No frost
| style="width: 175px" | Frost inserted
|-
|-
!rowspan="2" style="vertical-align:top" | Permissible attribute value  
! rowspan="2" style="vertical-align:top" | Permissible attribute value  
| <code>open</code><br />
| <code>open</code><br />
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
Line 107: Line 95:
The iris function can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.
The iris function can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.


{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en }}
|-
| Standard
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Standard
| style="width: 1000px" | <syntaxhighlight lang="xml">
<iris dmxchannel="0">
<iris dmxchannel="0">
   <range type="linear" mindmx="0" maxdmx="128" minval="0" maxval="100" />
   <range type="linear" mindmx="0" maxdmx="128" minval="0" maxval="100" />
</iris>
</iris>
</syntaxhighlight>
</syntaxhighlight>
Iris on DMX channel 1:
Iris on DMX channel {{Manual Value | DMX channel | 1}}:
* Linear opening of the iris from fully open (0%) at DMX value 0 to closed or iris fully retracted (100%) at DMX value 128.
* Linear opening of the iris from {{Manual Value || fully open (0%)}} at DMX value {{Manual Value | DMX value | 0}} to {{Manual Value || closed or iris fully retracted (100%)}} at DMX value {{Manual Value | DMX value | 128}}.
|}
|}
{| 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 smallest aperture
! style="width: 200px; vertical-align:top"| Description
| DMX value for largest aperture
| style="width: 175px" |
| Smallest aperture (closed)
| style="width: 175px" | DMX value for smallest aperture
| Largest aperture (open)
| style="width: 175px" | DMX value for largest aperture
| style="width: 175px" | Smallest aperture (closed)
| style="width: 175px" | Largest aperture (open)
|-
|-
! style="vertical-align:top"| Permissible attribute value  
! style="vertical-align:top"| Permissible attribute value  
Line 147: Line 129:
The zoom function changes the beam angle / opening angle of the device's light beam. It should not be confused with the iris. The zoom function can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.
The zoom function changes the beam angle / opening angle of the device's light beam. It should not be confused with the iris. The zoom function can be expanded to a resolution of 16 bits by inserting <code>finedmxchannel="1"</code>.


{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en }}
|-
| Linear zoom
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Linear Zoom
| style="width: 1000px" | <syntaxhighlight lang="xml">
<zoom dmxchannel="0" >
<zoom dmxchannel="0" >
   <range mindmx="255" maxdmx="0" minval="14" maxval="30" />
   <range mindmx="255" maxdmx="0" minval="14" maxval="30" />
</zoom>
</zoom>
</syntaxhighlight>
</syntaxhighlight>
Zoom on DMX channel 1:
Zoom on DMX channel {{Manual Value | DMX channel | 1}}:
* Linear reduction of the light beam from 30° at DMX value 0 to 14° at DMX value 255.
* Linear reduction of the light beam from {{Manual Value || 30°}} at DMX value {{Manual Value | DMX value | 0}} to {{Manual Value || 14°}} at DMX value {{Manual Value | DMX value | 255}}.
|-
|-
| style="width: 200px" | Zoom in Multiple Fixed Steps
| style="width: 200px" | Zoom in multiple fixed steps
| style="width: 1000px" | <syntaxhighlight lang="xml">
| style="width: 1000px" | <syntaxhighlight lang="xml">
<zoom dmxchannel="0">
<zoom dmxchannel="0">
Line 169: Line 148:
</syntaxhighlight>
</syntaxhighlight>
Zoom with three fixed opening angles on DMX channel 1:
Zoom with three fixed opening angles on DMX channel 1:
* Zoom angle of 15° at DMX value between 0 and 85.
* Zoom angle of {{Manual Value || 15°}} at DMX value between {{Manual Value | DMX value | 0}} and {{Manual Value | DMX value | 85}}.
* Zoom angle of 20° at DMX value between 86 and 171.
* Zoom angle of {{Manual Value || 20°}} at DMX value between {{Manual Value | DMX value | 86}} and {{Manual Value | DMX value | 171}}.
* Zoom angle of 25° at DMX value between 172 and 255.
* Zoom angle of {{Manual Value || 25°}} at DMX value between {{Manual Value | DMX value | 172}} and {{Manual Value | DMX value | 255}}.
|}
|}
{| 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 smallest opening angle
! style="width: 200px; vertical-align:top"| Description
| DMX value for largest opening angle
| style="width: 175px" |
| Smallest opening angle
| style="width: 175px" | DMX value for smallest opening angle
| Largest opening angle
| style="width: 175px" | DMX value for largest opening angle
| style="width: 175px" | Smallest opening angle
| style="width: 175px" | Largest opening angle
|-
|-
! style="vertical-align:top"| Permissible attribute value  
! style="vertical-align:top"| Permissible attribute value  
Line 192: Line 168:
|}
|}


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

Latest revision as of 15:25, 2 March 2025

Blockdevice.png Article describe
DMXControl 3.2.1
Stand: 02.03.2025		 Beam (DDF-Syntax) DMXC3
Arrow back.png Gobo
Shutter blades Arrow forw.png
Table of contents
Part 1: Basics
Part 2: Functions
Part 3: Procedures
Part 4: Examples

Focus, Frost, Iris, and Zoom are functions in the DDFs for DMXControl 3, which are assigned to the group Light beam and primarily affect the width of the light beam. The GUI provides a corresponding Control Panel for this purpose.

Focus

The focus function is particularly used for the motorized "sharp focusing" of gobos for moving heads and scanners and can be expanded to a resolution of 16 bits by inserting finedmxchannel="1".


Case Code example
Standard 
<focus dmxchannel="0">
  <range mindmx="255" maxdmx="0" minval="0" maxval="100" />
</focus>

Focus on DMX channel 1:

  • Linear adjustment of the focus from close (0%) at DMX value 255 to far (100%) at DMX value 0.
Attribute type mindmx maxdmx minval maxval
Description DMX value for close focus DMX value for far focus Close focus Far focus
Permissible attribute value linear 0 to 255 0 to 255 0 % to 100 % 0 % to 100 %
HAL standard 100 % 0 %

Frost

The frost filter can be used to soften a light beam. Some devices have a so-called linear frost filter, where the light beam can be increasingly softened. Other devices, on the other hand, only insert a disk with a frost filter into the light beam.


Case Code example
Linear frost filter 
<frost dmxchannel="0">
  <range mindmx="0" maxdmx="255" minval="0" maxval="100" />
</frost>

Frost on DMX channel 1:

  • Linear adjustment of the frost from no frost filter (0%) at DMX value 0 to fully inserted frost filter (100%) at DMX value 255.
Simple frost filter 
<frost dmxchannel="0">
  <step type="open" mindmx="0" maxdmx="127" />
  <range type="linear" mindmx="128" maxdmx="255" minval="100" maxval="100" />
</frost>

Frost on DMX channel 1:

  • No frost filter between DMX value 0 and 127.
  • Frost filter fully inserted at DMX value between 128 and 255.
Attribute type mindmx maxdmx minval maxval
Description DMX value for no frost filter DMX value for frost filter inserted No frost Frost inserted
Permissible attribute value open
 0 to 255 0 to 255
linear 0 to 255 0 to 255 0 % to 100 % 0 % to 100 %

Iris

With the iris, the size or projection range of the light beam can be varied. The iris works in lighting technology just like the iris in a camera. Unlike the zoom, the beam angle does not change with the opening and closing of the iris. With the iris almost closed, only a small portion of the light beam is allowed through the aperture.

The iris function can be expanded to a resolution of 16 bits by inserting finedmxchannel="1".


Case Code example
Standard 
<iris dmxchannel="0">
  <range type="linear" mindmx="0" maxdmx="128" minval="0" maxval="100" />
</iris>

Iris on DMX channel 1:

  • Linear opening of the iris from fully open (0%) at DMX value 0 to closed or iris fully retracted (100%) at DMX value 128.
Attribute type mindmx maxdmx minval maxval
Description DMX value for smallest aperture DMX value for largest aperture Smallest aperture (closed) Largest aperture (open)
Permissible attribute value linear 0 to 255 0 to 255 0 % to 100 % 0 % to 100 %
HAL standard 100 % 0 %

Zoom

The zoom function changes the beam angle / opening angle of the device's light beam. It should not be confused with the iris. The zoom function can be expanded to a resolution of 16 bits by inserting finedmxchannel="1".


Case Code example
Linear zoom 
<zoom dmxchannel="0" >
  <range mindmx="255" maxdmx="0" minval="14" maxval="30" />
</zoom>

Zoom on DMX channel 1:

  • Linear reduction of the light beam from 30° at DMX value 0 to 14° at DMX value 255.
Zoom in multiple fixed steps 
<zoom dmxchannel="0">
  <step val="15" mindmx="0" maxdmx="85" />
  <step val="20" mindmx="86" maxdmx="171" />
  <step val="25" mindmx="172" maxdmx="255" />
</zoom>

Zoom with three fixed opening angles on DMX channel 1:

  • Zoom angle of 15° at DMX value between 0 and 85.
  • Zoom angle of 20° at DMX value between 86 and 171.
  • Zoom angle of 25° at DMX value between 172 and 255.
Attribute type mindmx maxdmx minval maxval
Description DMX value for smallest opening angle DMX value for largest opening angle Smallest opening angle Largest opening angle
Permissible attribute value linear 0 to 255 0 to 255 0° to 90° 0° to 90°
Retrieved from "https://wiki-en.dmxcontrol-projects.org/index.php?title=Beam_(DDF-Syntax)_DMXC3&oldid=4171"