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 Page <page> |
Set the page of the selected station(s) to the given page number | The page number |
At ? |
Get the value of the selected object(s) | The current value of the selected object(s) |
<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 sign
+or-may appear before the value to specify an offset (or delta) from the current value. - An exclamation point
!may appear before the value to indicate that the current fade time should be ignored (the value is set immediately).
- A percentage from
<cue>- Any whole number from
0to99999 - May optionally contain decimal numbers from
.00to.99
- Any whole number from
<playback>- Any whole number from
1to32
- Any whole number from
<page>- Any page number from
1to99
- Any page number from
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, Fixtures, 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 |
| Fixtures | The fixture(s) intensity channel(s) are 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 |
| Stations | Changes the active page number of the station |
Setting Values With Timing
A playback fader’s Time parameter will cause the value of Channels, Fixtures, 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.
Setting 16-Bit Values
When working with channels that are patched as “16-Bit” values, the At command will intelligently calculate and place the MSB (most significant byte) into the upper channel and the LSB (least significant byte) into the lower channel. For example, if channels 1 and 2 are paired together to make a 16-Bit value and the command Channel 1+2 At 75 is executed, the actual value placed into channel 1 will be 117 (decimal) and channel 2 will be 255 (decimal). These two individual 8-Bit values result in a 16-Bit value of 49151 (decimal), which represents 75% of the full scale of a 16-Bit value. Luckily one does not need to manually do this math themselves. CueScript does this for you!
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”. Other special values set an indicator’s state to one of the other predefined categories as shown in the following table:
| Value | Indicator State |
|---|---|
0, OFF |
Off |
1 |
User 1 |
2 |
User 2 |
3 |
User 3 |
4 |
User 4 |
5 .. 95 |
Reserved |
96 |
Recorded |
97 |
Locked |
98 |
Mixed |
99 |
On (flashing disabled) |
100, ON, FL |
On |
When setting the indicator state of a button, a “temporary override” function can be invoked by including an exclamation point (!) before the indicator value. This temporary override sets the indicator only briefly to the new value and then automatically reverts back to the original value. The duration of the temporary indicator state is given by the current fade time given by the Time command. If no time is set, then the default override time of 1 second.
For example, the command Time 2.5; Button 1 At ! 3 sets the time to 2.5 seconds, then temporarily changes the indicator state of Button 1 to “User 3”. After 2.5 seconds, the indicator will return back to its normal state.
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.
Ignoring Timing
Normally, when setting the value of an object such as a Channel, Fixture, Group, or Playback, the currently active Time will be applied to the value change. If the value is preceded by an exclamation point (!), the fade time will be ignored, resulting in the value being set immediately without fading.
Changing Station Pages
Using the At Page command with stations will change the station’s active page.
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”.
Time 5 Button 3 At ! 4
Temporarily turns the indicator for Button 3 to the “User 4” state for 5 seconds.
Output 3 At 0
Turns output 3 off.
Station 1 At Page 7
Changes Station 1 to display Page 7.
Channel 1! FL@
Sets channel 1 to Full immediately, ignoring the current fade time.