If you need to specify an exact DMX value for a channel, as opposed to a percentage, you should prefix the value with a zero. i.e. ''<range> @ 0 value''

(:cellnr width=30%:)@@1 Thru 5 @ 100 @@
(:cell width=70%:)@@''Sets channels 1,2,3,4,5 to 100% (DMX value 255)''@@

(:cellnr width=30%:)@@1 Thru 5 @ 0100 @@
(:cell width=70%:)@@''Sets channels 1,2,3,4,5 to DMX value 100 (39%)''@@

'''''Tip!''''' You can alter the channel values of the most recently captured channels (tier 1) with the [[faders#grab | Grab Fader]]

With a [[Custom Input | second keyboard]] you do not need to open the keypad window at all. If it's not open and you start to enter a command it will pop up in a semi transparent box in the middle of the screen.

Attach:keypad4.gif"Display of command without the keypad window" | %center% '''Command entry without the keypad window'''

If you need to specify an exact DMX value for a channel, as opposed to a percentage, you should prefix the value with a zero ''<range> @ 0 value''

(:table border=0 width=80% align=center bgcolor=#eeeeee cellspacing=0 cellpadding=3px :)
(:cell width=30%:)@@1 Thru 5 @ 50 @@
(:cell width=70%:)@@''Sets channels 1,2,3,4,5 to 50% (DMX value 128)''@@
(:cellnr width=30%:)@@1 Thru 5 @ 050 @@
(:cell width=70%:)@@''Sets channels 1,2,3,4,5 to DMX value 50 (20%)''@@
(:tableend:)


The ''On'' key can be used as a shortcut to ''@ 100 Enter'', so simple entering a channel range and pressing ''On'' will set the range to 100%. Also the shortcut used by Strand desks of ''@ @'' can also be used instead of ''@ 100 Enter''

The command line is a simple way to setup a lighting state whilst plotting, or programming, scenes.

'''''Tip!''''' You can open and close the Keypad Window by pressing the ''Apple'' and ''K'' keys on you main keyboard.

If you are using a [[Custom Input | second keyboard]] rather than the on screen buttons you may wish to hide the on screen buttons to save screen space. You can do this by pressing the little grey arrow just above the keypad.

There are still a number of additional things [[ToDo/Command Line | ToDo]]. The current implementation allows you to use a [[Custom Input | second keyboard]] or on screen buttons.

* [[#clear|Correcting Mistakes]]

[[#clear]]
!!! Correcting Mistakes

If you make a mistake whilst entering a command, you can use the ''<-'' (backspace) key to delete the last key of the command, or you can press ''Clear'' to delete the entire command line.

* [[#open|Open the Keypad Window]]
* [[#enter|Entering a command]]
* [[#commands|Commands]]
** [[#ranges|Channel ranges]]
** [[#setting|Setting channel values]]
** [[#release|Releasing captured channels]]
** [[#solo|Soloing channels]]

[[#ranges]]

[[#setting]]
!!!! Setting channel values

To set a range of values to a channel you use the following format ''<range> @ value'' where value is a percentage. Once you have finished typing your command press the ''Enter'' key to execute it. The channels specified in the range will then set to your entered value.

The ''On'' key can be used as a shortcut to ''@ 100 Enter'', so simple entering a channel range and pressing ''On'' will set the range to 100%

Similarly the ''Off'' key can be used as a shortcut to ''@ 0 Enter''.

'''''IMPORTANT!''''' Once you have set a channel value via the command line it will be captured. That is no matter what value it previously had, even if greater than your specified value, it will be set. What's more any other changes made to the value, except via the command line, will have no effect on the output of the channel until it is released.

[[#release]]
!!!! Releasing captured channels

When a captured channel is released control of the channel is passed back to the application. Thus any value that the application has set for the channel (for instance via a direct fader value, or via a scene) will be output.

There is a 2 tier release mechanism built in. To release channels set in the last executed command line command simple press the ''Release'' button. Pressing ''Release'' a second time will release all channels that have been set via the command line.

'''''Tip!''''' To quickly release all channels press ''Release'' twice in quick succession.

In addition to the simple 2 tier release mechanism, you man release specific channels by entering a channel range and pressing release. This will not affect the 2 tier release, except in the event that you have released all the channels in the first tier. Then pressing ''Release'' will release all channels.

[[#solo]]
!!!! Soloing channels

When you solo a channel all other channels have their values set to 0. This can be useful if you want to see the output from just the one channel.

To solo a channel, or range of channels you simply enter the command to set a channel as [[#setting|above]] but instead of finishing the command with ''Enter'' you press ''Solo''.

As a shortcut to soloing a channel at full value you can simply enter a channel range followed by the ''Solo'' key.

To release the Soloed channels (and thus also all the zeroed channels) press the ''Solo'' key without entering a range.

'''''IMPORTANT!''''' The command will only accept button or key presses that will form a valid command. For example you will not be able to set a value for a channel that has not yet been [[Channel Configuration|configured]].

[[#commands]]
!!! Commands

!!!! Channel ranges

Nearly all commands affect a range of channels (the range can be as small as a single channel). A range is defined as ''<start channel> Thru <end channel>'', or in the case of a single channel simply ''<channel number''>. Example of simple ranges :

(:table border=0 width=80% align=center bgcolor=#eeeeee cellspacing=0 cellpadding=3px :)
(:cell width=50%:)@@4@@
(:cell width=50%:)@@''= 4''@@
(:cellnr width=50%:)@@1 Thru 5@@
(:cell width=50%:)@@''= 1,2,3,4,5''@@
(:cellnr width=50%:)@@7 Thru 9@@
(:cell width=50%:)@@''= 7,8,9''@@
(:tableend:)

By using the range modifier keys ''+'' and ''-'' you can combine ranges together by adding and subtracting them from each other, for example:

(:table border=0 width=80% align=center bgcolor=#eeeeee cellspacing=0 cellpadding=3px :)
(:cell width=50%:)@@1 Thru 5 + 7 Thru 9@@
(:cell width=50%:)@@''= 1,2,3,4,5,7,8,9''@@
(:cellnr width=50%:)@@1 Thru 9 - 6@@
(:cell width=50%:)@@''= 1,2,3,4,5,7,8,9''@@
(:cellnr width=50%:)@@1 Thru 20 - 5 Thru 10 - 15 + 30 @@
(:cell width=50%:)@@''= 1,2,3,4,11,12,13,14,16,17,18,19,20,30''@@
(:tableend:)

The command will only accept button or key presses that will form a valid command. For example you will not be able to set a value for a channel that has not yet been [[Channel Configuration|configured]].

[[#enter]]
!!! Entering a command

To enter a command simply press the onscreen buttons, or the mapped keys on the [[Custom Input | second keyboard]]. The currently entered command will be shown on the display.

Attach:keypad3.gif"In Progress Command" | %center% '''Entering a Command'''

The command will only accept button or key presses that will form a valid command. For example you will not be able to set a value for a channel that has not yet been [[Channel Configuration|configured].

The onscreen buttons are [[Keypad Mapping|mapped]] to keys on the main keyboard. Unlike using a [[Custom Input | second keyboard]] these will only work when the Keypad Window has focus, and the Keypad is not hidden.

The command line is a simple way setup a lighting state whilst plotting, or programming, scenes.

There are still a number of additional things [[ToDo/Commnad Line | ToDo]]. The current implementation allows you to use a [[Custom Input | second keyboard]] or on screen buttons.

[[#open]]
!!! Open the Keypad Window

To Open the Keypad Window select ''Keypad'' from the ''Window'' menu. The keypad has a display area at the top, to view the command that you are currently entering, and a set of on screen buttons below.

Attach:keypad1.gif"Full Keypad Window" | %center% '''Keypad Window'''

'''''Tip!''''' You can open and close the Keypad Window pre pressing the ''Apple'' and ''K'' keys on you main keyboard.

If you are using a [[Custom Input | second keyboard]] rather than the on screen buttons you may wish to hide the on screen buttons to save screen space. You can do this pre pressing the little grey arrow just above the keypad.

Attach:keypad2.gif"Display only Keypad Window" | %center% '''Display only Keypad Window'''

%center% <|[[OnlineManual | Contents]]|>

!! Command Line

%center% <|[[HomePage| Contents]]|>