ROVER - COMBINED RASTER AND VECTOR DISPLAY PROGRAM

MODULE ROVER

Combined Raster and Vector Display Program

Issue 3.0 - 16-March-1989
Copyright (C) 1987  Laser-Scan Ltd
Science Park, Milton Road, Cambridge, England CB4 4FY  tel: (0223) 420414
Document "ROVER Reference"   Category "REFERENCE"
Document Issue 3.0 M W S Reid  16-March-1989
Document Issue 2.1 M W S Reid  23-March-1988
Document Issue 2.0 M W S Reid  28-January-1988
Document Issue 1.3 M W S Reid  13-January-1987
Document Issue 1.2 M W S Reid  21-November-1986
Document Issue 1.1  D R Catlow  24-September-1986
Document Issue 1.0 D R Catlow  20-August-1986


--------------------------------------------------------------------------------
MODULE ROVER

--------------------------------------------------------------------------------

FUNCTION

--------------------------------------------------------------------------------

FORMAT

--------------------------------------------------------------------------------

PROMPTS

--------------------------------------------------------------------------------

DESCRIPTION

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

--------------------------------------------------------------------------------

ROVER COMMANDS

_! COMMAND

--------------------------------------------------------------------------------
_!

--------------------------------------------------------------------------------
FORMAT: _! [comment text]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An exclamation mark is the standard TVES package comment delimiter. All text (and numbers) which lie to the right of a '!' character are excluded from command interpretation. Comments are useful for annotating command procedures used in batch processing etc.

--------------------------------------------------------------------------------
Messages: None

--------------------------------------------------------------------------------
Examples:


Rover> FILEIN TEST !open the file<CR>
Rover> !Define a window<CR>
Rover> WINDOW 1 1 10 10<CR>
Rover>

_@ COMMAND

--------------------------------------------------------------------------------
_@

--------------------------------------------------------------------------------
FORMAT: _@file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The _@ command is used to specify that further commands are to be read from the supplied Rover Command File (RCM). Input is taken from the command file until the end of file is reached.

The RCM file may contain RESPOND commands which return temporary control to the terminal. The CONTINUE command issued at the terminal resumes RCM file execution.

Only one RCM file may be open at a time and command file execution may be abandoned using (pressing the Ctrl and C keys together).

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the @ command


*** ERROR *** Specifying command @
Command invalid while command file already open


*** ERROR *** Specifying command @
Command File name missing

--------------------------------------------------------------------------------
Examples:


Rover> ^@DTI_ERRORS.RCM<CR>
Reading input from command file LSL$ROVERCMD:DTI_ERRORS.RCM
Rover>

ABANDON

--------------------------------------------------------------------------------
ABANDON

--------------------------------------------------------------------------------

FORMAT:		ABANDON

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

In the DIGITISE mode the ABANDON command abandons the construction of a feature.

In EDIT mode ABANDON cancels the current raster editing sequence.

The command is only available in EDIT or DIGITISE modes of operation. ABANDON is defined as puck button F. In EDIT mode typing (pressing the Ctrl and Z keys together) also produces the effect of an ABANDON command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ABANDON command.


*** ERROR *** Specifying command ABANDON
Command only available in EDIT or DIGITISE modes

--------------------------------------------------------------------------------
Examples:


Rover> ENABLE EDIT
Edit> MOVE 10 10
Edit> EDIT
Line> MOVE 20 20
Line> ABANDON
Edit>


Rover> ENABLE DIGITISE
Digitise> START
Digitise Point> ABANDON
Digitise>

AREA_EDIT

--------------------------------------------------------------------------------
AREA_EDIT

--------------------------------------------------------------------------------

FORMAT:		AREA_EDIT

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The AREA_EDIT command starts an area editing operation.

A subsequent sequence of EDIT and MOVE commands are used to define the perimeter of the area to be edited. The END command completes the operation and the specified DTI value is assigned to pixels which lie within the area.

The command is only available in EDIT mode of operation.

To indicate that area editing is taking place the program prompt becomes 'Area>' while the area is being defined.

ABANDON or (pressing the Ctrl and Z keys together) may be used to abort an AREA editing operation.

Puck button C is defined to be AREA_EDIT.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the AREA_EDIT command.


*** ERROR *** specifying command AREA_EDIT
Command only available in EDIT mode


*** ERROR *** specifying command AREA_EDIT
Selected DTI file is opened read-only


*** ERROR *** specifying command AREA_EDIT
Command not available during edit operation

--------------------------------------------------------------------------------
Examples:

Edit>AREA_EDIT
Area>MOVE 50 50
Area>EDIT
Area>MOVE 50 100
Area>EDIT
Area>MOVE 100 100
Area>EDIT
Area>MOVE 100 50
Area>END
Area> DTI Value> 500
Edit>

CENTRE

--------------------------------------------------------------------------------
CENTRE

--------------------------------------------------------------------------------

FORMAT:		CENTRE  xcoord, ycoord 

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The displayed image is centred around the screen position corresponding to the supplied matrix x y coordinate point provided they lie within the geographical bounds of the file.

If a source document has been registered to the current DTI using the SETUP MAP command, CENTRE may be given using Puck Button 1.

This command has effect only on a graphics device which supports hardware pixel replication.

--------------------------------------------------------------------------------
Messages:


The following message are specific to the CENTRE command.


*** ERROR *** specifying command CENTRE
Command requires 2 integer arguments

--------------------------------------------------------------------------------
Examples:

Rover>CENTRE 100 100
Rover>

CLEAR

--------------------------------------------------------------------------------
CLEAR

--------------------------------------------------------------------------------

FORMAT:		CLEAR 

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command, when issued with no qualifiers, clears the entire screen of both raster and vector information.

In EDIT mode the effect of clearing results in movement of the pixel cursor in the previously displayed area "repainting" the image. It is therefore recommended that a DISPLAY command should be issued before the cursor is moved.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLEAR command.


*** ERROR *** specifying command CLEAR
Command not available during edit operation


*** ERROR *** specifying command CLEAR
CLEAR qualifier is QUADRANT, PICTURE or LABEL

--------------------------------------------------------------------------------
Example:

Rover>CLEAR
Rover>

CLEAR LABEL

--------------------------------------------------------------------------------
CLEAR LABEL

--------------------------------------------------------------------------------

FORMAT:		CLEAR LABEL

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

User annotation which has been specified with the DRAW LABEL command is cleared from the screen.

Note that because annotation is held in picture 2, any overlaid vector information is also cleared using this command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLEAR command.


*** ERROR *** specifying command CLEAR
CLEAR qualifier is QUADRANT, PICTURE or LABEL


*** ERROR *** specifying command CLEAR
Command not available during edit operation

--------------------------------------------------------------------------------
Example:

Rover>CLEAR LABEL
Rover>

CLEAR PICTURE

--------------------------------------------------------------------------------
CLEAR PICTURE

--------------------------------------------------------------------------------

FORMAT:		CLEAR PICTURE picture-number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CLEAR PICTURE command is used to clear either picture 1 or picture 2.

The number of bit-planes allocated to picture 1 and picture 2 is determined using the PLANES command. By default 5 planes (bit-planes 1 to 5) are used for Picture 1, and the remaining 3 planes (bit-planes 6 to 8) are used for Picture 2. A raster DTI image is drawn into Picture 1, while any vector overlay information or annotation drawn using the OVERLAY and DRAW LABEL commands, is displayed in Picture 2.
A raster image may therefore be cleared independently of any overlay using the command CLEAR PICTURE 1, while any overlay may be cleared independently from the raster base using the command CLEAR PICTURE 2. To clear both pictures (ie. all bit-planes of a graphics display), the command CLEAR should be used.

The CLEAR PICTURE command erases the information held in the memory of the graphics device and hence further DISPLAY or OVERLAY commands are required to reproduce an image on the screen. Note that ENABLE/DISABLE PICTURE commands allow instantaneous selection and deselection of raster and vector information already produced with the DISPLAY or OVERLAY commands.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLEAR and CLEAR PICTURE commands.


*** ERROR *** specifying command CLEAR
Command not available during edit operation


*** ERROR *** specifying command CLEAR
CLEAR qualifier is QUADRANT, PICTURE or LABEL


*** ERROR *** specifying command CLEAR PICTURE
Command requires an integer in the range 1 to 2

--------------------------------------------------------------------------------
Example:

Rover>CLEAR PICTURE 2
Rover>

CLEAR QUADRANT

--------------------------------------------------------------------------------
CLEAR QUADRANT

--------------------------------------------------------------------------------

FORMAT:		CLEAR QUADRANT quadrant [1..4]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command clears both picture 1 (raster) and picture 2 (vector) in the specified quadrant. More than one quadrant may be specified for clearing simultaneously.

The command is only valid if quartered screen mode has been enabled with the ENABLE DIVIDE command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLEAR and CLEAR QUADRANT commands.


*** ERROR *** specifying command CLEAR
Command not available during edit operation


*** ERROR *** Specifying command CLEAR
CLEAR qualifier is QUADRANT, PICTURE or LABEL


*** ERROR *** Specifying command CLEAR QUADRANT
Command only valid if ENABLE DIVIDE is specified


*** ERROR *** Specifying command CLEAR QUADRANT
Command requires up to 4 integers in the range 1 to 4

--------------------------------------------------------------------------------
Examples:

Rover>CLEAR QUADRANT 1
Rover>

Rover>CLEAR QUADRANT 2 3 4
Rover>

CLOSE FILEIN

--------------------------------------------------------------------------------
CLOSE FILEIN

--------------------------------------------------------------------------------

FORMAT:		CLOSE FILEIN DTI_number[s]
		CLOSE FILEIN   ALL

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command is used to close one or more DTI files which may be open. As only four files may be open, the parameters should be in the range 1 to 4, while CLOSE FILEIN ALL will close all currently open DTI files.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLOSE and CLOSE FILEIN commands.


*** ERROR *** Specifying command CLOSE
Command not available during edit operation


*** ERROR *** Specifying command CLOSE
Command qualifiers are FILEIN, IFF, OUTPUT or RCP_FILE


*** ERROR *** Specifying command CLOSE FILEIN
Command requires up to 4 integers in the range 1 to 4 or the ALL qualifier


*** ERROR *** Specifying command CLOSE FILEIN
File "DTI_number" is not open

--------------------------------------------------------------------------------
Examples:

Rover>CLOSE FILEIN 1
DTI File 1 Closed

Rover>CLOSE FILEIN ALL
DTI File 3 Closed
DTI File 4 Closed
Rover>

CLOSE IFF

--------------------------------------------------------------------------------
CLOSE IFF

--------------------------------------------------------------------------------

FORMAT:		CLOSE IFF

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The input IFF file holding vector information is closed. This command is required before another IFF file may be opened.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLOSE and CLOSE IFF commands.


*** ERROR *** Specifying command CLOSE
Command not available during edit operation


*** ERROR *** Specifying command CLOSE
Command qualifiers are FILEIN, IFF, OUTPUT or RCP_FILE


*** ERROR *** Specifying command CLOSE IFF
No IFF file is open

--------------------------------------------------------------------------------
Examples:

Rover>CLOSE IFF
Input IFF file closed
Rover>

CLOSE OUTPUT

--------------------------------------------------------------------------------
CLOSE OUTPUT

--------------------------------------------------------------------------------

FORMAT:		CLOSE OUTPUT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The output IFF file which has been previously opened to receive digitised coordinates is closed.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLOSE and CLOSE OUTPUT commands.


*** ERROR *** Specifying command CLOSE
Command not available during edit operation


*** ERROR *** Specifying command CLOSE
Command qualifiers are FILEIN, IFF, OUTPUT or RCP_FILE


*** ERROR *** Specifying command CLOSE IFF
No Output IFF file is open

--------------------------------------------------------------------------------
Examples:

Rover>CLOSE OUTPUT
Output IFF file closed
Rover>

CLOSE RCP_FILE COMMAND

--------------------------------------------------------------------------------
CLOSE RCP_FILE

The command CLOSE RCP_FILE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		CLOSE RCP_FILE number
	        CLOSE RCP_FILE ALL

--------------------------------------------------------------------------------
Command Parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

Closes a Registration Control Point (RCP) file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CLOSE and CLOSE RCP_FILE commands.


*** ERROR *** Specifying command CLOSE 
Command qualifiers are FILEIN, IFF, OUTPUT or RCP_FILE

*** ERROR *** Specifying command CLOSE RCP_FILE
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command CLOSE RCP_FILE
Command requires a RCP file number or the qualifier ALL

*** ERROR *** Specifying command CLOSE RCP_FILE
Command requires a RCP file number in the range 1 to 4

Writing RCP entries to RCP file number 

Updating RCP entries in RCP file number 

--------------------------------------------------------------------------------
Examples:

Registration>CLOSE RCP_FILE 1
Updating RCP entries in RCP file number
Registration>

COLOURS

--------------------------------------------------------------------------------
COLOURS

--------------------------------------------------------------------------------

FORMAT:		COLOURS num_colours

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The number of colours that will be used for the display of the raster image for the currently selected DTI file is specified by this command. The number of colours which may be specified depends on the current PLANES setting. If, for example, the PLANES setting is 5 then up to 29 colours may be specified. Colour indices 1 and 2 are reserved for black and white and a further colour (the first colour as specified by the FIRST_COLOUR command) is reserved for the display of zero values in the input matrix (normally blue for digital elevation models).

This command can be used in conjunction with the FIRST_COLOUR command to enable different DTI files to be displayed using different parts of the colour table. Thus a colour image may be displayed alongside a grey scale image.

Note that redefining the number of colours, may change the step value interval value previously set by the STEP command, and that the PLANES command will reset the number of colours to the maximum allowable for that bit-plane setting.

In EDIT mode of operation this command causes automatic redisplay of the currently selected DTI file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the COLOURS command


*** ERROR *** Specifying command COLOURS Command requires an integer in the range 1 to 253


*** ERROR *** Specifying command COLOURS
Command not available during edit operation


*** ERROR *** Specifying command COLOURS
Use of "num_colours" colours not possible with current PLANES setting

--------------------------------------------------------------------------------
Example:

Rover>PLANES 6
Rover>COLOURS 63

*** ERROR specifying command COLOURS
Use of 63 colours not possible with current PLANES setting

Rover>
Rover> COLOURS 61
Rover>

CONTINUE

--------------------------------------------------------------------------------
CONTINUE

--------------------------------------------------------------------------------

FORMAT:		CONTINUE

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

CONTINUE is used to resume the execution of a Rover Command File which has been specified with the @ command.

The command is only valid when the command file has passed control back to the terminal with a RESPOND command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CONTINUE command


*** ERROR *** Specifying command CONTINUE
Command only valid if Rover Command File open

--------------------------------------------------------------------------------
Example:

Rover>CONTINUE
Rover>

CREATE RCP_FILE COMMAND

--------------------------------------------------------------------------------
CREATE RCP_FILE

The command CREATE RCP_FILE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:	        CREATE RCP_FILE file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The CREATE RCP_FILE command is used to create a new Registration Control Point file.

Up to 4 RCP files may be created. The SELECT RCP command controls which RCP file is current. By default, the current file is the most recent RCP file to be created.

Entries may be added to the current file using the RCP ADD command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the CREATE and CREATE RCP_FILE commands:


*** ERROR *** Specifying command CREATE
Command qualifier is RCP_FILE

*** ERROR *** Specifying command CREATE RCP_FILE
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command CREATE RCP_FILE
RCP Filename is missing

*** ERROR *** Specifying command CREATE RCP_FILE
Maximum number of RCP files already open
Use the CLOSE RCP_FILE command to close a file

File  created as RCP File Number 

--------------------------------------------------------------------------------
Examples:

Registration>CREATE RCP_FILE CONTROL<CR>

File LSL$RCP:CONTROL.RCP created as RCP File Number 1

Registration>

DESELECT FC

--------------------------------------------------------------------------------
DESELECT FC

--------------------------------------------------------------------------------

FORMAT:         DESELECT FC feature_code [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT FC command is used to exclude IFF features from vector overlay. Features are excluded on the basis of their feature code.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The DESELECT FC command is only valid if an FRT command has been used to select a Feature Representation Table.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DESELECT and DESELECT FC commands


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER


*** ERROR *** Specifying command DESELECT FC
Command invalid before FRT has been read


*** ERROR *** Specifying command DESELECT FC
No groups have been defined in the FRT


*** ERROR *** Specifying command DESELECT FC
Max number of SEL/DES commands allowed exceeded


*** ERROR *** Specifying command DESELECT FC
Illegal feature code "feature_code"


*** ERROR *** Specifying command DESELECT FC
Bad group name "group"

--------------------------------------------------------------------------------
Examples:

Rover>DESELECT FC 1
Rover>DESELECT FC RAILWAYS
Rover>DESELECT FC RAIL,7-10,56-78
Rover>

DESELECT FSN

--------------------------------------------------------------------------------
DESELECT FSN

--------------------------------------------------------------------------------

FORMAT:         DESELECT FSN fsn [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT FSN command is used to exclude IFF features from vector overlay. Features are excluded on the basis of their feature serial number.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The DESELECT FSN command is only valid if an FRT file has been specified.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DESELECT and DESELECT FSN commands


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER


*** ERROR *** Specifying command DESELECT FSN
Command invalid before FRT has been read


*** ERROR *** Specifying command DESELECT FSN
Illegal FSN number "fsn"

--------------------------------------------------------------------------------
Examples:

Rover>DESELECT FSN 7
Rover>DESELECT FSN,7-10,56-78
Rover>

DESELECT LAYER

--------------------------------------------------------------------------------
DESELECT LAYER

--------------------------------------------------------------------------------

FORMAT:         DESELECT LAYER layer [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DESELECT LAYER command is used to exclude IFF features from vector overlay. Features are excluded on the basis of IFF layer.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The DESELECT LAYER command is only valid if an FRT file has been specified.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DESELECT and DESELECT LAYER commands


*** ERROR *** Specifying command DESELECT
Command qualifiers are FC, FSN or LAYER


*** ERROR *** Specifying command DESELECT LAYER
Command invalid before FRT has been read


*** ERROR *** Specifying command DESELECT LAYER
Illegal Layer number "layer"


*** ERROR *** Specifying command DESELECT LAYER
Command invalid before FRT has been read

--------------------------------------------------------------------------------
Examples:

Rover>DESELECT LAYER 7
Rover>DESELECT LAYER 1,7-10
Rover>

DISABLE ABSOLUTE

--------------------------------------------------------------------------------
DISABLE ABSOLUTE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE ABSOLUTE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE ABSOLUTE cancels a previous ENABLE ABSOLUTE command. If DISABLE ABSOLUTE is given, then coordinate values required by the WINDOW and MOVE, commands, supplied in metre or projection units, must be specified as an offset from the SW corner of the matrix. Coordinates supplied with the IFFWINDOW command should similarly be specified as an offset from the SW corner of the IFF file area.
By default window values should be specified as absolute coordinates.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE ABSOLUTE
Rover>

DISABLE COLOUR_MAP

--------------------------------------------------------------------------------
DISABLE COLOUR_MAP

--------------------------------------------------------------------------------

FORMAT:	        DISABLE COLOUR_MAP

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE COLOUR_MAP disables the use of a temporary mapped file used to make frequent redisplay, windowing and zooming more efficient. The command therefore cancels the effect of any previous ENABLE COLOUR_MAP command.

By default no temporary mapped file is used.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE COLOUR_MAP commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE COLOUR_MAP
Command not valid during editing operation

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE COLOUR_MAP
Rover>

DISABLE CROSS_CURSOR

--------------------------------------------------------------------------------
DISABLE CROSS_CURSOR

--------------------------------------------------------------------------------

FORMAT:	        DISABLE CROSS_CURSOR

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE CROSS_CURSOR disables the use of a vector cross cursor during raster editing and reselects the square DTI-pixel sized cursor. The command therefore cancels the effect of a previous ENABLE CROSS_CURSOR command. By default the square DTI-pixel sized cursor is used.

This command is only available in EDIT mode of operation.

The SHOW ENABLE command may be used to check the status of the option.

Puck button 7 alternately ENABLEs and DISABLEs CROSS_CURSOR.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE CROSS_CURSOR commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE CROSS_CURSOR
Command only available in EDIT mode

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE CROSS_CURSOR
Rover>

DISABLE DEFAULT COMMAND

--------------------------------------------------------------------------------
DISABLE DEFAULT

The command DISABLE DEFAULT is only valid in REGISTRATION mode

--------------------------------------------------------------------------------

FORMAT:	        DISABLE DEFAULT rcp_qualifier

--------------------------------------------------------------------------------
Command Parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DISABLE/ENABLE DEFAULT RCP command controls for what information the user is prompted, when the RCP ADD command is given.

If DISABLE DEFAULT is specified then the user is prompted for the specified RCP attribute. For example, if the command DISABLE DEFAULT RCP_ID has been given, the user is prompted to enter an RCP identifier. The SET DEFAULT RCP commands control the default value that is supplied with a prompt, and which may be accepted using carriage return. By default no prompting for additional RCP information occurs, and the RCP fields are assigned their default values.

The SHOW ENABLE command may be used to check on the status of the options when in Registration mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE DEFAULT commands:
*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE DEFAULT
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command DISABLE DEFAULT
Command qualifiers are ALL, RCP_ID, RCP_TYPE, RCP_WXY, RCP_WY or RCP_Z

--------------------------------------------------------------------------------
Examples:

Registration>DISABLE DEFAULT RCP_TYPE
Registration>RCP ADD 1.4 2.3
Enter RCP TYPE (Default = AA)>BB
Registration>

DISABLE DIGITISE

--------------------------------------------------------------------------------
DISABLE DIGITISE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE DIGITISE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIGITISE ends the digitising mode of operation. The program returns to the main display mode, and the 'Rover>' prompt returns.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE DIGITISE
Command not available in EDIT mode

--------------------------------------------------------------------------------
Examples:

Digitise>DISABLE DIGITISE
Rover>

DISABLE DIVIDE

--------------------------------------------------------------------------------
DISABLE DIVIDE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE DIVIDE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE DIVIDE deselects the divided screen display. Subsequent display commands operate on the full screen display. The command therefore cancels the effect of any previous ENABLE DIVIDE command.

In EDIT mode the command causes automatic redisplay of the currently selected DTI file.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE DIVIDE commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE DIVIDE
Command not available during EDITING operation.

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE DIVIDE
Rover>

DISABLE EDIT

--------------------------------------------------------------------------------
DISABLE EDIT

--------------------------------------------------------------------------------

FORMAT:	        DISABLE EDIT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE EDIT ends the editing mode of operation. The program returns to the main Display mode, signified by the 'Rover>' prompt.

The editing status lines at the bottom of the display are replaced by the border text if the TEXT option is enabled. An implicit RESET_MINMAX command is also applied to update the value ranges stored in the header of any edited files which have been opened for write access with the UPDATE_FILEIN command.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE EDIT commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE EDIT
Command not available in DIGITISE mode.

--------------------------------------------------------------------------------
Examples:

Edit>DISABLE EDIT
Rover>

DISABLE FLOODING

--------------------------------------------------------------------------------
DISABLE FLOODING

--------------------------------------------------------------------------------

FORMAT:	        DISABLE FLOODING

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE FLOODING ends interactive flooding using the mouse, trackerball or table. The current flood level is, however, remembered if a subsequent ENABLE FLOODING command is given.

Interactive flooding is only available in EDIT mode of operation.

The SHOW ENABLE command may be used to check the status of the option.

Puck button E alternately disables and enables flooding.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE FLOODING commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE FLOODING
Command only available in EDIT mode.

--------------------------------------------------------------------------------
Examples:

Flood>DISABLE FLOODING
Rover>

DISABLE HATCH

--------------------------------------------------------------------------------
DISABLE HATCH

--------------------------------------------------------------------------------

FORMAT:	        DISABLE HATCH

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE HATCH returns to the default mode of using hatching parameters specified in the FRT file for overlay.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE HATCH
Rover>

DISABLE HEIGHT

--------------------------------------------------------------------------------
DISABLE HEIGHT

--------------------------------------------------------------------------------

FORMAT:	        DISABLE HEIGHT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE HEIGHT returns to the default mode of operation where text heights are taken from the FRT file for vector overlay.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE HEIGHT
Rover>

DISABLE INTERPOLATION

--------------------------------------------------------------------------------
DISABLE INTERPOLATION

--------------------------------------------------------------------------------

FORMAT:	        DISABLE INTERPOLATION

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE INTERPOLATION deselects curve Interpolation of graphical type 6 features output with the OVERLAY command.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE INTERPOLATION
Rover>

DISABLE LEGEND

--------------------------------------------------------------------------------
DISABLE LEGEND

--------------------------------------------------------------------------------

FORMAT:	        DISABLE LEGEND

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE LEGEND disables the display of a colour/value guide and an overlay colour guide when a DISPLAY command is given.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE LEGEND
Rover>

DISABLE MASK

--------------------------------------------------------------------------------
DISABLE MASK

--------------------------------------------------------------------------------

FORMAT:	        DISABLE MASK

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE MASK deselects the option to draw vectors in PICTURE 1. Subsequent vectors are drawn in PICTURE 2 when the OVERLAY command is given.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE MASK
Rover>

DISABLE OVERRIDE

--------------------------------------------------------------------------------
DISABLE OVERRIDE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE OVERRIDE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE OVERRIDE cancels feature codes set by the ENABLE OVERRIDE command. The actual feature codes in the file will be used to determine their representation on the screen when output with the OVERLAY command.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE OVERRIDE
Rover>

DISABLE PATTERN

--------------------------------------------------------------------------------
DISABLE PATTERN

--------------------------------------------------------------------------------

FORMAT:	        DISABLE PATTERN

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE PATTERN suppresses the the drawing of patterned lines. Lines specified as patterned in the FRT file will be drawn as solid when the OVERLAY command is issued.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE PATTERN
Rover>

DISABLE PICTURE

--------------------------------------------------------------------------------
DISABLE PICTURE

--------------------------------------------------------------------------------

FORMAT:		 DISABLE PICTURE picnum     

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

Picture 1 contains the raster information output using the DISPLAY command.

Picture 2 contains any vector information drawn using the OVERLAY command, and any user annotation drawn using the DRAW LABEL command.

DISABLE PICTURE makes the specified picture 'invisible'. The image may be made visible again with the ENABLE PICTURE command. (cf CLEAR PICTURE).

The SHOW ENABLE command may be used to check the status of the 2 pictures.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISABLE and DISABLE PICTURE commands.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT


*** ERROR *** Specifying command DISABLE PICTURE
Command requires an integer in the range 1 to 2

--------------------------------------------------------------------------------
Examples:

Rover> ENABLE PICTURE 1
Rover> DISABLE PICTURE 1
Rover>

DISABLE POSITIONING

--------------------------------------------------------------------------------
DISABLE POSITIONING

--------------------------------------------------------------------------------

FORMAT:	        DISABLE POSITIONING

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE POSITIONING disables the use of the justification code (0-8) stored in the FS entry for text positioning. The text is positioned by its lower left corner.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE POSITIONING
Rover>

DISABLE REGISTRATION

--------------------------------------------------------------------------------
DISABLE REGISTRATION

The command DISABLE REGISTRATION is only valid in REGISTRATION mode.

--------------------------------------------------------------------------------

FORMAT:	        DISABLE REGISTRATION

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The DISABLE REGISTRATION command is used to exit from REGISTRATION mode, and to return to Display mode signified by the prompt 'ROVER>'

On giving the command, the registration status line at the bottom of the display is replaced by the border text (if the TEXT option is enabled), and the cross cursor is deleted from the screen. The command also causes all currently opened RCP files to be closed.

CTRL/Z (pressing the Ctrl and Z keys together) may also be used to exit from REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Registration>DISABLE REGISTRATION
Rover>

DISABLE SAMPLE

--------------------------------------------------------------------------------
DISABLE SAMPLE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE SAMPLE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE SAMPLE disables the use of sub-sampling during the display of DTI files. Every DTI pixel in the current window is therefore displayed, regardless of the current sampling values set with the SAMPLE command.

Note that the command ENABLE REGISTRATION automatically enables sampling, while ENABLE EDIT automatically disables sampling.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE SAMPLE
Rover>

DISABLE TABLE

--------------------------------------------------------------------------------
DISABLE TABLE

--------------------------------------------------------------------------------

FORMAT:	        DISABLE TABLE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The DISABLE TABLE command turns off input from the digitising table.

Input from the table can be reselected using the ENABLE TABLE command.

The SHOW ENABLE command may be used to check on the status of table input.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE TABLE
Rover>

DISABLE TEXT

--------------------------------------------------------------------------------
DISABLE TEXT

--------------------------------------------------------------------------------

FORMAT:	        DISABLE TEXT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISABLE TEXT disables the output of border information when a DISPLAY command is given. By default the DTI file name, area of interest, selected value range and number of colour values used in the display image are output to the screen.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DISABLE command.


*** ERROR *** Specifying command DISABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE,
TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>DISABLE TEXT
Rover>

DISPLAY

--------------------------------------------------------------------------------
DISPLAY

--------------------------------------------------------------------------------

FORMAT:		DISPLAY 

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DISPLAY is the raster drawing command, that will output grid information contained in a mapped DTI file, to the graphics screen in colour coded form.

The currently selected DTI file, selected by means of the SELECT FILEIN command, is displayed. RANGE, STEP, COLOURS, and FIRST_COLOUR settings for each DTI file are used to determine the exact nature of the displayed image, while only the information in the current area of interest set by the WINDOW command is displayed. The displayed image is automatically scaled to fill as much of the full screen or currently selected quadrant as possible, and is drawn in the direction specified by the ROTATE command. The default display direction is from the South. It should be noted that on certain devices DISPLAY is faster in some directions than others.

The DISPLAY command is also invoked implicitly by the ZOOM command and in EDIT mode by the STEP, RANGE, WINDOW, SELECT FILEIN, COLOURS, FIRST_COLOUR, FILEIN, and UPDATE_FILEIN commands.

See also the FAST command as an alternative method for output of byte data files.

Typing (Pressing the Ctrl and C keys together) aborts the display of the current file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the DISPLAY command.


*** ERROR *** Specifying command DISPLAY
Command not available during editing operation


*** ERROR *** Specifying command DISPLAY
Input DTI file "DTI-num" not yet selected

--------------------------------------------------------------------------------
Examples:

Rover>DISPLAY
Rover>

DOWN

--------------------------------------------------------------------------------
DOWN

--------------------------------------------------------------------------------

FORMAT:		DOWN

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

DOWN moves the raster editing cursor down by one DTI pixel.

The command is only available in EDIT and REGISTRATION modes of operation.

Puck button B is defined as DOWN.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DOWN command.


*** ERROR *** Specifying command DOWN
Command only available in EDIT or REGISTRATION mode

--------------------------------------------------------------------------------
Examples:

Edit>DOWN
Edit>

DRAW LABEL

--------------------------------------------------------------------------------
DRAW LABEL

--------------------------------------------------------------------------------

FORMAT:		DRAW LABEL text

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The specified text is written to the display.

By default the position of the text is along the bottom line of the current plotting area, and is output in overlay colour 1.

Both the size and position of the text may be changed by means of the LABEL SIZE and LABEL POSITION commands, while the colour of annotation may be set using the LABEL COLOUR command.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the DRAW LABEL command.


*** ERROR *** Specifying command DRAW
Command qualifier is LABEL

--------------------------------------------------------------------------------
Examples:

Rover> DRAW LABEL A Very Pretty Picture
Rover>

EDIT

--------------------------------------------------------------------------------
EDIT

--------------------------------------------------------------------------------

FORMAT:		EDIT

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The EDIT command is used to store the current matrix coordinates of the raster editing cursor, and all those pixels which join the current position to the previous position given with the latest EDIT command. Thus a series of EDIT and MOVE commands creates a line of pixels which may then be changed to a specific value on issue of the END command. Pixels which will be changed are highlighted in the current editing cursor colour.

During editing the program prompt is displayed as 'Line>' to indicate line editing is taking place. Line editing is the default mode of raster editing, but if the AREA_EDIT or SMOOTH_EDIT commands are used to initialise an editing operation then the EDIT command is also utilised.

This command is only available in EDIT mode of operation.

ABANDON or (pressing the Ctrl and Z keys together) will abort the edit operation. Puck button 4 and mouse or function button 1 are defined to be EDIT.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the EDIT command.


*** ERROR *** Specifying command EDIT
Command only available in EDIT mode


*** ERROR *** Specifying command EDIT
Selected DTI file is opened read-only

--------------------------------------------------------------------------------
Examples:


Edit>MOVE 10 10
Edit>EDIT
Line>MOVE 20 20
Line>EDIT
Line>END
Line> DTI Value> 50
Edit>


Edit>MOVE 50 50
Edit>EDIT
Line>END
Line> DTI Value> 100
Edit>

ENABLE ABSOLUTE

--------------------------------------------------------------------------------
ENABLE ABSOLUTE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE ABSOLUTE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

If ENABLE ABSOLUTE is given, then coordinate values required by the WINDOW or MOVE commands, supplied in metre or projection units, must be specified as absolute (rather than relative) coordinate values. Coordinates for the IFFWINDOW command should also be supplied as absolute values.

For example if the projection indicates U.K. National Grid, then the WINDOW values may be specified as 6 figure National Grid coordinates.
By default window values should be specified as absolute coordinates.

This option can be disabled using the DISABLE ABSOLUTE command. The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE ABSOLUTE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE ABSOLUTE
Rover>

ENABLE COLOUR_MAP

--------------------------------------------------------------------------------
ENABLE COLOUR_MAP

--------------------------------------------------------------------------------

FORMAT:	        ENABLE COLOUR_MAP

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command enables the use of a temporary mapped DTI file to speed up raster display. It is recommended that this option is enabled if many ZOOM or WINDOW commands are to be given during the course of a ROVER session. After initial draw of a large window, the subsequent WINDOW and ZOOM commands make use of the temporary colour map for fast redisplay.

It should be noted that the use of the temporary colour map increases the time ROVER takes to exit because the file has to be unmapped. By default no temporary mapped file is used.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE COLOUR_MAP commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE COLOUR_MAP
Command not valid during editing operation


*** ERROR *** Specifying command ENABLE COLOUR_MAP
Command not valid during sampling

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE COLOUR_MAP
Rover>

ENABLE CROSS_CURSOR

--------------------------------------------------------------------------------
ENABLE CROSS_CURSOR

--------------------------------------------------------------------------------

FORMAT:	        ENABLE CROSS_CURSOR

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE CROSS_CURSOR selects the use of a vector cross cursor in EDIT mode of operation. The cross cursor is the same size regardless of the dimensions of the DTI window displayed. Thus it is useful if a large window is displayed and consequently the default square DTI-pixel sized cursor appears very small.

This command is only available in EDIT or REGISTRATION modes of operation.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE CROSS_CURSOR commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE CROSS_CURSOR
Command only available in EDIT or REGISTRATION modes

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE CROSS_CURSOR
Rover>

ENABLE DEFAULT COMMAND

--------------------------------------------------------------------------------
ENABLE DEFAULT

The command ENABLE DEFAULT is only valid in REGISTRATION mode

--------------------------------------------------------------------------------

FORMAT:	        ENABLE DEFAULT rcp_qualifier

--------------------------------------------------------------------------------
Command Parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The DISABLE/ENABLE DEFAULT RCP commands controls for what information the user is prompted, when the RCP ADD command is given

If ENABLE DEFAULT is specified then the user is NOT prompted for the specified RCP attribute, and the default attribute value will be used. For example, if the command ENABLE DEFAULT RCP_TYPE has been given, then the user will not be prompted for a RCP type identifier, and the default RCP type identifier will be used. The SET DEFAULT RCP commands control the default value that will be used.

By default no prompting for additional RCP information occurs, and the RCP fields are assigned their default values.

The SHOW ENABLE command may be used to check on the status of the option when in Registration mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE DEFAULT commands:
*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE DEFAULT
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command ENABLE DEFAULT
Command qualifiers are ALL, RCP_ID, RCP_TYPE, RCP_WXY, RCP_WY or RCP_Z

--------------------------------------------------------------------------------
Examples:

Registration>ENABLE DEFAULT ALL
Registration>RCP ADD 1.2 3.4
Registration>

ENABLE DIGITISE

--------------------------------------------------------------------------------
ENABLE DIGITISE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE DIGITISE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE DIGITISE enables the ROVER digitising mode of operation. Features may be digitised using the current settings with the SET FC, SET FSN and SET FC commands. A cursor is displayed which may be moved around the screen by pressing puck button 0. Commands START and END, which are issued from the cursor button, are used to create feature in the output file.

ENABLE DIGITISE may only be specified if a map has been setup using the SETUP MAP command.

Once this command has been issued the program is in DIGITISE mode until DISABLE DIGITISE is specified. The program prompt becomes 'Digitise>' until DIGITISE mode is exited.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE DIGITISE commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE DIGITISE
Command not available in EDIT mode.


*** ERROR *** Specifying command ENABLE DIGITISE
Command invalid without a map registered

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE DIGITISE
Digitise>

ENABLE DIVIDE

--------------------------------------------------------------------------------
ENABLE DIVIDE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE DIVIDE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE DIVIDE selects the use of quartered screen display mode. Each quadrant is treated by the program as though it were a separate graphics screen. This allows four different files to be displayed simultaneously, or alternatively different representations of the same file may be shown.

The 4 quadrants are identified as follows:


		1   =   Top lefthand quadrant

		2   =   Top righthand quadrant 

		3   =   Bottom righthand quadrant

		4   =   Bottom lefthand quadrant

Subsequent display commands display the files in the current quadrant specified with the QUADRANT command. The default quadrant is the top left corner (quadrant 1).

In EDIT mode this command causes automatic redisplay of the currently selected DTI file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE DIVIDE commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE DIVIDE
Command not available during editing operation

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE DIVIDE
Rover>

ENABLE EDIT

--------------------------------------------------------------------------------
ENABLE EDIT

--------------------------------------------------------------------------------

FORMAT:	        ENABLE EDIT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE EDIT enables the raster editing mode of operation. After this command has been specified then the various raster editing commands are available. The currently selected DTI file may be edited. A status display of the current editing cursor position and DTI value are shown. Thus this command is useful to allow interrogation of the values in the DTI file even if the file has only been opened for read with the FILEIN command. Actual editing commands may only be specified, however if the currently selected DTI file has been opened for write with the UPDATE_FILEIN command.

WARNING: Edits on DTI files are carried out in-situ. Thus edited DTI pixels are changed in the disk file immediately. To safeguard against possible file corruption, it is recommended that copies of files are made prior to a Rover editing session.

Once this command has been issued the program is in EDIT mode until DISABLE EDIT has been specified. The program prompt becomes 'Edit>' until EDIT mode is exited or an editing operation is carried out.

If the currently selected DTI file has not yet been displayed, then this command causes its automatic display.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE EDIT commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE EDIT
Command not available in REGISTRATION mode.


*** ERROR *** Specifying command ENABLE EDIT
Command not available in DIGITISE mode.


*** ERROR *** Specifying command ENABLE EDIT
Command requires that a DTI file is open

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE EDIT
Edit>

ENABLE FLOODING

--------------------------------------------------------------------------------
ENABLE FLOODING

--------------------------------------------------------------------------------

FORMAT:	        ENABLE FLOODING

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE FLOODING turns on the interactive flooding control from the mouse, trackerball or table. The effect of "flooding" is achieved by dynamically rewriting the colour table to blue. The extent of the flooding may be varied by moving the mouse or table puck in the Y direction. In the latter case a map should have been registered to provide limits for the flooding. The flooding takes place within the current RANGE settings and according to the current STEP intervals. The current flood level is displayed at the bottom of the screen.

During flooding the program prompt is displayed as 'Flood>'

ENABLE FLOODING is only available in EDIT mode.

Puck button E alternately enables and disables flooding.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE FLOODING commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE FLOODING
Command command only available in EDIT mode.

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE FLOODING
Flood>

ENABLE HATCH

--------------------------------------------------------------------------------
ENABLE HATCH

--------------------------------------------------------------------------------

FORMAT:		ENABLE HATCH [line-width, line-separation]

--------------------------------------------------------------------------------
Command Parameters

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE HATCH allows hatching parameters specified in the width and size entries in the FRT file to be overriden for vector display with the OVERLAY command.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE HATCH
Arguments should be positive real numbers

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE HATCH 2.0 2.0
Rover>

ENABLE HEIGHT

--------------------------------------------------------------------------------
ENABLE HEIGHT

--------------------------------------------------------------------------------

FORMAT:	        ENABLE HEIGHT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE HEIGHT command specifies that text sizes are taken from the TH entry of the IFF file rather than from the FRT file.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE HEIGHT
Rover>

ENABLE INTERPOLATION

--------------------------------------------------------------------------------
ENABLE INTERPOLATION

--------------------------------------------------------------------------------

FORMAT:	        ENABLE INTERPOLATION

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE INTERPOLATION selects curve Interpolation of graphical type 6 features in the IFF file, using the current interpolation method specified with the INTERPOLATE command for vector overlay.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE INTERPOLATION
Rover>

ENABLE LEGEND

--------------------------------------------------------------------------------
ENABLE LEGEND

--------------------------------------------------------------------------------

FORMAT:	        ENABLE LEGEND

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE LEGEND enables the display of a colour/value guide and an overlay colour guide when a DISPLAY command is given.

The position of the LEGEND on the screen may be changed with the LEGEND POSITION command.

Legend display is automatically disabled if a large window which cannot fit in the default display area is specified.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE LEGEND
Rover>

ENABLE MASK

--------------------------------------------------------------------------------
ENABLE MASK

--------------------------------------------------------------------------------

FORMAT:	        ENABLE MASK

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

By default the vector information is drawn to Picture 2 in one of the available overlay colours.

Using ENABLE MASK the vector information may be drawn in Picture 1 in the background colour. This allows the underlying image to be masked.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE MASK
Rover>

ENABLE OVERRIDE

--------------------------------------------------------------------------------
ENABLE OVERRIDE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE OVERRIDE layer FC

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE OVERRIDE causes all feature codes for all features in the specified layer to be set to the supplied feature code value. This allows all features within a layer to be treated as identical for overlay purposes.

Up to 256 layer/feature code equations may be set up.

DISABLE OVERRIDE will cancel the settings.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE OVERRIDE commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE OVERRIDE
Command requires two integer arguments in the range 0 to 32767


*** ERROR *** Specifying command ENABLE OVERRIDE
Too many overrides specified

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE OVERRIDE 3 5
Rover>

ENABLE PATTERN

--------------------------------------------------------------------------------
ENABLE PATTERN

--------------------------------------------------------------------------------

FORMAT:	        ENABLE PATTERN

--------------------------------------------------------------------------------
Command Parameters

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE PATTERN specifies that all lines specified as patterned in the FRT file will be drawn as patterned when the OVERLAY command is issued.

This is the default mode of operation

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE PATTERN
Rover>

ENABLE PICTURE

--------------------------------------------------------------------------------
ENABLE PICTURE

--------------------------------------------------------------------------------

FORMAT:		 ENABLE PICTURE picnum     

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

Picture 1 contains the raster information output using the DISPLAY command.

Picture 2 contains any vector information drawn using the OVERLAY command, and any user annotation drawn using the DRAW LABEL command.

ENABLE PICTURE makes the specified picture visible, after a previous DISABLE PICTURE command had made it invisible.

The SHOW ENABLE command may be used to check on the status of the 2 pictures.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE PICTURE commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE PICTURE
Command requires an integer in the range 1 to 2 --------------------------------------------------------------------------------
Examples:

Rover>ENABLE PICTURE 1
Rover>

ENABLE POSITIONING

--------------------------------------------------------------------------------
ENABLE POSITIONING

--------------------------------------------------------------------------------

FORMAT:	        ENABLE POSITIONING

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE POSITIONING enables the use of the justification code (0-8) stored in the FS entry for text positioning for vector overlay.

The SHOW ENABLE command may be used to check the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE POSITIONING
Rover>

ENABLE REGISTRATION

--------------------------------------------------------------------------------
ENABLE REGISTRATION

--------------------------------------------------------------------------------

FORMAT:	        ENABLE REGISTRATION

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE REGISTRATION command is used to enter ROVER REGISTRATION mode. Registration mode is signified by the prompt 'Registration>' on the terminal.

After giving the command all registration related commands such as OPEN RCP_FILE and RCP ADD, are available.

The description section contains details on the purpose and operation of REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE EDIT
Command requires that a DTI file is open

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE REGISTRATION
Registration>

ENABLE SAMPLE

--------------------------------------------------------------------------------
ENABLE SAMPLE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE SAMPLE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE SAMPLE command enables sub-sampling of the DTI values during display. The column and row sample intervals may be set by the SAMPLE command.

The command also enables Rover to reset the sampling intervals automatically if the window, specified explicitly with the WINDOW command or implicitly with the ZOOM command, is too large to be displayed with the current sample values in the display area.

While sampling is enabled window values may be adjusted slightly to ensure that the the current window extents consist of a whole number of sample intervals. A warning message is issued when this occurs.

Note that the command ENABLE REGISTRATION automatically enables sampling, while ENABLE EDIT automatically disables sampling.

The SHOW ENABLE command may be used to check on the status of this option.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the ENABLE and ENABLE SAMPLE commands.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT


*** ERROR *** Specifying command ENABLE SAMPLE
Command invalid while COLOUR_MAP is enabled.


*** ERROR *** Specifying command ENABLE SAMPLE
Command not available in EDIT mode.

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE SAMPLE
Rover>

ENABLE TABLE

--------------------------------------------------------------------------------
ENABLE TABLE

--------------------------------------------------------------------------------

FORMAT:	        ENABLE TABLE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The ENABLE TABLE command initialises the table monitor to allow input from a digitising table. The command SETUP MAP may be used to register a map to the DTI file. In the event of failure, input from the digitising table or puck button is not possible, and the program will accept commands only from the terminal.

Table initialisation will generally fail because no Table Monitor is currently active, or because the Table Monitor is locked by another user. If neither of these reasons appear to apply, you should consult the TABLIB Reference Manual, or seek guidance from your system manager.

If the logical name LSL$AUTO_ENABLE_TABLE is defined with a value of "1", then the table is initialised on program startup.

The DISABLE TABLE command may be used to turn off input from the digitising table.

The SHOW ENABLE command may be used to check on the status of table input.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE TABLE
Rover>

ENABLE TEXT

--------------------------------------------------------------------------------
ENABLE TEXT

--------------------------------------------------------------------------------

FORMAT:	        ENABLE TEXT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

ENABLE TEXT enables the output of border information when a DISPLAY command is given. The DTI filename, area of interest, selected value range and number of colour levels used in the display image are output.

The SHOW ENABLE command may be used to check on the status of the option.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ENABLE command.


*** ERROR *** Specifying command ENABLE
Command qualifiers are ABSOLUTE, COLOUR_MAP, CROSS_CURSOR, DEFAULT,
DIGITISE, DIVIDE, EDIT, FLOODING, HATCH, HEIGHT, INTERPOLATION, LEGEND,
MASK, OVERRIDE, PATTERN, PICTURE, POSITIONING, REGISTRATION, SAMPLE, TABLE or TEXT

--------------------------------------------------------------------------------
Examples:

Rover>ENABLE TEXT
Rover>

END

--------------------------------------------------------------------------------
END

--------------------------------------------------------------------------------

FORMAT:		END [DTI-value]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

In the DIGITISE mode the END command ends the construction of the current feature. The digitised line is then stored in the output IFF file.

In EDIT mode END finishes the current editing sequence. The DTI-value supplied is assigned to the pixels which have been specified. If no parameter is supplied then the user is prompted for a DTI value.

The END command is available only if ENABLE EDIT or ENABLE DIGITISE commands have been specified.

END is defined as puck button 5

In EDIT mode mouse or function button 2 is defined as end.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the END command.


*** ERROR *** Specifying command END
Command only available in EDIT or DIGITISE modes


*** ERROR *** Specifying command END
Command requires a word value in the range -32767 to 32766


*** ERROR *** Specifying command END
Command requires a byte value in the range 0 to 255

--------------------------------------------------------------------------------
Examples:


Edit>MOVE 10 10
Edit>EDIT
Line>MOVE 20 20
Line>EDIT
Line>END
Line> DTI Value> 50
Edit>


Digitise Point> END
Digitise>

ENLARGE

--------------------------------------------------------------------------------
ENLARGE

--------------------------------------------------------------------------------

FORMAT:	        ENLARGE

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The screen image is magnified by a factor of 2 using pixel replication. If the command is repeatedly given the display will continue to be enlarged until the maximum magnification (x 16) is reached.

Puck button 2 is defined as ENLARGE.

This command has no effect on a graphics device which does not support hardware pixel replication. The ZOOM command offers an alternative way of enlarging the image on such a device.

--------------------------------------------------------------------------------
Messages _None
Display is at maximum magnification

--------------------------------------------------------------------------------
Examples:

Rover>ENLARGE
Rover>

EXIT

--------------------------------------------------------------------------------
EXIT

--------------------------------------------------------------------------------

FORMAT:	        EXIT

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The program is terminated, and any currently opened DTI files will be unmapped, along with any input or output IFF files.

--------------------------------------------------------------------------------
Messages _None

--------------------------------------------------------------------------------
Example:

Rover>EXIT _$

FAST

--------------------------------------------------------------------------------
FAST

--------------------------------------------------------------------------------

FORMAT:		FAST 

--------------------------------------------------------------------------------
Command Parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The FAST command may be used as an alternative to the DISPLAY command to output data more quickly to the graphics screen. The DTI file file values are output directly to the graphics device with no colour lookup calculations. Thus the current RANGE, STEP, COLOURS and FIRST_COLOUR values are not used. Because there is a limit of 255 colours which may be displayed, only files with byte datatype may be displayed with the FAST command.

The command requires that enough planes are set for the maximum value in the currently selected file to be output. The maximum value should be less than 2 raised to the power of (n) - 1, where n is the current planes setting. Thus a file with a maximum value of 64 requires a PLANES setting of 7, while a file with a maximum value of 63 requires only 6 planes to be used for the raster drawing.

The file is drawn in the direction specified by the latest ROTATE command. The default display direction is from the South. It should be noted that on some devices display speeds improve in certain directions.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the FAST command.


*** WARNING *** FAST command ignored with non-byte data
Normal display taking place


*** WARNING *** Too few planes set for fast display
Normal display taking place

--------------------------------------------------------------------------------
Examples:

Rover>FAST
Rover>

FILEIN

--------------------------------------------------------------------------------
FILEIN

--------------------------------------------------------------------------------

FORMAT:	        FILEIN  file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command opens and maps into memory a DTI file for read access. The file is opened on the lowest available DTI file number. The DTI file number is displayed on the terminal, and is the means by which the file is selected when a number of DTI files are opened.
Details derived from the header of the file are displayed on the terminal to confirm that the file has been successfully opened.

Up to 4 DTI files may be opened at one time. By default the DTI file opened with the last FILEIN or UPDATE_FILEIN command is the current DTI file.

If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest is set for the file based on the maximum window which may be displayed in the default display area on the graphics device at four times magnification. Otherwise, if ENABLE SAMPLE has not been specified, a window corresponding to the entire file extents is set unless this is too large to be displayed in which case truncation takes place. The area of interest may be altered at any time by use of the WINDOW command.

If the rotation value (DTI_ORDER_CORNER) held in the header of the DTI file is not the default, (south west) then a warning message is output when the file is opened. Rover however, sets up the viewing direction taking into account the rotation value. Thus, provided the rotation value in the header is correct, Rover will display the file in the correct orientation. The ROTATE command be used to change the default viewing direction.

Information on the mapped DTI file may be obtained at any time by typing 'SHOW FILEIN'.

Note that editing operations may not be performed on a file that has been opened with FILEIN (cf UPDATE_FILEIN).

In EDIT and REGISTRATION modes issue of the FILEIN command results in automatic display of the file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the FILEIN command.


*** ERROR *** Specifying command FILEIN
Four DTI are currently opened
CLOSE command should be used


*** ERROR *** Specifying command FILEIN
Filename is missing

--------------------------------------------------------------------------------
Example:

Rover>FILEIN TEST


*** File LSL$DTI:TEST.DTI opened as DTI file 1

File    :  LSL$DTI:TEST.DTI
Header  :  LSLA Data:  WORD

Units are DTI Matrix Value

Matrix Coverage   SW:     1      1  NE:   301   251
Matrix Window     SW:     1      1  NE:   301   251
Matrix Interval    E:     1          N:     1
Value Range         :     0    to    851
Rover>

FIRST_COLOUR

--------------------------------------------------------------------------------
FIRST_COLOUR

--------------------------------------------------------------------------------

FORMAT:		FIRST_COLOUR base-colour

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

FIRST_COLOUR defines the starting colour index for raster display of the currently selected DTI file. It enables, in conjunction with the COLOURS command, different parts of the colour table to be used to display different DTI files. (eg. a colour image alongside a grey scale image). The base colour itself is used for the display of zero values in the DTI matrix (normally blue for digital elevation models) and is not included in the actual colour indices. The current base colour setting may be examined using the SHOW PARAMETERS command.

Note that redefining the first colour, may change the step interval values previously set by the STEP command.

In EDIT mode of operation this command causes automatic redisplay of the currently selected DTI file

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the FIRST_COLOUR command.


*** ERROR *** Specifying command FIRST_COLOUR
Command requires an integer argument in range 2 to 64


*** ERROR *** Specifying command FIRST_COLOUR
Command not available during editing operation.

--------------------------------------------------------------------------------
Examples:

Rover>SELECT FILE 1
Rover>PLANES 6
Rover>FIRST_COLOUR 3
Rover>COLOURS 29
Rover>DISPLAY
Rover>SELECT FILE 2
Rover>FIRST_COLOUR 33
Rover>COLOURS 31
Rover>DISPLAY
Rover>

FLOOD

--------------------------------------------------------------------------------
FLOOD

--------------------------------------------------------------------------------

FORMAT:	        FLOOD wait_time

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This is the Rover non-interactive flooding facility (cf ENABLE FLOODING). Each colour index is dynamically respecified to be blue. The effect is the successive recolouring of the displayed image until it becomes entirely blue. The time interval specified is the wait interval between the rewriting of each colour in the colour table.

To clear the effect of flooding a lookup table should be respecified with the LUT command.

--------------------------------------------------------------------------------
Messages: _None

--------------------------------------------------------------------------------
Examples:

Rover>FLOOD 3
Rover>

FRT

--------------------------------------------------------------------------------
FRT

--------------------------------------------------------------------------------

FORMAT:	        FRT  file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command selects and reads the contents of the specified Feature Representation Table.

The FRT is used by ROVER to look up the graphical type of a feature, and to consequently determine the graphical representation of the feature when drawn.

The table also defines feature code group names that may be supplied as parameters to the SELECT FC or DESELECT FC commands.

The command must be given before the OVERLAY command.

--------------------------------------------------------------------------------
Messages:


The following message are specific to the FRT command.


*** ERROR *** Specifying command FRT
A system message will follow.

--------------------------------------------------------------------------------
Examples:

Rover>FRT TPCROV
Rover>

HELP

--------------------------------------------------------------------------------
HELP

--------------------------------------------------------------------------------

FORMAT:		 HELP [command]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

A brief description is given of the function and format of the specified command. If no parameter is specified then a complete list of available commands are output.

--------------------------------------------------------------------------------
Messages: _None

--------------------------------------------------------------------------------
Examples:

Rover>HELP DISPLAY
Rover>

IFF

--------------------------------------------------------------------------------
IFF

--------------------------------------------------------------------------------

FORMAT:	        IFF  file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

Selects and opens the IFF file containing the vector data to be drawn using the OVERLAY command. A default area of interest within the IFF file is set when the file is opened. This may be subsequently altered using the IFFWINDOW command. If origin offset values are present in the headers of the DTI and IFF files, then the IFF window is set with respect to the current DTI window. This allows registration between the raster image and the vector overlay to take place automatically. If no such header information is present, or if the DISABLE ABSOLUTE command has been given, then the default area of interest in the IFF file that corresponds to the IFF range entry (RA) values is set.

The IFF file range and IFF window may be examined using the command SHOW IFF.

--------------------------------------------------------------------------------
Messages:


The following message are specific to the IFF command.


*** ERROR *** Specifying command IFF
Filename is missing

--------------------------------------------------------------------------------
Examples:

Rover>IFF ROADS_VECTOR
Rover>

IFFWINDOW

--------------------------------------------------------------------------------
IFFWINDOW

--------------------------------------------------------------------------------

FORMAT:	        IFFWINDOW swx swy nex ney

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

IFFWINDOW is used to define a rectangular area of interest within the IFF file. By default or if the ENABLE ABSOLUTE command has been given then window values should be supplied in absolute IFF units. Otherwise values should be specified as an offset from the SW corner of the IFF file area.

The IFFWINDOW command enables the IFF file to be registered to the current area of interest in the DTI file.
When the command is given, a transformation matrix for IFF to DTI coordinate conversion is calculated, based on the coordinates of the IFF and DTI windows.

The command SHOW IFF may be used to examine the IFF range and window coordinate values.

Before giving the command an IFF file must have been selected using the IFF command.

--------------------------------------------------------------------------------
Messages:

The following error messages are specific to the IFFWINDOW command:


*** ERROR *** Specifying command IFFWINDOW
Command requires that an IFF file is open


*** ERROR *** Specifying command IFFWINDOW
IFF Window command requires 4 values


*** ERROR *** Specifying command IFFWINDOW
NE corner should exceed SW corner

--------------------------------------------------------------------------------
Examples:

Rover>IFFWINDOW 310000.0 220000.0 330000.0 240000.0
Rover>

INTERPOLATION AKIMA

--------------------------------------------------------------------------------
INTERPOLATION AKIMA

--------------------------------------------------------------------------------

FORMAT:	        INTERPOLATION AKIMA

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command specifies the AKIMA interpolation method for the overlay of graphical type 6 curve features.

This is the default method of interpolation.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the INTERPOLATION command.


*** ERROR *** Specifying command INTERPOLATION
Command qualifiers are AKIMA or MCCONALOGUE

--------------------------------------------------------------------------------
Examples:

Rover>INTERPOLATION AKIMA
Rover>

INTERPOLATION MCCONALOGUE

--------------------------------------------------------------------------------
INTERPOLATION MCCONALOGUE

--------------------------------------------------------------------------------

FORMAT:	        INTERPOLATION MCCONALOGUE

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command specifies the MCCONALOGUE interpolation method for the overlay of graphical type 6 curve features.

The default method of interpolation is INTERPOLATION AKIMA.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the INTERPOLATION command.


*** ERROR *** Specifying command INTERPOLATION
Command qualifiers are AKIMA or MCCONALOGUE

--------------------------------------------------------------------------------
Examples:

Rover>INTERPOLATION MCCONALOGUE
Rover>

LABEL COLOUR

--------------------------------------------------------------------------------
LABEL COLOUR

--------------------------------------------------------------------------------

FORMAT:		LABEL COLOUR overlay-colour

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The colour of user labelling is selected. By default user labels will be drawn in overlay colour 1. If more than 1 overlay colour is available (dependent upon the current PLANES setting), another overlay colour may be selected using this command. The available colours are displayed in the legend.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the LABEL and LABEL COLOUR commands.


*** ERROR *** Specifying command LABEL
Command qualifiers are POSITION, COLOUR, or SIZE


*** ERROR *** Specifying command LABEL COLOUR
Command requires an integer in the range 1 to "numcol"

--------------------------------------------------------------------------------
Examples:

Rover>LABEL COLOUR 3
Rover>

LABEL POSITION

--------------------------------------------------------------------------------
LABEL POSITION

--------------------------------------------------------------------------------

FORMAT:		LABEL POSITION screenx screeny

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The position of the user annotation is defined

The position is specified in screen pixel units, with respect to the SW corner of the screen.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the LABEL and LABEL POSITION commands.


*** ERROR *** Specifying command LABEL
Command qualifiers are POSITION, COLOUR, or SIZE


*** ERROR *** Specifying command LABEL POSITION
Command requires 2 reals in the range 0 to and 0 to

--------------------------------------------------------------------------------
Examples:

Rover>LABEL POSITION 400 200
Rover>

LABEL SIZE

--------------------------------------------------------------------------------
LABEL SIZE

--------------------------------------------------------------------------------

FORMAT:		LABEL SIZE font-size

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The command LABEL SIZE is used to define the size of any text output to a graphics screen using the DRAW LABEL command.

The font_size parameter controls the relative size of the text; size 1 is the smallest, and size 4 is the largest. The actual size of the output text screen will vary with the size of the graphics device screen, though the relative sizes of the text will remain constant.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the LABEL and LABEL SIZE commands.


*** ERROR *** Specifying command LABEL
Command qualifiers are POSITION, COLOUR, or SIZE


*** ERROR *** Specifying command LABEL SIZE
Command requires an integer in the range 1 to 4

--------------------------------------------------------------------------------
Examples:

Rover>LABEL SIZE 3
Rover>

LEFT

--------------------------------------------------------------------------------
LEFT

--------------------------------------------------------------------------------

FORMAT:		LEFT

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

LEFT moves the raster editing cursor to the left by one DTI pixel.

The command is only available in edit or registration modes of operation

Puck button 8 is defined as LEFT.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the LEFT command.


*** ERROR *** Specifying command LEFT
Command only available in EDIT or REGISTRATION modes

--------------------------------------------------------------------------------
Examples:

Edit>LEFT
Edit>

LEGEND POSITION

--------------------------------------------------------------------------------
LEGEND POSITION

--------------------------------------------------------------------------------

FORMAT:		LEGEND POSITION screenx screeny

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The position of the legend is defined

The position is specified in screen pixel units, with respect to the bottom left corner of the screen.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the LEGEND and LEGEND POSITION commands.


*** ERROR *** Specifying command LEGEND
Command qualifier is POSITION


*** ERROR *** Specifying command LEGEND POSITION
Command requires 2 reals in the range 0 to and 0 to

--------------------------------------------------------------------------------
Examples:

Rover>LEGEND POSITION 400 200
Rover>

LUT

--------------------------------------------------------------------------------
LUT

--------------------------------------------------------------------------------

FORMAT:	        LUT  file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command is used to read in a new look up colour table. The colour table is a file containing the RGB definitions for a series of colour values. These values are used when images are displayed on the screen.

The default colour table which is read in on program initialisation is ROVER5.DAT, but these colour values may be subsequently changed by use of the LUT command.

The colour table that is read in should be appropriate for the current PLANES settings, in order to achieve correct display of both raster and vector information.

See the introductory description section for further information on the compilation of colour tables. An example lookup table is shown in Appendix A.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the LUT command.


*** ERROR *** Specifying command LUT
Filename is missing

--------------------------------------------------------------------------------
Examples:

Rover>LUT ROVERG6
Rover>

--------------------------------------------------------------------------------
MODTEN

--------------------------------------------------------------------------------

FORMAT:	        MODTEN

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

MODTEN causes redisplay of the currently selected DTI file using a remainder of a division by 10 function. The resulting image displays the DTI values in one of 10 shades of grey depending on the value of the last digit. Thus 53 and 73 are both displayed with the same grey value. Because local differences in DTI value are emphasised, MODTEN is a useful tool for terrain model validation.

MODTEN makes use of one of the standard greyscale ROVER lookup tables depending on the current PLANES setting. Subsequent displays after a MODTEN display revert to the original lookup table.

--------------------------------------------------------------------------------
Messages: _None

--------------------------------------------------------------------------------
Examples:

Rover>MODTEN
Rover>

--------------------------------------------------------------------------------
MESSAGE

--------------------------------------------------------------------------------

FORMAT:	        MESSAGE text

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command outputs the specified text to the terminal.

This command is useful to use in Rover Command Files to pass information before a RESPOND command returns control to the user.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the MESSAGE command.


*** ERROR *** Specifying command MESSAGE
"System error message"

--------------------------------------------------------------------------------
Examples:

Rover>MESSAGE ERROR HERE
Rover>

--------------------------------------------------------------------------------
MOVE

--------------------------------------------------------------------------------

FORMAT:	        MOVE   x_position y_position

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command moves the DTI editing cursor to the specified coordinates. The status values on the screen reflect the current cursor position in DTI matrix coordinates and underlying colour. The SHOW POSITION command may be used to examine the position in the current UNITS of measurement.

If a position outside the current DTI window is specified then an implicit ZOOM 1 command around the new position is obeyed.

This command may also be issued by moving the mouse or trackerball within the displayed area.

This command is only available in EDIT and REGISTRATION modes of operation.

Puck button 0 is defined to be move if a map has been registered with the SETUP MAP command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the MOVE command.


*** ERROR *** Specifying command MOVE
Command requires 2 integer arguments


*** ERROR *** Specifying command MOVE
Supplied coordinates exceed file extents


*** ERROR *** Specifying command MOVE
Command only available in EDIT and REGISTRATION modes

--------------------------------------------------------------------------------
Examples:

Rover>MOVE 20 20
Rover>

OPEN RCP_FILE COMMAND

--------------------------------------------------------------------------------
OPEN RCP_FILE

The command OPEN RCP_FILE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:	        OPEN RCP_FILE file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The OPEN RCP_FILE command is used to open and read the contents of an existing Registration Control Point file. The file will most likely have been created during an earlier ROVER session.

Up to 4 RCP files may be opened. The SELECT RCP command controls which RCP file is current. By default, the current file is the most recent RCP file to be opened or created using the OPEN RCP_FILE and CREATE RCP_FILE commands. The contents of the current RCP file may be examined using the SHOW RCP command.

Entries in the current RCP file may be deleted or edited using the RCP DELETE and RCP EDIT commands, and new entries may be added to the file using the RCP ADD command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the OPEN and OPEN RCP_FILE commands:


*** ERROR *** Specifying command OPEN RCP_FILE
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command OPEN RCP_FILE
RCP Filename is missing

*** ERROR *** Specifying command OPEN RCP_FILE
Maximum number of RCP files already open
Use the CLOSE RCP_FILE command to close a file

*** ERROR ***  Reading RCP file 
File contains more than 200 RCPs

*** ERROR ***  Reading RCP file 
RCP identifier missing for RCP number 

*** ERROR ***  Reading RCP file 
RCP Type missing for RCP number 

*** ERROR ***  Reading RCP file 
X value for RCP number  has invalid format

*** ERROR ***  Reading RCP file 
Y value for RCP number  has invalid format

*** ERROR ***  Reading RCP file 
Z value for RCP number  has invalid format

*** ERROR ***  Reading RCP file 
XY weight value for RCP number  has invalid format

*** ERROR ***  Reading RCP file 
Z weight value for RCP number  has invalid format

File  opened as RCP File Number 

--------------------------------------------------------------------------------
Examples:

Registration>OPEN RCP_FILE CONTROL<CR>
Registration>

OUTPUT

--------------------------------------------------------------------------------
OUTPUT

--------------------------------------------------------------------------------

FORMAT:	        OUTPUT file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

An output IFF file can be specified to receive data generated using the program's digitising option using this command. A new output file is always opened. It is not possible to digitise to an existing file.

The output file uses the corner values and map descriptor information from the input IFF file if one is open. Digitised coordinates will also be in the units of the input IFF file. Otherwise, header information is copied from the projection record if one is present in the currently selected DTI file. Appropriate units are used depending on the type of the DTI file. If the input file is a TED4 or UHL1 file then units are in tenths of seconds. Projection units are used for DTI files containing a projection record. Otherwise DTI matrix units are used.

This command is only valid if a map has been registered to the DTI file. If an output IFF file is already open then it is first closed before the new file is open.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the OUTPUT command.


*** ERROR *** Specifying command OUTPUT
Command invalid without a map registered


*** ERROR *** Specifying command OUTPUT
Command only available in DIGITISE mode


*** ERROR *** Specifying command OUTPUT
Filename is missing

--------------------------------------------------------------------------------
Examples:

Rover>OUTPUT DIGSTUFF.IFF
Rover>

OVERLAY

--------------------------------------------------------------------------------
OVERLAY

--------------------------------------------------------------------------------

FORMAT:		 OVERLAY

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

OVERLAY causes any IFF features currently selected in the IFF file to be drawn in Picture 2 in the current quadrant position.

The graphical representation of features is determined by FRT lookup on the basis of their feature code. The colour used to draw the data may be set using the SET COLOUR command. The representation of features may also be changed by the ENABLE POSITIONING, ENABLE HEIGHT, ENABLE HATCH, ENABLE INTERPOLATION, ENABLE OVERRIDE, ENABLE TEXT and SCALE commands.

The displayed map is scaled so that it occupies the same area on the screen as the previously displayed raster information. Registration with the raster image is achieved by selecting an IFFWINDOW to cover the same area as the DTI window. This is achieved automatically if files contain absolute origin offset information in their headers.

Typing (Pressing the Ctrl and C keys together) causes the current OVERLAY operation to be aborted.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the OVERLAY command.


*** ERROR *** Specifying command OVERLAY
Command requires that an IFF file is open

--------------------------------------------------------------------------------
Examples:

Rover>OVERLAY
Rover>

PING

--------------------------------------------------------------------------------
PING

--------------------------------------------------------------------------------

FORMAT:		 PING

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command causes a warning bell sound to be made at the terminal.

PING may be a useful command in ROVER Command Files to indicate that control has returned to the user after a RESPOND command has been issued.

--------------------------------------------------------------------------------
Messages: _None

--------------------------------------------------------------------------------
Examples:

Rover>PING
Rover>

PLANES

--------------------------------------------------------------------------------
PLANES

--------------------------------------------------------------------------------

FORMAT:		 PLANES numplanes

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

PLANES defines the number of bit-planes on a graphics device, and therefore the number of colours, that will be used to display the raster information in Picture 1.

By default a set of 5 contiguous planes are allocated to Picture 1. If 5 planes are defined, then 32 colours are available for the picture 1 although it should be noted that only 29 colours will actually be used for display, since the first 3 colours have a special use.

The remaining planes on an 8 bit-plane graphics device are used for the display of any vector overlay drawn using the OVERLAY command, and for any annotation generated using the DRAW LABEL command. With a planes setting of 5, 7 overlay and annotation colours are available. The LABEL COLOUR command may be used to select the annotation colour, while the colour entry in the FRT determines in what colour, different overlay features are shown.

It should be noted that after giving the PLANES command, a default colour table appropriate to the number of planes, is read. The effect of this will either be seen immediately if a DTI file is already displayed.

Further information on the default colour tables, and the use of the PLANES command may be found in the introductory description section.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the PLANES command.


*** ERROR *** Specifying command PLANES
Command not available during an edit operation.


*** ERROR *** Specifying command PLANES
Command requires 1 integer argument in the range 5 to 8

--------------------------------------------------------------------------------
Examples:

Rover>PLANES 5
Rover>PLANES 8
Rover>

QUADRANT

--------------------------------------------------------------------------------
QUADRANT

--------------------------------------------------------------------------------

FORMAT:		 QUADRANT quadrant_number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command enables the user to control which quadrant becomes current for display purposes.

The SHOW DEVICE command outputs information about which DTI file is currently associated with each quadrant.

This command is not valid in EDIT or REGISTRATION modes and is only valid if use of a quartered screen has been enabled using the ENABLE DIVIDE command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the QUADRANT command.


*** ERROR *** Specifying command QUADRANT
Command not available in EDIT or REGISTRATION modes.


*** ERROR *** Specifying command QUADRANT
Command requires an integer in the range 1 to 4


*** ERROR *** Specifying command QUADRANT
Command not valid unless the ENABLE DIVIDE command has been given

--------------------------------------------------------------------------------
Examples:

Rover>QUADRANT 4
Rover>ENLARGE
Rover>QUADRANT 2
Rover>DISPLAY
Rover>

RANGE

--------------------------------------------------------------------------------
RANGE

--------------------------------------------------------------------------------

FORMAT:		 RANGE lowval upval

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The command is used to specify a lower and upper range of DTI values for the currently selected DTI file. Values outside this range will be displayed in black on the screen when the DISPLAY command is given.

Issue of the RANGE command always preserves the current STEP settings. If there are by consequence too few colours to show all the steps in the range, then the upper steps are displayed in white.

The current range values, along with the current range values stored in the file header and in the current DTI window, may be shown using the SHOW RANGES command.

In EDIT or REGISTRATION modes the RANGE command causes automatic redisplay of the currently selected DTI file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the RANGE command.


*** ERROR *** Specifying command RANGE
Command requires two integer arguments


*** ERROR *** Specifying command RANGE
Lower value exceeds upper value


*** ERROR *** Specifying command RANGE
Command not available during editing operation.


*** WARNING *** specified values exceed header range
Values will be truncated


*** WARNING *** specified values exceed program range limits of
-32766 to 32766
Values will be truncated

--------------------------------------------------------------------------------
Examples:

Rover>RANGE 400 700
Rover>

RCP ADD

--------------------------------------------------------------------------------
RCP ADD

The command RCP ADD is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 RCP ADD x_coord y_coord

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The RCP ADD command is used to add a Registration Control Point to the currently selected RCP file.

The command parameters define the x and y position of the RCP. The parameters may be supplied on the command line, or may be recorded by pressing the middle button on the workstation mouse, or button 4 on the table puck if a map has been set up on the table. The coordinates of the RCP must lie within the geographical bounds of the DTM, or the corners of the map positioned on the table.

The DISABLE/ENABLE DEFAULT RCP commands control whether the user is prompted for additional RCP information. For example, if the command DISABLE DEFAULT RCP_ID has been given, then the user is prompted to enter an RCP identifier. The SET DEFAULT RCP commands control the default value that is supplied with a prompt, and which may be accepted using carriage return. By default no prompting for additional RCP information occurs, and the RCP fields are assigned their default values.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the RCP and RCP ADD commands


*** ERROR *** Specifying command RCP
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command RCP
No RCP files are currently open

*** ERROR *** Specifying command RCP
Currently selected RCP file is not open

*** ERROR *** Specifying command RCP
Command qualifiers are ADD, DELETE, EDIT or MOVE

*** ERROR *** Specifying command RCP ADD
Command requires 2 x y coordinates

*** ERROR *** Specifying command RCP ADD
RCP coordinates outside geographical bounds of DTI file 

RCP with coordinates  
and ID  added to RCP File Number 

--------------------------------------------------------------------------------
Examples:

Registration>RCP ADD 1.2 1.3

RCP with coordinates 1.2 1.3
and ID 1          added to RCP File Number 1

Registration>DISABLE DEFAULT RCP_ID
Registration>RCP ADD 1.32 4.56
Enter RCP ID (Default = 2) TEST
RCP with coordinates 1.32 4.56
and ID TEST       added to RCP File Number 1

Registration>

RCP DELETE

--------------------------------------------------------------------------------
RCP DELETE

The command RCP DELETE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 RCP DELETE rcp_identifier

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The RCP DELETE command is used to remove a Registration Control Point from the currently selected RCP file. The rcp_identifier determines which RCP is deleted.

Note that once deleted from the file, a RCP cannot be recovered.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the RCP and RCP DELETE commands


*** ERROR *** Specifying command RCP
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command RCP
No RCP files are currently open

*** ERROR *** Specifying command RCP
Currently selected RCP file is not open

*** ERROR *** Specifying command RCP
Command qualifiers are ADD, DELETE, EDIT or MOVE

*** ERROR *** Specifying command RCP DELETE
Command requires a RCP Identifier

*** ERROR *** Specifying command RCP DELETE
No RCP with identifier  found in RCP file number 

RCP with ID  deleted from RCP file number 

--------------------------------------------------------------------------------
Examples:

Registration>RCP ADD 1.2 1.3

RCP with coordinates 1.2 1.3
and ID 1            added to RCP File Number 1

Registration>RCP DELETE 1
RCP with ID 1           deleted from RCP File number 1

Registration>

RCP EDIT

--------------------------------------------------------------------------------
RCP EDIT

The command RCP EDIT is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 RCP EDIT rcp_identifier

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The RCP EDIT command is used to edit an existing Registration Control Point in the currently selected RCP file. The rcp_identifier determines which RCP is edited.

On giving the command, the screen cross cursor is positioned on the RCP location. (If the location is outside the current screen window, then a zoom with a factor of 1 is carried out around the RCP location). The user is then prompted for all RCP attributes, including a RCP identifier and RCP x y coordinates. The existing value or values are supplied as the default with each prompt, and may be accepted by pressing carriage return.

New RCP coordinates may be entered from the terminal, or by pressing the middle button on the workstation mouse, or button 4 on the table puck if a map has been set up on the table.

The new values (including the RCP identifier) replace the existing RCP values.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the RCP and RCP EDIT commands


*** ERROR *** Specifying command RCP
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command RCP
No RCP files are currently open

*** ERROR *** Specifying command RCP
Currently selected RCP file is not open

*** ERROR *** Specifying command RCP
Command qualifiers are ADD, DELETE, EDIT or MOVE

*** ERROR *** Specifying command RCP EDIT
Command requires a RCP Identifier

*** ERROR *** Specifying command RCP EDIT
No RCP with identifier  found in RCP file number 

RCP with ID  selected for edit

--------------------------------------------------------------------------------
Examples:

Registration>RCP ADD 1.2 1.3

RCP with coordinates 1.2 1.3
and ID 1            added to RCP File Number 1

Registration>RCP EDIT 1
Enter RCP ID (Default = 1) >
Enter RCP Type (Default = AA) >
Enter X Y Coordinates (Default = 1.2 1.3) >1.45 4.6<CR>
Enter Z value (Default = 0.0) >
Enter X Y weight (Default = 1.0) >
Enter Z weight (Default = 0.0) >
Registration>

RCP MOVE

--------------------------------------------------------------------------------
RCP MOVE

The command RCP MOVE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 RCP MOVE rcp_identifier

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The RCP MOVE command is used to position the screen cursor on a Registration Control Point recorded in the currently selected RCP file. For example, the command RCP MOVE 1 will move the cursor to the location of an RCP with an identifier of 1.

If the coordinates of the RCP define a point outside the current screen window, then a zoom with a factor of 1 is carried out around the RCP position.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the RCP and RCP MOVE commands


*** ERROR *** Specifying command RCP
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command RCP
No RCP files are currently open

*** ERROR *** Specifying command RCP
Currently selected RCP file is not open

*** ERROR *** Specifying command RCP
Command qualifiers are ADD, DELETE, EDIT or MOVE

*** ERROR *** Specifying command RCP MOVE
Command requires a RCP Identifier

*** ERROR *** Specifying command RCP MOVE
RCP lies outside the geographical bounds of the DTM

*** ERROR *** Specifying command RCP MOVE
No RCP with identifier  found in RCP file number 

RCP with ID  selected for edit

--------------------------------------------------------------------------------
Examples:

Registration>RCP ADD 1.2 1.3

RCP with coordinates 1.2 1.3
and ID 1            added to RCP File Number 1

Registration>RCP MOVE 1
Registration>

REDUCE

--------------------------------------------------------------------------------
^REDUCE

--------------------------------------------------------------------------------

FORMAT:	        REDUCE

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The screen image is reduced by a factor of 2 using pixel replication. If the command is repeatedly given the display will continue to be reduced until the minimum magnification is reached.

Puck button 3 is defined as REDUCE.

This command has no effect on a graphics device which does not support hardware pixel replication. The ZOOM command offers an alternative way of reducing the image on such a device.

--------------------------------------------------------------------------------
Messages:
Display is at maximum magnification

--------------------------------------------------------------------------------
Examples:

Rover>REDUCE
Rover>

REMOVE

--------------------------------------------------------------------------------
^REMOVE

--------------------------------------------------------------------------------

FORMAT:	        REMOVE

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

Remove is the raster editing command to remove the latest edited point from the current line being edited. Thus it cancels the effect of the previous EDIT command, and all pixels on the line joining the current point to the previous point are redrawn in their original colour.

A series of REMOVE commands may be used to cancel several previous EDIT commands.

This command is only available in EDIT mode of operation.

Mouse or function button 3 and puck button 7 are defined to be REMOVE.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the REMOVE command.


*** ERROR *** Specifying command REMOVE
Command only available in EDIT mode

--------------------------------------------------------------------------------
Examples:

Line>REMOVE
Line>

RESET_MINMAX

--------------------------------------------------------------------------------
RESET_MINMAX

--------------------------------------------------------------------------------

FORMAT:		RESET_MINMAX

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

RESET_MINMAX updates the minimum and maximum values in the headers of those files which have been opened for write access by the UPDATE_FILEIN command.

An Implicit RESET_MINMAX command is carried out by ROVER on issue of the DISABLE EDIT command, to ensure that any edits which have been performed on the file are reflected in the file header.

RESET_MINMAX also shows the current values of window, program and file ranges.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the RESET_MINMAX command.


*** ERROR *** Specifying command RESET_MINMAX
Command not available during editing operation

--------------------------------------------------------------------------------
Examples:

Edit>RESET_MINMAX
Updating minimum and maximum values - Please wait

File Range          : 0   to 1344
Window Range        : 25  to 681
Current Range       : 400 to 700
.end  lit
.BR;Edit>
.!******************************************************************************
.PAGE
.SUBTITLE   RESPOND
.P0
^*--------------------------------------------------------------------------------\*
.BR;^*RESPOND\*
.INDEX ROVER Commands> RESPOND
.INDEX ROVER> RESPOND command

.LM +8
.p 0;Returns program control to the terminal in a Rover Command File
.LM -8

.P0
^*--------------------------------------------------------------------------------
.LIT
FORMAT:		RESPOND

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

RESPOND is used within a Rover Command File to pass control back to the terminal. The user may again type commands in response to the program prompt. Command file execution may be resumed on issue of the CONTINUE command. RESPOND is only valid within a Rover command file.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the RESPOND command


*** ERROR *** Specifying command RESPOND
Command only valid in Rover Command File

--------------------------------------------------------------------------------
Example:

Rover>RESPOND
Rover>

RIGHT

--------------------------------------------------------------------------------
RIGHT

--------------------------------------------------------------------------------

FORMAT:		RIGHT

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

RIGHT moves the raster editing cursor to the right by one DTI pixel.

The command is only available in EDIT or REGISTRATION modes of operation.

Puck button A is defined as RIGHT.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the RIGHT command.


*** ERROR *** Specifying command RIGHT
Command only available in EDIT or REGISTRATION modes

--------------------------------------------------------------------------------
Examples:

Edit>RIGHT
Edit>

ROTATE

--------------------------------------------------------------------------------
ROTATE

--------------------------------------------------------------------------------

FORMAT:		 ROTATE direction

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command allows the user to specify the direction from which the currently selected DTI file is to be displayed using the FAST and DISPLAY commands .

The default direction is determined from the rotation value (DTI_ORDER_CORNER) held in the header of an LSLA DTI file.

On some display devices display speeds may be better in certain directions than others.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the ROTATE command


*** ERROR *** Specifying command ROTATE
Command not available during edit operation.


*** ERROR *** Specifying command ROTATE
Command Keywords are NORTH, SOUTH, EAST or WEST

--------------------------------------------------------------------------------
Examples:

Rover>ROTATE EAST
Rover>FAST
Rover>

SAMPLE

--------------------------------------------------------------------------------
SAMPLE

--------------------------------------------------------------------------------

FORMAT:	        SAMPLE column_interval row_interval

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

SAMPLE is used to define the intervals at which columns and rows of the currently selected DTI file are sampled during display.

By default all nodes in the current window are displayed. (ie. a sample interval of 1 along both the columns and rows).

The ENABLE SAMPLE command must be given before the defined sample values take effect.

Note that the sampling intervals may be automatically reset if a window, specified explicitly with the WINDOW command or implicitly with the ZOOM command, is too large to be displayed with the current sample values in the display area. A warning message is output when this occurs.

The current sample values may be viewed using the SHOW FILES command.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SAMPLE command:


*** ERROR *** Specifying command SAMPLE
Command requires at least one integer argument


*** ERROR *** Specifying command SAMPLE
X sample interval should be in the range 1 to N


*** ERROR *** Specifying command SAMPLE
Y sample interval should be in the range 1 to N


*** ERROR *** Specifying command SAMPLE
Command requires that a DTI file is open


*** ERROR *** Specifying command SAMPLE
Command not available in EDIT mode.

--------------------------------------------------------------------------------
Examples:

Rover>SAMPLE 2
Rover>

SCALE

--------------------------------------------------------------------------------
SCALE

--------------------------------------------------------------------------------

FORMAT:		 SCALE factor

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command is used to scale the symbols, text and hatching parameters for output of vector information with the OVERLAY command. The values specified in the FRT table are enlarged by the specified factor.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SCALE command:


*** ERROR *** Specifying command SCALE
Command requires a positive real number

--------------------------------------------------------------------------------
Examples:

Rover>SCALE 2.5
Rover>

SELECT ALL

--------------------------------------------------------------------------------
SELECT ALL

--------------------------------------------------------------------------------

FORMAT:	        SELECT ALL

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

This command resets all features to be selected for overlay. If features are subsequently selected using the other SELECT commands then all features are first implicitly deselected.

This command is only valid after a FRT file has been specified.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SELECT command.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE


*** ERROR *** Specifying command SELECT ALL
Command invalid before FRT has been read

--------------------------------------------------------------------------------
Examples:

Rover>SELECT ALL


Rover>SELECT FSN 7-10,56-78
Rover>SELECT FSN 11-20


Rover>

SELECT FC

--------------------------------------------------------------------------------
SELECT FC

--------------------------------------------------------------------------------

FORMAT:         SELECT FC feature_code [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT FC command is used to include IFF features for vector overlay. Features are included on the basis of their feature code.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The SELECT FC command is only valid if the FRT command has been used to select a Feature Representation Table.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SELECT and SELECT FC commands.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE


*** ERROR *** Specifying command SELECT FC
Command invalid before FRT has been read


*** ERROR *** Specifying command SELECT FC
No groups have been defined in the FRT


*** ERROR *** Specifying command SELECT FC
Max number of SEL/DES commands allowed exceeded


*** ERROR *** Specifying command SELECT FC
Illegal feature code "feature_code"


*** ERROR *** Specifying command SELECT FC
Bad group name "group"

--------------------------------------------------------------------------------
Examples:

Rover>SELECT FC 1
Rover>SELECT FC RAILWAYS
Rover>SELECT FC RAIL 7-10,56-78
Rover>

SELECT FILEIN

--------------------------------------------------------------------------------
SELECT FILEIN

--------------------------------------------------------------------------------

FORMAT:		 SELECT FILEIN file-number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command sets the DTI file with the assigned number to be the current DTI file. Commands such as WINDOW, UNITS, STEP, RANGE, FIRST and COLOURS are applied to the DTI file currently selected using the SELECT FILEIN command .

If EDIT mode is enabled then editing may only be performed on the currently selected DTI file. In quartered screen mode, this command allows up to 4 different files to be edited on the same display. The currently selected file has the Editing status information displayed at the bottom of the quadrant. If the currently selected DTI file is not displayed then issue of this command causes automatic DISPLAY.

By default the current DTI file is the file last opened using the FILEIN command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SELECT and SELECT FILEIN commands.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE


*** ERROR *** Specifying command SELECT FILEIN
Command requires an integer argument in the range 1 to 4


*** ERROR *** Specifying command SELECT FILEIN
Command not valid during edit operation


*** ERROR *** Specifying command SELECT FILEIN
Input DTI file not yet opened

--------------------------------------------------------------------------------
Examples:

Rover>SELECT FILEIN 3
Rover>SELECT FILEIN 2
Rover>

SELECT FSN

--------------------------------------------------------------------------------
SELECT FSN

--------------------------------------------------------------------------------

FORMAT:         SELECT FSN fsn [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT FSN command is used to include IFF features for vector overlay. Features are included on the basis of their feature serial number.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The SELECT FSN command is only valid if an IFF file has been specified and the FRT command has been used to select a Feature Representation Table.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SELECT and SELECT FSN commands.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE


*** ERROR *** Specifying command SELECT FSN
Command invalid before FRT has been read


*** ERROR *** Specifying command SELECT FSN
Illegal FSN number "fsn"

--------------------------------------------------------------------------------
Examples:

Rover>SELECT FSN 1
Rover>SELECT FSN 7-10,56-78
Rover>

SELECT LAYER

--------------------------------------------------------------------------------
SELECT LAYER

--------------------------------------------------------------------------------

FORMAT:         SELECT LAYER layer [,...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT LAYER command is used to include IFF features for vector overlay. Features are included on the basis of their layer number.

By default ROVER will use all features within an IFF file.

Use of the SHOW SELECTIONS command is recommended to display feature selections before the OVERLAY command is given.

The SELECT LAYER command is only valid if the FRT command has been used to select a Feature Representation Table.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SELECT and SELECT LAYER commands.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE


*** ERROR *** Specifying command SELECT LAYER
Command invalid before FRT has been read


*** ERROR *** Specifying command SELECT LAYER
Illegal LAYER number "layer"

--------------------------------------------------------------------------------
Examples:

Rover>SELECT LAYER 1
Rover>SELECT LAYER 2-5,7-9
Rover>

SELECT RCP_FILE COMMAND

--------------------------------------------------------------------------------
SELECT RCP_FILE

The command SELECT RCP_FILE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 SELECT RCP_FILE number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SELECT RCP_FILE command is used to select and make current a Registration Control Point (RCP) file.

The commands RCP ADD, RCP DELETE, RCP EDIT and RCP MOVE operate on entries only in the currently selected RCP file.

By default, the RCP file most recently created or opened using the CREATE RCP_FILE or OPEN RCP_FILE commands is selected as the current RCP file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SELECT and SELECT RCP_FILE commands.


*** ERROR *** Specifying command SELECT
Command qualifiers are ALL, FC, FILEIN, FSN, LAYER or RCP_FILE

*** ERROR *** Specifying command SELECT RCP_FILE
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command SELECT RCP_FILE
Command requires a RCP file number

*** ERROR *** Specifying command SELECT RCP_FILE
Command requires a RCP file number in the range 1 to 4

*** ERROR *** Specifying command SELECT RCP_FILE
RCP file number  is not open

--------------------------------------------------------------------------------
Examples:

Registration>SELECT RCP_FILE 3
Registration>

SET COLOUR

--------------------------------------------------------------------------------
SET COLOUR

--------------------------------------------------------------------------------

FORMAT:		 SET COLOUR overlay_colour

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

SET COLOUR determines the colour of any vector information subsequently output to Picture 2. The available colours are displayed in the legend. SET COLOUR FRT bases colour selection on the FRT lookup and is the default mode of operation.

The current overlay colour is displayed with the SHOW PARAMETERS command.

SET COLOUR 0 sets the overlay to the background colour, and may be used to selectively erase overlaid features in Picture 2. Note that if no information has been overlaid, setting the colour to 0 will result in no information being drawn.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET COLOUR commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET COLOUR
Command requires an integer in the range 0 to "numcol" or the FRT qualifier

--------------------------------------------------------------------------------
Examples:

Rover>SET COLOUR 4
Rover>SET COLOUR FRT
Rover>

SET CURSOR_COLOUR

--------------------------------------------------------------------------------
SET CURSOR_COLOUR

--------------------------------------------------------------------------------

FORMAT:		 SET CURSOR_COLOUR colour

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command allows the square raster editing cursor to be changed in colour. By default the cursor is drawn in colour 1 of the colour table which is black in the standard ROVER colour tables. Any of the current PICTURE 1 colours may however be selected using this command.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET CURSOR_COLOUR commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET CURSOR_COLOUR
Command requires an integer argument in range 1 to"numcol"


*** ERROR *** Specifying command SET CURSOR_COLOUR
Command only available in EDIT mode

--------------------------------------------------------------------------------
Examples:

Rover>SET CURSOR_COLOUR 20
Rover>

SET DEFAULT RCP_TYPE

--------------------------------------------------------------------------------
SET DEFAULT RCP_TYPE

The command SET DEFAULT RCP_TYPE is only available in REGISTRATION mode.

--------------------------------------------------------------------------------

FORMAT:		 SET DEFAULT RCP_TYPE identifier

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SET DEFAULT RCP_TYPE command allows a user to define the default RCP Type identifier.

This identifier will be automatically attached to a Registration Control Point when the RCP ADD is given, unless DISABLE DEFAULT RCP_TYPE has been specified. If the DISABLE DEFAULT RCP_TYPE command has been given, the RCP Type identifier will be supplied as a default value that may be accepted by pressing carriage return in response to the prompt 'Enter RCP TYPE>'

The default RCP_TYPE identifier is XX.

The current RCP_TYPE value may be examined using the SHOW SETTINGS command when in REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET, SET DEFAULT and SET DEFAULT RCP_TYPE commands:


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR__COLOUR, DEFAULT, DELAY, FC, 
FSN or LAYER 

*** ERROR *** Specifying command SET DEFAULT
Command qualifiers are RCP_TYPE, RCP_Z, RCP_WZ, or RCP_WXY

*** ERROR *** Specifying command SET DEFAULT
The command is only valid in REGISTRATION mode

*** ERROR *** Specifying command SET DEFAULT RCP_TYPE
Command requires a RCP Type value

--------------------------------------------------------------------------------
Examples:

Registration>SET DEFAULT RCP_TYPE AA
Registration>

SET DEFAULT RCP_WXY

--------------------------------------------------------------------------------
SET DEFAULT RCP_WXY

The command SET DEFAULT RCP_WXY is only available in REGISTRATION mode.

--------------------------------------------------------------------------------

FORMAT:		 SET DEFAULT RCP_WXY weight

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SET DEFAULT RCP_WXY command allows a user to define the default RCP XY coordinate weight. The weight value is used to assign a confidence factor to the RCP x and y coordinates.

The weight value will be automatically attached to a Registration Control Point when the RCP ADD is given, unless DISABLE DEFAULT RCP_WXY has been specified. If the DISABLE DEFAULT RCP_WXY command has been given, the weight value will be supplied as a default value that may be accepted by pressing carriage return in response to the prompt 'Enter XY weight >'

The default RCP_WXY value is 1.0

The current RCP_WXY value may be examined using the SHOW SETTINGS command when in REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET, SET DEFAULT and SET DEFAULT RCP_WXY commands:


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR__COLOUR, DEFAULT, DELAY, FC, 
FSN or LAYER 

*** ERROR *** Specifying command SET DEFAULT
Command qualifiers are RCP_TYPE, RCP_Z, RCP_WZ, or RCP_WXY

*** ERROR *** Specifying command SET DEFAULT
The command is only valid in REGISTRATION mode

*** ERROR *** Specifying command SET DEFAULT RCP_WXY
Command requires an XY weight value

--------------------------------------------------------------------------------
Examples:

Registration>SET DEFAULT RCP_WXY 0.5
Registration>

SET DEFAULT RCP_WZ

--------------------------------------------------------------------------------
SET DEFAULT RCP_WZ

The command SET DEFAULT RCP_WZ is only available in REGISTRATION mode.

--------------------------------------------------------------------------------

FORMAT:		 SET DEFAULT RCP_WZ weight

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SET DEFAULT RCP_WZ command allows a user to define the default RCP Z coordinate weight. The weight value is used to assign a confidence factor to the RCP Z coordinate.

The weight value will be automatically attached to a Registration Control Point when the RCP ADD is given, unless DISABLE DEFAULT RCP_Z has been specified. If the DISABLE DEFAULT RCP_Z command has been given, the weight value will be supplied as a default value that may be accepted by pressing carriage return in response to the prompt 'Enter Z weight >'

The default RCP_WZ value is 0, unless a RCP Z coordinate has been specified, when a weighting value of 1.0 is assumed.

The current RCP_WZ value may be examined using the SHOW SETTINGS command when in REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET, SET DEFAULT and SET DEFAULT RCP_WZ commands:


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR__COLOUR, DEFAULT, DELAY, FC, 
FSN or LAYER 

*** ERROR *** Specifying command SET DEFAULT
Command qualifiers are RCP_TYPE, RCP_Z, RCP_WZ, or RCP_WXY

*** ERROR *** Specifying command SET DEFAULT
The command is only valid in REGISTRATION mode

*** ERROR *** Specifying command SET DEFAULT RCP_WZ
Command requires a Z weight value

--------------------------------------------------------------------------------
Examples:

Registration>SET DEFAULT RCP_WZ 0.5
Registration>

SET DEFAULT RCP_Z

--------------------------------------------------------------------------------
SET DEFAULT RCP_Z

The command SET DEFAULT RCP_Z is only available in REGISTRATION mode.

--------------------------------------------------------------------------------

FORMAT:		 SET DEFAULT RCP_Z coordinate

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SET DEFAULT RCP_Z command allows a user to define the default RCP Z coordinate value.

The Z value will be automatically attached to a Registration Control Point when the RCP ADD is given, unless DISABLE DEFAULT RCP_Z has been specified. If the DISABLE DEFAULT RCP_Z command has been given, the Z value will be supplied as a default value that may be accepted by pressing carriage return in response to the prompt 'Enter Z value >'

The default RCP_Z value is 0

The current RCP_Z value may be examined using the SHOW SETTINGS command when in REGISTRATION mode.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET, SET DEFAULT and SET DEFAULT RCP_Z commands:


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR__COLOUR, DEFAULT, DELAY, FC, 
FSN or LAYER 

*** ERROR *** Specifying command SET DEFAULT
Command qualifiers are RCP_TYPE, RCP_Z, RCP_WZ, or RCP_WXY

*** ERROR *** Specifying command SET DEFAULT
The command is only valid in REGISTRATION mode

*** ERROR *** Specifying command SET DEFAULT RCP_WXY
Command requires a Z value

--------------------------------------------------------------------------------
Examples:

Registration>SET DEFAULT RCP_Z 100.0
Registration>

SET DELAY

--------------------------------------------------------------------------------
SET DELAY

--------------------------------------------------------------------------------

FORMAT:		 SET DELAY delay_time

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The SET DELAY command may be used to control the delay time between successive cursor updates on the screen. If the cursor seems to lag behind the movement of the mouse or trackerball, then the default value of 100 milliseconds should be increased.

A suitable delay setting may depend on the size of the window displayed and also on the amount of graphics activity taking place on the workstation.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET DELAY commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET DELAY
Command requires a positive integer

--------------------------------------------------------------------------------
Examples:

Rover>SET DELAY 200
Rover>

SET FC

--------------------------------------------------------------------------------
SET FC

--------------------------------------------------------------------------------

FORMAT:		 SET FC number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command enables the feature code to be set for the next feature to be constructed. This command is only available in the DIGITISE mode operation.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET FC commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET FC
Command only available in DIGITISE mode


*** ERROR *** Specifying command SET FC
Command requires integer in the range 0 to 32767

--------------------------------------------------------------------------------
Examples:

Rover>SET FC 5
Rover>

SET FSN

--------------------------------------------------------------------------------
SET FSN

--------------------------------------------------------------------------------

FORMAT:		 SET FSN number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The command enables the feature serial number to be set for the next feature to be constructed. The command is only available in DIGITISE mode of operation.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET FSN commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET FSN
Command only available in DIGITISE mode


*** ERROR *** Specifying command SET FSN
Command requires integer in the range 0 to 65534

--------------------------------------------------------------------------------
Examples:

Rover>SET FSN 3
Rover>

SET LAYER

--------------------------------------------------------------------------------
SET LAYER

--------------------------------------------------------------------------------

FORMAT:		 SET LAYER number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The command enables the layer number to be set for the next feature to be constructed. It is only available in DIGITISE mode of operation.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SET and SET LAYER commands.


*** ERROR *** Specifying command SET
Command qualifiers are COLOUR, CURSOR_COLOUR, DEFAULT, DELAY, FC,
FSN, or LAYER


*** ERROR *** Specifying command SET LAYER
Command only available in DIGITISE mode


*** ERROR *** Specifying command SET LAYER
Command requires integer in the range 0 to 32767

--------------------------------------------------------------------------------
Examples:

Rover>SET LAYER 3
Rover>

SETUP MAP

--------------------------------------------------------------------------------
SETUP MAP

--------------------------------------------------------------------------------

FORMAT:	        SETUP MAP

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The SETUP MAP command allows a source document to be registered to the currently selected DTI file.

In order to register the map and a DTI file , the file should have first been specified, and a source document should have been securely attached to the surface of a digitising table.

On giving the command you will be asked to digitise 4 rectangular registration points. The registration points represent 4 points on the map that correspond to the 4 corners of the DTI file. The points are digitised in the order top left (NW), bottom left (SW), bottom right (SE) and top right (NE) using any button on the table puck. A point should be digitised in response to a prompt on the terminal.
An error message is generated if any of the angles of the digitised rectangle are less than 88 degrees, or greater than 92 degrees (ie. if the corner points of the rectangle are more than 2 degrees off rectangular). In this case you will be asked to redigitise the 4 registration points.
Setup of the map may be aborted using (pressing the Ctrl and Z keys together), or by pressing Button F on the table puck.

Following the registration of a map to the file , coordinate values required by the WINDOW and CENTRE commands, may be input using an appropriate button on the table puck.

Map registration also allows the DIGITISE mode of operation to be invoked with the ENABLE DIGITISE command.

If EDIT or REGISTRATION modes are enabled then cursor movement may be achieved using table puck coordinate input.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SETUP MAP commands


*** ERROR *** Specifying command SETUP
SETUP qualifier is MAP


*** ERROR *** Specifying command SETUP MAP
Command not valid without table


*** ERROR *** Specifying command SETUP MAP
No input file yet opened


*** ERROR *** digitising corners
More than 2 degrees off square - repeat

--------------------------------------------------------------------------------
Examples:

Rover>SETUP MAP
Map NW Corner>
Map SW Corner>
Map SE Corner>
Map NE Corner>

SHOW ANNOTATION

--------------------------------------------------------------------------------
SHOW ANNOTATION

--------------------------------------------------------------------------------

FORMAT:		 SHOW ANNOTATION

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

Details of labelling and legend positions for the currently selected DTI file are output to the terminal. The label size and colour index are also displayed.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW ANNOTATION


Current label  setting:
Position: X 400  Y 500   Size 3  Colour 2
Current legend setting:
Position: X 100 Y 100

Rover>

SHOW DEVICE

--------------------------------------------------------------------------------
SHOW DEVICE

--------------------------------------------------------------------------------

FORMAT:		 SHOW DEVICE

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

Details of which DTI file is currently associated with which display quadrant are output to the terminal. The current viewing direction as specified by the ROTATE command is also output.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW DEVICE


Current quadrant setting:
DTI File 1:     Quadrant 2
DTI File 2:     Quadrant 4
Current viewing direction is from the East


Rover>

SHOW ENABLE COMMAND

--------------------------------------------------------------------------------
SHOW ENABLE

--------------------------------------------------------------------------------

FORMAT:		 SHOW ENABLE

--------------------------------------------------------------------------------
Command parameters: None.

--------------------------------------------------------------------------------
DESCRIPTION:

Displays the current status of all the ROVER options that may be enabled or disabled using the ENABLE and DISABLE commands.

The name of the option is shown, followed by either the word ON or OFF to indicate its current status.

If the command SHOW ENABLE is used before any ENABLE or DISABLE commands have been given, the default status of the options is displayed.
If the command is given in REGISTRATION mode, then the current status of various registration options are also displayed.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

ROVER>SHOW ENABLE


Current status:

ABSOLUTE         On        CROSS_CURSOR     Off      COLOUR_MAP       Off      

DIGITISE         Off       DIVIDE           Off      EDIT             On    

FLOODING         Off       HATCH            Off      HEIGHT           On  

INTERPOLATION    On        LEGEND           On       MASK             Off     

OVERRIDE         Off       PATTERN          On       PICTURE 1        On

PICTURE 2        Off       POSITIONING      Off      REGISTRATION     Off

SAMPLE           Off       TABLE            Off      TEXT             Off


Rover>ENABLE REGISTRATION
Registration>SHOW ENABLE

Current status:

ABSOLUTE         On        CROSS_CURSOR     Off      COLOUR_MAP       Off      

DIGITISE         Off       DIVIDE           Off      EDIT             On    

FLOODING         Off       HATCH            Off      HEIGHT           On  

INTERPOLATION    On        LEGEND           On       MASK             Off     

OVERRIDE         Off       PATTERN          On       PICTURE 1        On

PICTURE 2        Off       POSITIONING      Off      REGISTRATION     On

SAMPLE           Off       TABLE            Off      TEXT             Off

DEFAULT RCP_ID   On        DEFAULT RCP_TYPE On       DEFAULT RCP_WXY  On

DEFAULT RCP_WZ   On        DEFAULT RCP_Z    On


Registration>

SHOW FILEIN

--------------------------------------------------------------------------------
SHOW FILEIN

--------------------------------------------------------------------------------

FORMAT:		 SHOW FILEIN

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

Details of the currently selected DTI file are displayed on the terminal.

The header values are shown in the current units of measurement. This is dependent on the header type of the input file, or may be set explicitly using the UNITS command. By default or if the ENABLE ABSOLUTE command has been given then metre or projection values are expressed in absolute values. Otherwise they are displayed as offsets from the SW corner of the matrix.

If the ENABLE SAMPLE command has been given then the X and Y sample values for the currently selected DTI file are also output.

The DTI file number as required by the SELECT FILEIN command is also displayed.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW FILEIN

File    :  LSL$DTI:TEST.DTI
Header  :   LSLA Data:  WORD

Units are DTI Matrix Value

Matrix Coverage   SW:     1      1  NE:   301   251
Matrix Window     SW:     1      1  NE:   200   200
Matrix Interval    E:     1          N:     1
Value Range         :     0    to    851

DTI File  1


Rover>

SHOW IFF

--------------------------------------------------------------------------------
SHOW IFF

--------------------------------------------------------------------------------

FORMAT:		 SHOW IFF

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The name of the IFF file, and the IFF coordinate range and window settings are shown. By default or if the ENABLE ABSOLUTE command has been given, then the coordinates are expressed as absolute values. Otherwise they are displayed as offset values from the SW corner of the file area.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW IFF


IFF file:       LSL$IF:TEST.IFF
IFF file range:
SW: 270000.00 180000.00   NE: 310000.00  220000.00
IFF file window :
SW: 280000.00 190000.00   NE: 320000.00  190000.00


Rover>

SHOW PARAMETERS

--------------------------------------------------------------------------------
SHOW PARAMETERS

--------------------------------------------------------------------------------

FORMAT:		 SHOW PARAMETERS

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

Details of the current range and step settings,step upper limits and associated colour indices are output for the currently selected DTI file. The current overlay colour and in EDIT mode editing cursor colour are also shown.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW PARAMETERS


Range	       : 200 to 300
Number of steps   : 10
Step upper limits : 210 220 230 240 250 260 270 280 290 300
Colour indices    :  3   6   9  12  15  18  21  24  27  30
Number of Colours : 31
First Colour      : 2
Planes Setting    : 5


Rover>

SHOW POSITION

--------------------------------------------------------------------------------
SHOW POSITION

--------------------------------------------------------------------------------

FORMAT:		 SHOW POSITION

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

In EDIT mode SHOW POSITION outputs to the terminal the current editing cursor position. The values are shown in the current units of measurement. By default or if the ENABLE ABSOLUTE command has been given then metre or projection values are expressed in absolute values. Otherwise they are displayed as offsets from the SW corner of the matrix. The DTI value at this position is also shown.

In DIGITISE mode the command outputs the current position of the digitising cursor in IFF coordinates.

SHOW POSITION is only valid in DIGITISE or EDIT modes of operation.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SHOW and SHOW POSITION commands.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS


*** ERROR *** Specifying command SHOW POSITION
Command only valid in EDIT or DIGITISE modes

--------------------------------------------------------------------------------
Examples:

Edit>SHOW POSITION


Editing Cursor Position:
X:    35       Y:    234
DTI Value: 345

Digitise>SHOW POSITION


Digitising Cursor Position
X:   3457.30   Y:   6789.88

SHOW RANGES

--------------------------------------------------------------------------------
SHOW RANGES

--------------------------------------------------------------------------------

FORMAT:		 SHOW RANGES

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

SHOW RANGES outputs information about value ranges for the currently selected DTI file to the terminal. The file range stored in the file header, the range of values in the current WINDOW, and the current range as specified with the RANGE command are shown. The WINDOW range may require to be calculated by this command. This may take an appreciable time for large windows.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.

*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Edit>SHOW RANGES


File Range          : 0  to  1344
Window Range        : 567 to 789
Current Range       : 400 to 700


Rover>

SHOW RCP_FILE COMMAND

--------------------------------------------------------------------------------
SHOW RCP_FILE

The command SHOW RCP_FILE is only available in registration mode.

--------------------------------------------------------------------------------

FORMAT:		 SHOW RCP_FILE

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

The SHOW RCP_FILE command is used to display the contents of the currently selected Registration Control Point (RCP) file.

An RCP file may be made current using the SELECT RCP_FILE command. By default the file most recently opened or created using the OPEN RCP_FILE and CREATE RCP_FILES commands, is selected as the current RCP file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SHOW and SHOW RCP_FILE commands:


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN, 
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE SELECTIONS or SETTINGS

*** ERROR *** Specifying command SHOW RCP_FILE
Command only valid in REGISTRATION mode

*** ERROR *** Specifying command SHOW RCP_FILE
No RCP files are currently open

*** ERROR *** Specifying command SHOW RCP_FILE
Currently selected RCP file is not open

--------------------------------------------------------------------------------
Examples:

Registration>SHOW RCP_FILE



Registration>

SHOW SELECTIONS

--------------------------------------------------------------------------------
SHOW SELECTIONS

--------------------------------------------------------------------------------

FORMAT:		 SHOW SELECTIONS

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

The currently active selections made with the SELECT and DESELECT commands are listed.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW SELECTIONS

All Layers Selected
All Feature Codes Selected
All FSNs selected
Currently selected colour 6

Currently Selected DTI file: 2
File: LSL$DTI:TEST.DTI
Rover> 

SHOW SETTINGS

--------------------------------------------------------------------------------
SHOW SETTINGS

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------

FORMAT:		 SHOW SETTINGS

--------------------------------------------------------------------------------
DESCRIPTION:

Displays the name of all ROVER parameters that may be set using the SET command, and their current values.

If the SHOW SETTINGS command is given before using a SET command, the values shown are the default values that are allocated to the parameters by ROVER.
If the command is given in REGISTRATION mode, then the current RCP attribute values are also displayed.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SHOW command.


*** ERROR *** Specifying command SHOW
Command qualifiers are ANNOTATION, DEVICE, ENABLE, FILEIN,
IFF, PARAMETERS, POSITION, RANGES, RCP_FILE, SELECTIONS or SETTINGS

--------------------------------------------------------------------------------
Examples:

Rover>SHOW SETTINGS

Current Settings:

FC           1	        LAYER          2          FSN            6

COLOUR       2          CURSOR_COLOUR  7	  DELAY        100


Rover>ENABLE REGISTRATION
Registration>SHOW SETTINGS
Current Settings:

FC           1	        LAYER          2          FSN            6

COLOUR       2          CURSOR_COLOUR  7	  DELAY        100

RCP_TYPE    XX          RCP_WXY        1.0        RCP_WZ         0.0

RCP_Z        0.0

Registration>

SMOOTH_EDIT

--------------------------------------------------------------------------------
SMOOTH_EDIT

--------------------------------------------------------------------------------

FORMAT:		SMOOTH_EDIT

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

SMOOTH_EDIT command specifies that the next editing sequence of commands will specify two lines between which DTI values will be interpolated.

A sequence of EDIT and MOVE commands are used to define the first line. On issue of the END command the user is prompted for a DTI value. If no value is given (carriage return is pressed) the existing values of that line are assumed. The second line should then be specified in a similar way. On completion of the second line, values between the two lines are linearly interpolated. Appropriate messages guide the user through the sequence of commands required.

The SMOOTH_EDIT command is only available in EDIT mode of operation.

To indicate that smooth editing is taking place the program prompt becomes 'Smooth>' during the editing operation.

ABANDON or (pressing the Ctrl and Z keys together) will abort the smooth editing operation operation.

Puck button D is defined to be SMOOTH_EDIT.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the SMOOTH_EDIT command.


*** ERROR *** specifying command SMOOTH_EDIT
Command only available in EDIT mode


*** ERROR *** specifying command SMOOTH_EDIT
Selected DTI file is opened read-only


*** ERROR *** specifying command SMOOTH_EDIT
Command not available during edit operation

--------------------------------------------------------------------------------
Examples:

Edit>SMOOTH_EDIT
Please define first line
Smooth>MOVE 50 50
Smooth>EDIT
Smooth>MOVE 50 60
Smooth>EDIT
Smooth>END
Smooth> DTI Value> 500
Please define second line
Smooth>MOVE 55 50
Smooth>EDIT
Smooth>MOVE 55 60
Smooth>EDIT
Smooth>END
Smooth> DTI Value>
Edit>

SPAWN

--------------------------------------------------------------------------------
SPAWN

--------------------------------------------------------------------------------

FORMAT:		 SPAWN command

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

SPAWN allows a DCL command to be obeyed from within the ROVER program. This is to allow file management operations such as DIRECTORY, DELETE and RENAME to be carried out during program execution.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SPAWN command.


*** ERROR *** Specifying command SPAWN
SPAWN requires a valid DCL command

--------------------------------------------------------------------------------
Examples:

Rover>SPAWN DIRECTORY LSL$DTI

Directory DUA0:[DTI]

AFRICA.DTI;2      LS41.DTI;1       WALES.DTI;3         TEST.DTI;13

Total of 3 files

Rover>SPAWN RENAME AFRICA.DTI SOUTHAMERICA.DTI
Rover>

SRI

--------------------------------------------------------------------------------
SRI

--------------------------------------------------------------------------------

FORMAT:		 SRI file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The specified SRI file is selected.

The SRI determines the graphical representation of point symbols, and symbol strings.

If this command is omitted before the OVERLAY command then an SRI with the same name as the supplied FRT will be opened. If such a file does not exist then this command is required before OVERLAY is issued.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the SRI command.


*** ERROR *** Specifying command SRI
"System error message"

--------------------------------------------------------------------------------
Examples:

Rover>SRI OS.SRI
Rover>

START

--------------------------------------------------------------------------------
START

--------------------------------------------------------------------------------

FORMAT:		 START

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

The construction of an IFF feature is started using the program's digitising option. A crosshair cursor will appear on the screen, and the prompt 'Digitise Point>' will be output on the terminal, to show that a feature is being constructed.

This command is only available in DIGITISE mode of operation.

Puck button 4 is defined as START.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the START command.


*** ERROR *** Specifying command START
Command only available in DIGITISE mode

--------------------------------------------------------------------------------
Examples:

Digitise>START
Digitise Point>

STEP

--------------------------------------------------------------------------------
STEP

--------------------------------------------------------------------------------

FORMAT:		 STEP values[...]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command divides the values in the currently selected DTI file into a series of steps which are displayed in different colours.

One or more DTI step intervals may be defined using this command for the currently selected DTI file. A single value denotes a constant step interval, while a variable step interval may be defined by entering up to 7 values.

A constant step interval, derived by dividing the minimum and maximum values in the DTI file by the number of display colours, is set up by default on opening a DTI file. The COLOURS and FIRST_COLOUR commands also reset the STEP in this way.

If a single step value of 1 is given, then each step is associated with a single colour on display. The legend reflects this situation as each value is placed alongside the centre of each box.

If step intervals are set such that there are too few colours to display all the steps, then the upper steps will be displayed in white.

The colour index that will be associated with each step may by examined by means of the command SHOW PARAMETERS.

In EDIT mode this command causes automatic redisplay of the currently selected DTI file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the STEP command.


*** ERROR *** Specifying command STEP
Command requires at least one integer argument


*** ERROR *** Specifying command STEP
Step values should greater than 1


*** WARNING *** range exceeded
step "step_number" is truncated to "DTI-value"


*** WARNING *** Too many steps for available colours
Upper steps shown in white

--------------------------------------------------------------------------------
Examples:

Rover>STEP 100
Rover>

Rover>STEP 5 5 10 10 50 50 100
Rover>

TABLE RCP_FILE COMMAND

--------------------------------------------------------------------------------
TABLE RCP_FILE

--------------------------------------------------------------------------------

FORMAT:		 TABLE RCP_FILE number

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The TABLE RCP_FILE command is used to select the Registration Control Point (RCP) file into which RCPs recorded using the table puck and digitising table will be entered.

By default RCPs entered from the table will be added to the current RCP file selected using the SELECT RCP_FILE command, however the TABLE RCP_FILE command may be used to allocate a particular RCP file to the table. This option, when utilised with the SETUP MAP command given in REGISTRATION mode, allows a user to enter map control points from the table, and image control points from the terminal or workstation mouse, without the need to redefine which RCP file is current.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the TABLE RCP_FILE command


*** ERROR *** Specifying command TABLE
Command qualifier is RCP_FILE


*** ERROR *** Specifying command TABLE
Command only valid in REGISTRATION mode


*** ERROR *** Specifying command TABLE
Command requires an integer argument in the range 1 to 4

--------------------------------------------------------------------------------
Examples:

Registration>TABLE RCP_FILE 2
Registration>

TOLERANCE

--------------------------------------------------------------------------------
TOLERANCE

--------------------------------------------------------------------------------

FORMAT:		    TOLERANCE [a b c]

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command affects how interpolated lines are output with the OVERLAY command.

The three coefficients (a,b,c) control the spacing of interpolated points. The approximate separation of points (d) is given by:


 		d = a + 2*SQRT(2br) + cr (r is radius of curvature)
	      
which means (if other coefficients were zero ) that 

		a gives a constant separation of A IFF units
		b gives a constant 'arc to chord' distance of b IFF units
		c gives a constant angular deviation of c radians

--------------------------------------------------------------------------------
Examples:

Rover>TOLERANCE 250 100 1.5
Rover>

TRI

--------------------------------------------------------------------------------
TRI

--------------------------------------------------------------------------------

FORMAT:		 TRI file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The specified TRI file is selected.

The TRI file is used to determine the font characteristics of IFF text features drawn in Picture 2 using the OVERLAY command.

If this command is omitted before the OVERLAY command then a TRI with the same name as the supplied FRT will be opened. If such a file does not exist then this command is required before OVERLAY is issued.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the TRI command.


*** ERROR *** Specifying command TRI
"System error message"

--------------------------------------------------------------------------------
Examples:

Rover>TRI OS.TRI
Rover>

UNITS COMMAND

--------------------------------------------------------------------------------
UNITS

--------------------------------------------------------------------------------
FORMAT: UNITS units

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The UNITS command defines the units of measurement that will be used when defining an area of interest in the currently selected DTI file by means of the WINDOW command, and for specifying the editing cursor position with the MOVE command
The command also controls in what format details from the header of the DTI file are displayed, when the SHOW FILEIN command is given.

The command should be given after defining the an DTI file since an appropriate default units of measurement is set up when the file is opened.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the UNITS command.


*** ERROR *** Specifying command UNITS
Command should be followed by MATRIX, METRES, LATLONG, SECONDS or PROJECTION
Current setting is "units"


*** ERROR *** Specifying command UNITS
Command qualifier is invalid for the input file

--------------------------------------------------------------------------------
Examples:


Rover> UNITS MATRIX<CR>
Rover>

UP

--------------------------------------------------------------------------------
UP

--------------------------------------------------------------------------------

FORMAT:		UP

--------------------------------------------------------------------------------
Command parameters: _None

--------------------------------------------------------------------------------
DESCRIPTION:

UP moves the raster editing cursor up by one DTI pixel.

The command is only available if ENABLE EDIT has been specified.

Puck button 9 is defined as UP.

--------------------------------------------------------------------------------
Messages:


The following message is specific to the UP command.


*** ERROR *** Specifying command UP
Command only available in EDIT or REGISTRATION modes

--------------------------------------------------------------------------------
Examples:

Edit>UP
Edit>

UPDATE_FILEIN

--------------------------------------------------------------------------------
UPDATE_FILEIN

--------------------------------------------------------------------------------

FORMAT:	        UPDATE_FILEIN  file-spec

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command opens and maps into memory a DTI file for write access. The file is opened on the lowest available DTI file number. The DTI file number is displayed on the terminal, and is the means by which the file is selected when a number of DTI files are opened.

Up to 4 DTI files may be opened at one time. By default the DTI file opened with the last FILEIN or UPDATE_FILEIN command is the current DTI file. If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest is set for the file based on the maximum window which may be displayed in the default display area on the graphics device at four times magnification. Otherwise if ENABLE SAMPLE has not been specified a window corresponding to the entire file extents is set unless this is too large to be displayed in which case truncation takes place. The area of interest may be altered at any time by use of the WINDOW command.

If the rotation value (DTI_ORDER_CORNER) held in the header of the DTI file is not the default, (south west) then a warning message is output when the file is opened. Rover however, sets up the viewing direction taking into account the rotation value. Thus, provided the rotation value in the header is correct, Rover will display the file in the correct orientation. The ROTATE command be used to change the default viewing direction.

Information on the mapped DTI file may be obtained at any time by typing 'SHOW FILEIN'

This command is required if editing operations are to be carried out on the file. (cf FILEIN)

In EDIT mode issue of the UPDATE_FILEIN command results in automatic display of the file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the UPDATE_FILEIN command.


*** ERROR *** Specifying command UPDATE_FILEIN
Four DTI are currently opened
CLOSE command should be used


*** ERROR *** Specifying command UPDATE_FILEIN
Filename is missing

--------------------------------------------------------------------------------
Example:

Rover>UPDATE_FILEIN TEST

*** File LSL$DTI:TEST.DTI opened as DTI file 1

File    :  LSL$DTI:TEST.DTI
Header  :   LSLA Data:  WORD

Units are DTI Matrix Value

Matrix Coverage   SW:     1      1  NE:   301   251
Matrix Interval    E:     1          N:     1
Value Range         :     0    to    851

Rover>

WAIT

--------------------------------------------------------------------------------
WAIT

--------------------------------------------------------------------------------

FORMAT:		 WAIT interval

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

This command suspends program execution for the specified time interval. It is useful for demonstration purposes if ROVER is being run from a command file.

--------------------------------------------------------------------------------
Messages:


The following messages are specific to the WAIT command.


*** ERROR *** Specifying command WAIT
Command requires a real in the range 1 to 1000

--------------------------------------------------------------------------------
Examples:

Rover>WAIT 5.0
Rover>

WINDOW COMMAND

--------------------------------------------------------------------------------
WINDOW

--------------------------------------------------------------------------------

FORMAT:		WINDOW  xmin ymin xmax ymax

--------------------------------------------------------------------------------
Command parameters:

--------------------------------------------------------------------------------
DESCRIPTION:

The WINDOW command is used to limit display to a particular rectangular geographical area. Only nodes in the DTI file that lie within this area are drawn when the DISPLAY command is given.
The area of interest should lie within the geographical bounds of the DTI file.

If the logical name LSL$MATRIX_DEFAULT_WINDOW is defined with a value of "1", then a default area of interest is set for the file based on the maximum window which may be displayed in the default display area on the graphics device at four times magnification. Otherwise a window corresponding to the entire file extents is set unless this is too large to be displayed or ENABLE SAMPLE has not been specified in which case truncation takes place.

If a digitising table is available, and a map has been registered to the DTI file, the coordinates of the window may be defined using any button on the table puck.

If an input IFF file is open then the WINDOW command also causes the IFFWINDOW to be reset in order to maintain matrix/vector registration.

In EDIT mode issue of this command causes immediate redisplay of the new window.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the WINDOW command:


*** ERROR *** Specifying command WINDOW
Command not available during editing operation


*** ERROR *** Specifying command WINDOW
Command requires 4 coordinate values


*** ERROR *** Specifying command WINDOW
DTI file "dtinum" has not yet been opened


*** ERROR *** Specifying command WINDOW
NE coordinates should exceed SW coordinates


*** ERROR *** Specifying command WINDOW
Unable to use supplied LAT LONG values


*** WARNING *** Specified window exceeds matrix limits
Window will be truncated to fit

--------------------------------------------------------------------------------
Examples:

ROVER>WINDOW 1 1 200 200
ROVER>UNITS LATLONG
ROVER>WINDOW 42 00 00N 3 00 00E 42 30 00N 2 58 40E
ROVER>

ZOOM

--------------------------------------------------------------------------------
ZOOM

--------------------------------------------------------------------------------

FORMAT:		 ZOOM [factor]

--------------------------------------------------------------------------------
Command parameters:_None

--------------------------------------------------------------------------------
DESCRIPTION:

ZOOM resets the current raster and IFF windows depending on the zoom factor. The default zoom factor is two. This halves the size of the window, and therefore increases the scale of the displayed image. A scale factor of between 0 and 1 increases the size of the window. In EDIT mode the new window is centred around the current DTI cursor coordinates.

If many ZOOM commands will be used during a Rover session then it is recommended that the colour mapping option is invoked with the ENABLE COLOUR_MAP command. This improves the efficiency of raster display.

--------------------------------------------------------------------------------
Messages:

The following messages are specific to the ZOOM command:


*** ERROR *** Specifying command ZOOM
Command takes 1 positive real argument


*** ERROR *** Specifying command ZOOM
Command not available during editing operation

--------------------------------------------------------------------------------
Examples:

Rover>ZOOM 4
Rover>

MESSAGES (WARNING)

--------------------------------------------------------------------------------

MESSAGES (WARNING) _NONE

MESSAGES (ERROR)

--------------------------------------------------------------------------------

MESSAGES (ERROR) _NONE

MESSAGES (FATAL)

--------------------------------------------------------------------------------

MESSAGES (FATAL) _NONE

MESSAGES (OTHER)

--------------------------------------------------------------------------------

MESSAGES (OTHER)

In addition to messages which are generated by the program itself, other messages may be produced by Laser-Scan libraries. In particular, messages may be generated the DTI library, and by the Laser-Scan I/O library, LSLLIB.

DTI library messages are introduced by '%DTI', and are documented in the DTILIB Reference Manual. In all cases the messages indicate a fatal error, that will cause processing to halt.

LSLLIB messages are introduced by '%LSLLIB' and are generally self-explanatory. Such messages rarely indicate a fatal error, and are generated most frequently by entering a command in an invalid format in response to the ROVER prompt.

APPENDIX A

--------------------------------------------------------------------------------

APPENDIX A


; system constants file for ROVER
; 5 planes picture 1  3 planes picture 2
; COLOUR DEFINITIONS
;	Red	Green	Blue	Blink	Comment
256					; number of colours
	 0	 0	 0	 0	; 1 for background
	FF	FF 	FF	 0	; 2 white
	80	80	FF	 0	; 3 blue
	50	80	20	 0	; 4
	50	90	30	 0	; 5
	70	90	30	 0	; 6
	78	A0	20	 0	; 7
	71	B1	 0	 0	; 8
	71	C1	 0	 0	; 9
	61	E1	10	 0	; 10
	10	EE	10	 0	; 11
	41	EE	10	 0	; 12
	61	EE	10	 0	; 13
	81	EE	10	 0	; 14
	91	EE	10	 0	; 15
	A0	EE	10	 0	; 16
	B0	EE	10	 0	; 17
	CA	EE	10	 0	; 18
	DB	EE	10	 0	; 19
	EE	EE	10	 0	; 20
	EE	E0	10	 0	; 21
	EE	D0	10	 0	; 22
	EE	BA	10	 0	; 23
	EE	A9	10	 0	; 24
	EE	B0	10	 0	; 25
	EE	A0	10	 0	; 26
	EE	98	10	 0	; 27
	EE	8A	10	 0	; 28
	EE	7E	10	 0	; 29
	EE	77	10	 0	; 30
	EE	6E	10	 0	; 31
	EE	61	10	 0	; 32
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	FF	FF	 0	; white
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	FF	 0	 0	 0	; red
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0      FF       0       0      ; green
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	 0	 0	FF	 0	; blue
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	80      80       0       0      ; brown
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      80       0       0      ; orange
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
	FF      FF       0       0      ; yellow
;
; BLINK DEFINITIONS
;	Blink	On	Off	Comment
	1	6	6	; generator 1
	2	6	6	; generator 2
	3	6	6	; generator 3
	4	6	6	; generator 4