Syntax
| Command | Description | Return Value |
|---|---|---|
Preset <preset number> On |
Activates the specified preset in the current zone | The preset number activated |
Preset <preset number> Off |
Deactivates the specified preset in the current zone | The preset number deactivated |
Preset <preset number> At <value> |
Activates the specified preset in the current zone at the given intensity level | The preset number activated |
Preset <preset number> Toggle <value> |
Activates or deactivates the specified preset in the current zone at the given intensity level | The preset number toggled |
<preset number>- Any whole number from
1to999
- Any whole number from
<value>- A percentage from
0to100. When specifying percentages, the value can optionally be followed by the%sign. - A decimal number from
#0to#255. When specifying decimal numbers, the value must be proceeded with a#sign. - A hexadecimal number from
$00to$FF. When specifying hexadecimal numbers, the value must be proceeded with a$sign. FL(Full) orOncan be used as a shortcut that means100%Offcan be used as a shortcut that means0%
- A percentage from
Abbreviation
PR
Description
Use the Preset command to operate on presets within the current zone. Presets can be activated, deactivated, toggled and/or set to a desired intensity level.
Normally, Presets only operate within their Zone. See the Zone command to see how to manage Zones. In certain applications, it is useful to be able to join multiple zones together (such as in a Ballroom with removable “air walls”). See the Join command to learn how to join Zones together.
Activating Presets
To activate a preset, use the Preset n On command. For example, to activate Preset 3, use this command:
Preset 3 On
The stored look in Preset 3 will appear in the current zone.
Any time a preset is activated in a particular zone, any other preset in that zone is automatically deactivated. The only exception to this rule is when more than one preset contains the same channel values. If more than one preset share the same channel values, they will all become activated.
Deactivating a Preset
If a preset needs to be deactivated without activating another, the Off action can be used:
Preset 3 Off
If a zone contains one or more presets that are recorded with all zero channel levels, those presets will become active when other presets are deactivated.
Setting a Preset’s Intensity Level
If a Preset needs to be recalled, but at a lower intensity level than recorded, the Preset n At value command can be used:
Preset 3 At 33
In this example Preset 3 is activated, but the channel levels are scaled down to 33% of the original levels recorded in the Preset.
The value used to scale the preset can be given in percentage, decimal, or hexadecimal, similarly to the At command.
Toggling Presets
To cause a preset to toggle on and off, use the Preset n Toggle value command. For example:
Preset 3 Toggle On
Each time the Toggle action is used, the preset will turn on or off. The new state will be the opposite of the previous state.
The Toggle action can also be used with values other than “On”. For example, to toggle a preset between “Off” and “75%”, use this command:
Preset 3 Toggle 75
Examples
Preset 5 On
Activates Preset 5 in the current zone.
Zone "Foyer" Preset 3 On
Activates Preset 3 in the Zone “Foyer”.
Preset 1 Toggle On
Activates or deactivates Preset 1 depending on Preset 1’s previous state.
Preset 7 Off
Deactivates Preset 7 in the current zone.

