Effectwheel (DDF-Syntax) DMXC3: Difference between revisions

From English DMXC-Wiki
(Created page with "{{Chaptertitle|Version=DMXControl 3.2.0}} {{DMXC3_Manual-Navigation_DDF |backLink = Blades_(DDF-Syntax)_DMXC3 |backText = Shutter Blades |forwardLink = Stage_Effect_(DDF-Synt...")
 
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{Chaptertitle|Version=DMXControl 3.2.0}}
{{Manual Header
 
| Type = DMXC3 DDFs
{{DMXC3_Manual-Navigation_DDF
| Version = 3.2.0
|backLink = Blades_(DDF-Syntax)_DMXC3
| LinkBackwards = Blades (DDF-Syntax) DMXC3
|backText = Shutter Blades
| TextBackwards = Shutter Blades
|forwardLink = Stage_Effect_(DDF-Syntax)_DMXC3
| LinkForwards = Stage Effect (DDF-Syntax) DMXC3
|forwardText = Stage Effect
| TextForwards = Stage Effect
}}
}}


Line 14: Line 14:


== Basic Functions ==
== Basic Functions ==
{| 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">
<prism dmxchannel="0">
<prism dmxchannel="0">
   <step type="open" mindmx="0" maxdmx="63" caption="Open" />
   <step type="open" mindmx="0" maxdmx="63" caption="Open" />
Line 33: Line 30:
* Radial 8-facets prism at DMX value between 192 and 255.
* Radial 8-facets prism at DMX value between 192 and 255.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | step-val}}
! style="vertical-align:top" | Description
|
| Filename of the prism icon
| Minimum DMX value for the corresponding prism
| Maximum DMX value for the corresponding prism
| Description of the prism
|-
|-
! Attribute !! range !! mindmx !! maxdmx !! caption !! val
! Required information
| {{Yes}} || {{No}} || {{Yes}} || {{Yes}} || {{Yes}}
|-
|-
! style="width: 200px; vertical-align:top" | Description
! style="vertical-align:top" | Allowed attribute value
| style="width: 175px" |
| style="width: 175px" | Minimum DMX value for the corresponding prism
| style="width: 175px" | Maximum DMX value for the corresponding prism
| style="width: 175px" | Description of the prism
| style="width: 175px" | Filename of the prism icon
|-
! style="vertical-align:top" | Allowed Attribute Value
| <code>open</code><br /> <code>prism</code>
| <code>open</code><br /> <code>prism</code>
| <code>*.png files</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>
| <code>Text</code>
| <code>Text</code>
| <code>*.png files</code>
|-
! style="vertical-align:top" | Optional
| || || || || style="text-align:center" | X
|}
|}


Line 67: Line 61:


=== Prism Indexing ===
=== Prism Indexing ===
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en}}
|-
| Separate DMX channel for prism indexing
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Separate DMX channel for prism indexing
| style="width: 1000px" | <syntaxhighlight lang="xml">
<prism dmxchannel="0">
<prism dmxchannel="0">
   <prismindex dmxchannel="1">
   <prismindex dmxchannel="1">
Line 103: Line 94:
* Base position of the prism at a DMX value between 120 and 255.
* Base position of the prism at a DMX value between 120 and 255.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | range-range}}
|-
! style="vertical-align:top" | Description
! Attribute !! range !! mindmx !! maxdmx !! minval !! maxval
| Maximum rotation angle for prism indexing
|-
| DMX value for the start position
! style="width: 200px; vertical-align:top" | Description
| DMX value for the end position
| style="width: 175px" |
| Start position of the prism indexing
| style="width: 175px" | Maximum rotation angle for prism indexing
| End position of the prism indexing
| style="width: 175px" | DMX value for the start position
| style="width: 175px" | DMX value for the end position
| style="width: 175px" | Start position of the prism indexing
| style="width: 175px" | End position of the prism indexing
|-
|-
! style="vertical-align:top" | Allowed Attribute Value
! style="vertical-align:top" | Allowed attribute value
| <code>0°</code> to <code>360°</code>
| <code>0°</code> to <code>360°</code>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code
| <code>0</code> to <code>255</code>
 
>255</code>
| <code>0°</code> to <code>360°</code>
| <code>0°</code> to <code>360°</code>
| <code>0°</code> to <code>360°</code>
| <code>0°</code> to <code>360°</code>
Line 126: Line 111:


=== Prism Rotation ===
=== Prism Rotation ===
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en}}
|-
| Separate DMX channel for prism rotation
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Separate DMX channel for prism rotation
| style="width: 1000px" | <syntaxhighlight lang="xml">
<prism dmxchannel="0">
<prism dmxchannel="0">
   <prismrotation dmxchannel="1">
   <prismrotation dmxchannel="1">
Line 167: Line 149:
* Prism rotating clockwise at 0.1 1/s at DMX value 192, accelerating up to 3 1/s at DMX value 255.
* Prism rotating clockwise at 0.1 1/s at DMX value 192, accelerating up to 3 1/s at DMX value 255.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | range-handler}}
|-
! Attribute !! handler !! mindmx !! maxdmx !! minval !! maxval
|-
|-
! style="width: 200px; vertical-align:top" | Description
! style="vertical-align:top" | Description
| style="width: 175px" |
|
| style="width: 175px" | DMX value for the minimum rotation speed of the prism
| DMX value for the minimum rotation speed of the prism
| style="width: 175px" | DMX value for the maximum rotation speed of the prism
| DMX value for the maximum rotation speed of the prism
| style="width: 175px" | Minimum rotation speed of the prism
| Minimum rotation speed of the prism
| style="width: 175px" | Maximum rotation speed of the prism
| Maximum rotation speed of the prism
|-
|-
! style="vertical-align:top" | Allowed Attribute Value
! style="vertical-align:top" | Allowed attribute value
| <code>prismrotation</code>
| <code>prismrotation</code>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
Line 191: Line 171:
{{Manual Box | en | Hint | For compatibility reasons, it is recommended to represent prism and frost separately using their standalone functions. }}
{{Manual Box | en | Hint | For compatibility reasons, it is recommended to represent prism and frost separately using their standalone functions. }}


{| 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">
<effectwheel dmxchannel="0">
<effectwheel dmxchannel="0">
   <step type="open" mindmx="0" maxdmx="31" caption="Open" />
   <step type="open" mindmx="0" maxdmx="31" caption="Open" />
Line 213: Line 190:
* Activation of Macros 1 to 4 between DMX value 96 and 127.
* Activation of Macros 1 to 4 between DMX value 96 and 127.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | en | step-generic}}
|-
! style="vertical-align:top" | Description
! Attribute !! type !! mindmx !! maxdmx
|
|-
| Minimum DMX value for activating the function
! style="width: 200px; vertical-align:top" | Description
| Maximum DMX value for activating the function
| style="width: 175px" |
| style="width: 175px" | Minimum DMX value for activating the function
| style="width: 175px" | Maximum DMX value for activating the function
|-
|-
! style="vertical-align:top" | Allowed Attribute Value
! style="vertical-align:top" | Allowed attribute value
| <code>open</code><br /> <code>prism</code><br /> <code>frost</code><br /> <code>macro</code>
| <code>open</code><br /> <code>prism</code><br /> <code>frost</code><br /> <code>macro</code>
| <code>0</code> to <code>255</code>
| <code>0</code> to <code>255</code>
Line 228: Line 202:
|}
|}


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

Latest revision as of 14:38, 2 March 2025

Blockdevice.png Article describe
DMXControl 3.2.0
Stand: 02.03.2025		 Effectwheel (DDF-Syntax) DMXC3
Arrow back.png Shutter Blades
Stage Effect Arrow forw.png
Table of contents
Part 1: Basics
Part 2: Functions
Part 3: Procedures
Part 4: Examples

The Prism divides the light beam into additional beams depending on its design. Control of the prism and its functions in DMXControl 3 is exclusively through the Device Control.

Prism

A prism divides the light beam multiple times. This function is commonly found in moving heads and scanners in various configurations, ranging from a simple static prism to multiple prisms with different numbers of facets that can rotate and be positioned.

Basic Functions

Case Code example
Standard 
<prism dmxchannel="0">
  <step type="open" mindmx="0" maxdmx="63" caption="Open" />
  <step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" val="3-facets radial.png" />
  <step type="prism" mindmx="128" maxdmx="191" caption="6-facets linear prism" val="6-facets linear.png" />
  <step type="prism" mindmx="192" maxdmx="255" caption="8-facets radial prism" val="8-facets radial.png" />
</prism>

Prism on DMX channel 1:

  • No prism at DMX value between 0 and 63.
  • 3-facets radial prism at DMX value between 64 and 127.
  • Linear 6-facets prism at DMX value between 128 and 191.
  • Radial 8-facets prism at DMX value between 192 and 255.
Attribute type val mindmx maxdmx caption
Description Filename of the prism icon Minimum DMX value for the corresponding prism Maximum DMX value for the corresponding prism Description of the prism
Required information Yes Yes No No Yes Yes Yes Yes Yes Yes
Allowed attribute value open
prism 		*.png files 0 to 255 0 to 255 Text


Important Hint The associated files for the optional icons of the prisms must be stored in the same directory as the icons for the gobos.

Additional Functions

For individual functions of the prism channel, the following additional functions are possible:

  • prismindex: Positioning of the prism at any angle.
  • prismrotation: Continuous rotation of the prism in various directions.

These additional functions can be accessed in two different ways:

  • For controlling the additional functions, one or more separate DMX channels are used.
  • The additional functions are on the same DMX channel as the prism itself.

Prism Indexing

Case Code example
Separate DMX channel for prism indexing 
<prism dmxchannel="0">
  <prismindex dmxchannel="1">
    <range range="360" mindmx="0" maxdmx="127" minval="0" maxval="360" />
  </prismindex>
  <step type="open" mindmx="0" maxdmx="63" caption="Open" />
  <step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
  ...
</prism>

Prism on DMX channel 1, prism indexing on DMX channel 2:

  • No prism at DMX value between 0 and 63 on DMX channel 1.
  • Static 3-facets prism at DMX value between 64 and 127 on DMX channel 1.
  • Indexing / positioning of the inserted prism at any angle between 0° and 360° at a DMX value between 0 and 127.
Prism indexing on the same DMX channel 
<prism dmxchannel="0">
  <prismindex />
  <step type="open" mindmx="0" maxdmx="31" caption="Open" />
  <step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
    <range range="360" handler="prismindex" mindmx="32" maxdmx="119" minval="0" maxval="360" />
  </step>
  …
</prism>

Prism with prism indexing on DMX channel 1:

  • No prism at DMX value between 0 and 31.
  • Positioning of the 3-facets prism at any angle between 0° at DMX value 32 and 360° at DMX value 119.
  • Base position of the prism at a DMX value between 120 and 255.
Attribute range mindmx maxdmx minval maxval
Description Maximum rotation angle for prism indexing DMX value for the start position DMX value for the end position Start position of the prism indexing End position of the prism indexing
Allowed attribute value 0° to 360° 0 to 255 0 to 255 0° to 360° 0° to 360°

Prism Rotation

Case Code example
Separate DMX channel for prism rotation 
<prism dmxchannel="0">
  <prismrotation dmxchannel="1">
    <step type="stop" mindmx="191" maxdmx="192" />
    <range type="cw" mindmx="193" maxdmx="255" minval="0.1" maxval="3.0" />
    <range type="ccw" mindmx="190" maxdmx="128" minval="0.1" maxval="3.0" />
  </prismrotation>
  <step type="open" mindmx="0" maxdmx="63" caption="Open" />
  <step type="prism" mindmx="64" maxdmx="127" caption="3-facets radial prism" />
  ...
</prism>

Prism on DMX channel 1, prism rotation on DMX channel 2:

  • Prism static at DMX value between 191 and 192.
  • Prism rotating clockwise at 0.1 1/s at DMX value 193, accelerating up to 3 1/s at DMX value 255.
  • Prism rotating counterclockwise at 3 1/s at DMX value 128, decelerating to 0.1 1/s at DMX value 190.
Prism rotation on the same DMX channel 
<prism dmxchannel="0">
  <prismrotation />
  <step type="open" mindmx="0" maxdmx="31" caption="Open" />
  <step type="prism" mindmx="32" maxdmx="255" caption="3-facets radial prism">
    <step type="stop" handler="prismrotation" mindmx="120" maxdmx="127" />
    <range type="ccw" handler="prismrotation" mindmx="191" maxdmx="128" minval="0.1" maxval="3" />
    <range type="cw" handler="prismrotation" mindmx="192" maxdmx="255" minval="0.1" maxval="3" />
   </step>
  …
</prism>

Prism with prism rotation on DMX channel 1:

  • No prism at DMX value between 0 and 31.
  • 3-facets prism at DMX value between 32 and 127, static.
  • Prism rotating counterclockwise at 3 1/s at DMX value 128, decelerating to 0.1 1/s at DMX value 191.
  • Prism rotating clockwise at 0.1 1/s at DMX value 192, accelerating up to 3 1/s at DMX value 255.
Attribute handler mindmx maxdmx minval maxval
Description DMX value for the minimum rotation speed of the prism DMX value for the maximum rotation speed of the prism Minimum rotation speed of the prism Maximum rotation speed of the prism
Allowed attribute value prismrotation 0 to 255 0 to 255 0.05 1/s to 5 1/s 0.05 1/s to 5 1/s

Effect Wheel

The effect wheel combines several different effects on one wheel. These include various prisms, frost filters, or color correction filters that can be combined on a single effect wheel.


Important Hint For compatibility reasons, it is recommended to represent prism and frost separately using their standalone functions.


Case Code example
Standard 
<effectwheel dmxchannel="0">
  <step type="open" mindmx="0" maxdmx="31" caption="Open" />
  <step type="prism" mindmx="32" maxdmx="63" caption="3-facets prism" />
  <step type="frost" mindmx="64" maxdmx="95" caption="Frost" />
  <step type="macro" mindmx="96" maxdmx="103" caption="Macro 1" />
  <step type="macro" mindmx="104" maxdmx="111" caption="Macro 2" />
  <step type="macro" mindmx="112" maxdmx="119" caption="Macro 3" />
  <step type="macro" mindmx="120" maxdmx="127" caption="Macro 4" />
</effectwheel>

Effect wheel on DMX channel 1:

  • Effect wheel open between DMX value 0 and 31.
  • 3-facets prism inserted between DMX value 32 and 63.
  • Frost filter inserted between DMX value 64 and 95.
  • Activation of Macros 1 to 4 between DMX value 96 and 127.
Attribute type mindmx maxdmx
Description Minimum DMX value for activating the function Maximum DMX value for activating the function
Allowed attribute value open
prism
frost
macro 		0 to 255 0 to 255
Retrieved from "https://wiki-en.dmxcontrol-projects.org/index.php?title=Effectwheel_(DDF-Syntax)_DMXC3&oldid=4160"