The At command and several other methods 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”).


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.

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.

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 0% and 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.