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:


Examples

GU

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.