Syntax

Command Description Return Value
At <value> Set the value of the selected object(s) The value the object(s) were set to
At Cue <cue> Sets the selected channels to the values in Cue cue The number of channels set
At Playback <playback> Sets the selected channels to the values in Playback playback The number of channels set
At Input Sets the selected channels to the values currently coming from the DMX input The number of channels set
At Output Sets the selected channels to the values currently being sent to the DMX output The number of channels set
At [+/-]<value> Set the value of the selected object(s) to an offset (or delta) from the object(s) current value The value the object(s) were set to
At ? Get the value of the selected object(s) The current value of the selected object(s)
  • <value>
    • A percentage from 0 to 100. When specifying percentages, the value can optionally be followed by the % sign.
    • A decimal number from #0 to #255. When specifying decimal numbers, the value must be proceeded with a # sign.
    • A hexadecimal number from $00 to $FF. When specifying hexadecimal numbers, the value must be proceeded with a $ sign.
    • FL (Full) or On can be used as a shortcut that means 100%
    • Off can be used as a shortcut that means 0%
    • A sign + or - may appear before the value to specify an offset (or delta) from the current value.
  • <cue>
    • Any whole number from 0 to 99999
    • May optionally contain decimal numbers from .00 to .99
  • <playback>
    • Any whole number from 1 to 32

Abbreviation

A or @

Description

Setting Values

The At command sets the currently selected object(s) values. The At command can be used with many types of objects, including Buttons, Channels, Groups, Outputs, Playbacks, and Presets.

The following table shows how the At command affects each of these object types:

Object Result Of At Command
Buttons Turns the button(s) indicator on or off or sets it to a special user value
Channels The channel(s) are set to the specified value
Groups The channels in the group are set to the specified value
Outputs Turns the output(s) on or off
Playbacks The playback(s) submasters are set to the specified value
Presets The preset is activated with an intensity of the the specified value

Setting Values With Timing

A playback fader’s Time parameter will cause the value of Channels, Groups and Playbacks to fade to the desired value. A time of 0 (zero) causes the value to be set immediately. Any non-zero time will cause the value to gradually change at a speed that will cause it to reach the desired value in the number of seconds set by the Time command.


Recalling Values From A Cue

Using the At Cue command allows the data from a given Cue to be used to set the currently selected channel values (instead of specifying a single fixed value). This is useful to only recall parts of a Cue without affecting other channels.


Recalling Values From A Playback

Using the At Playback command allows the channels from a given Playback to be used to set the currently selected channel values (instead of specifying a single fixed value). This is useful to copy components of a scene from one playback fader to another.


Pulling Values From the DMX Input

Using the At Input command allows the channels from the DMX Input to be used to set the currently selected channel values (instead of specifying a single fixed value). This is useful to copy (or snapshot) the DMX Input into a playback fader.


Pulling Values From the DMX Output

Using the At Output command allows the channels from the DMX Output to be used to set the currently selected channel values (instead of specifying a single fixed value). This is useful to copy (or snapshot) the DMX Output into a playback fader.


Using Delta Values

Using the At +/- command allows channels to be set to an offset (or delta) from their current value(s). This is useful if the current channel value is not known and an offset value need to be added or subtracted from the current value. For example, an offset can be used to bump a channel value up or down using commands such as Channel 1 At +5 or Group 7 At -25.


Setting Indicators

Using the At command with buttons will turn a button’s LED indicator on or off. Use At 0 or OFF to turn an indicator off. Use At FL, At 100 or ON to turn an indicator on. Values of 1, 2, 3, and 4 will set an indicator to one of the “user colors”.


Setting Outputs

Using the At command with outputs will turn an output on or off. Use At 0 or OFF to turn an output off. Use At FL, At 100 or ON to turn an output on.


Examples

Channel 1 At 33
Sets the value of channel 1 to 33%.

Channel 1>3+5>8 On
Sets channels 1 through 3 and 5 through 8 to 100%.

Channel 1>10
Time 5
At FL
Selects channels 1 through 10, then changes the fade time to 5 seconds, then begins fading the channels to 100% (Full).

Group 5 On
Sets the channels in group 5 to 100%.

Channel 100>200 At Cue 44
Sets channels 100 through 200 to the channel levels recorded in Cue 44.

Group 7 At Playback 8
Sets the channels in Group 7 to the channel levels currently in Playback 8.

Channel 1>10 At +15
Increases the value of Channels 1 thru 10 by 15%.

Preset 1 At 33
Activates preset 1 with intensity level 33%.

Button 1 At FL
Turns the indicator for button 1 on.

Button 2 At 3
Turns the indicator for button 2 to the color specified as “User 3”.

Output 3 At 0
Turns output 3 off.

See Also