2.1 The Command Line

The majority of user input into the Hog 4 Operating System is handled through the command line. Keystrokes and button presses accumulate on the Command Line Toolbar where users build executable commands such as recording a cue. In some cases command line entries are executed immediately but in most cases you must press Enter to confirm that the command is complete. To remove any unwanted keystrokes from the command line press the Backspace key once. To completely clear the command line double-press the Backspace key.

Figure 2.1. The Command Line

The command line

2.1.1 Command Line Syntax

The basic order and structure of the Hog 4 OS command line syntax is: Source, Mask, Command, Options, Destination.

  • Source: The source is the object within the show that you want to take data from. It might be a palette, scene, cue, or the editable editor. With most commands the source object is not modified.

  • Mask: The Mask is a filter for when you only want some of the data from that object. There are two types of mask: a fixture mask specifies only data for certain fixtures (for example Cyberlight 1); a kind mask specifies only data for certain kinds (for example Colour, Beam). If no mask is specified then the entire contents of the current active editor are included in the command.

  • Command: The Command is the operation you want to perform. Commands include Copy, Record, Delete, Move, Merge, Knockout. Some of these only need a source to be specified, others only need a destination, but they all have the same syntactical form.

  • Options: The behaviour of some commands (for example Record) can be altered with options. These usually appear on a popup toolbar once the command key is pressed.

  • Destination: The destination is the object that will be affected by the command. Again it might be a palette, cue, scene or the editable editor. If the destination already exists, and the action to take is unclear, then you will be asked what the console should do.

Some examples of command line syntax are shown below. Note that a final press of the Enter key is required to tell the console to the command is complete and ready to be executed.

Source

Mask

Command

Options

Destination

Comments

Record

Position 1

Records a position palette to location 1 in the position palette directory. No source is given, so the content of the current editor is assumed.

Record

Replace

Position 1

The Replace option (on the Record Options Toolbar) ensures that the new palette replaces the previously recorded palette.

Position1

Copy

Position 2

The Copy command takes the Position 1 palette as its source.

Position 1

Copy

Replace

Position 2

This example combines using a source and a record option.

Group 2

Record

Position 3

Here Group 2 acts as a mask for the record command, so that only fixtures in Group 2 are recorded into the Position 3 palette.

Cue 1Group 3

Position

Copy

Cue 5

Here the parameter values of fixtures in Group 3 are copied from Cue 1 to Cue 5. The Position option applied to the copy command means that only position parameters are included.

[Tip]Tip

The text of the command line turns red if your syntax is not valid.

2.1.2 The Status Bar

To the right of the command line is the Status Bar.

Figure 2.2. The Status Bar

The status bar; a fragment of the command line toolbar.

The Status Bar gives you basic information about the status of the console as well as connected network items.

Below is a list of the different kinds of data the status toolbar can show:

Description

Example

The Trackball mode

--- (pointer)

POS (position)

POS, ortho (ortho mode)

The name of the current page

Page 1

Current Mode of the Function Keys

CMD (command key mode)

KIND (kind key mode)

The current editor

Programmer

Cue 3

The currently chosen master

Master 4

The network status

Network OK The network is working normally.

Syncing Consoles are syncing show data.

Syncing Connected DP8000's need a software upgrade.

Network fault There is a problem with the network.

The current time in hours and minutes.

16:28