	Beam (DDF-Syntax) DMXC3	Article describes DMXControl 3.2.1

Table of Contents

Part 1: Basics
General introduction	Basic structure	Basic rules

Part 2: Functions
Intensity Position Color Matrix	Radix Gobo Lens Blade Shifter	Effect wheel Stage effects Free Functions

Part 3: Procedures
Functions	Examples

Part 4: Examples
LED Spotlight	4-Light Bar	Moving Head

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`
Permissible attribute value	`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°`