The At command and several other commands set levels. Levels are an expression of a quantity from lowest possible value (zero) to highest possible value (full). CueServer allows levels to be expressed in four primary ways, by percentage (the default), or by decimal, hexadecimal or binary notation.
Percentage
By default, when setting DMX channel values, levels are specified by percentage numbers (0, 1, 2, … 98, 99, 100).
For example, to turn a channel completely off, the command Channel 1 At 0 may be used. To turn a channel completely on, the command Channel 1 At 100 may be used. Any percentage number in-between 0 and 100 can set a channel to the corresponding level.
For convenience, a percent sign () may be added to the number for clarity. For instance, Channel 1 At 50%. Using the percent sign is optional. Also for convenience, when specifying a level of 100, either a value of 100 can be entered or FL can be used (meaning “Full”).
If the value of a 16-bit channel is being set, the percentage values from 0 to 100 are still used, and CueScript will set the value of the channel appropriately.
Decimal
In some instances, it may be appropriate to use decimal numbers to set DMX channel values (such as when setting levels for moving lights, matching colors or adjusting a level more precisely than percentage levels allow).
Decimal numbers use values from 0 to 255 to specify the range from zero to full, unless you are specifically setting the value of a 16-bit channel where the range of values is from 0 to 65535.
To use decimal numbers while specifying levels, use a pound sign before the level. For example, Channel 1 At #253.
Decimal numbers may be used in arrays, such as Group 1 At {#255, #192, #134}.
Hexadecimal
In some instances, it may be appropriate to use hexadecimal numbers to set DMX channel values (such as when setting levels for moving lights, matching colors or adjusting a level more precisely than percentage levels allow).
Hexadecimal numbers use digits 0 through 9 and A through F and values from 00 to FF to specify the complete range from zero to full, unless you are specifically setting the value of a 16-bit channel where the range of values is from 0000 to FFFF.
To use hexadecimal numbers while specifying levels, use a dollar sign before the level. For example, Channel 1 At $A5.
Hexadecimal numbers may be used in arrays, such as Group 1 At {$FF, $C0, $86}. Note that when specifying hexadecimal numbers to CueServer, always use 2 digits. For example, use $00, $01, $02, not $0, $1, $2, for the single-digit hexadecimal values.
Binary (On/Off)
Some devices being controlled by CueServer only have two states, on and off. In order to simplify their operation, the CueScript language has two extra values named On and Off. These are used as a convenience to mean the same as At 0 and At 100.
Any place that a percentage value can be used in a command, the On and Off keywords can be used instead. For example, Channel 1 On, Button 2 Off, Group 3 On, Output * On are all valid binary-value commands.