Effectwheel (DDF-Syntax) DMXC3

From English DMXC-Wiki
Revision as of 00:12, 7 February 2024 by Jkuehn (talk | contribs) (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...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Books.png Effectwheel (DDF-Syntax) DMXC3 Article describes
DMXControl 3.2.0
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

Variant Code
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 range mindmx maxdmx caption val
Description Minimum DMX value for the corresponding prism Maximum DMX value for the corresponding prism Description of the prism Filename of the prism icon
Allowed Attribute Value open
prism
0 to 255 0 to 255 Text *.png files
Optional X


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

Variant Code
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 to 360° 0 to 255 0 to 255 to 360° to 360°

Prism Rotation

Variant Code
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.
Variant Code
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