GU

Graphics utility.

Formats

GU COLORS
GU DEL name
GU LIST string
GU MAKE level color bframe eframe [keyword]
GU MAKE level c1 c2 c3 bframe eframe [keyword]
GU OFF level bframe eframe
GU ON level bframe eframe
GU REST name bframe eframe
GU SAVE name frame
GU TABLE name [keyword]

Parameters

COLORS	lists the predefined colors in the MCRGB.TXT data file for use in the color parameter
DEL	deletes a graphics file
LIST	lists the saved graphics files
MAKE	sets the graphics color levels
OFF	turns a graphics color level off
ON	turns a graphics color level on
REST	restores a saved graphics file (default)
SAVE	saves the current graphics table to a file
TABLE	lists the values in a graphics file
name	graphics file name; do not specify an extension, for example, .GRX (REST option default=default table; TABLE option default=current; no default for DEL and SAVE options)
string	lists only the graphics files beginning with this character string (no default; list all graphics files)
level	graphics color level (OFF and ON options default=all levels; MAKE option default=0)
color	predefined color to apply to level (default=BLACK); use GU COLORS to list the valid colors
bframe	beginning graphics frame number on which to apply the graphics color level changes (default=current)
eframe	ending graphics frame number on which to apply the graphics color level changes (default=bframe)
c1	intensity of the first color component to apply to level
c2	intensity of the second color component to apply to level
c3	intensity of the third color component to apply to level; the valid range for parameters c1, c2 and c3 is 0 to 255 (default=0); the first color component is either blue or red, the second color component is green, the third color component is either red or blue; see the Remarks for more information
frame	graphics frame number displaying the graphics table to save (default=current)

Keyword

RGB=	YES	changes the order of the color components from the default (blue-green-red) to red-green-blue in the MAKE option's c1, c2 and c3 input parameters and the TABLE option's output listing
	NO	keeps the default order of the color components (default)

Remarks

The default file extension for the LIST, REST, SAVE and TABLE options is .GRX.

Parameters c1, c2 and c3 are the intensities (0-255) of the three color components that make up the final color applied to level. The RGB keyword determines the order in which the three color components are specified:

If RGB=YES is specified, then the color order is red, green, blue (c1 is RED intensity, c2 is GREEN intensity, and c3 is BLUE intensity).
If RGB=NO (the default), then the color order is blue, green, red (c1 is BLUE intensity, c2 is GREEN intensity, and c3 is RED intensity).

Examples

This entry restores the default graphics table to the current graphics frame.

GU MAKE 4 WHITE 1 3

This entry sets graphics color level 4 to white for graphics frames 1, 2 and 3.

GU OFF 4 1 3

This entry turns graphics color level 4 off on graphics frames 1, 2 and 3.

GU TABLE

This entry lists the values in the current graphics table.