GOPTIONS statement

GOPTIONS options;

The options that are most commonly used are listed alphabetically below.

Note: Options marked with an asterisk (*) can be specified in either a GOPTIONS or an OPTIONS statement.

Option

Description

NOBORDER

BORDER

Causes a line (or border) to be drawn around the display. The default is NOBORDER.

CBACK=color

Specifies the color of the background on certain graphics terminals.

CBY=color

FBY=typefont

HBY=height

Specifies the color, type font, and height of any BY lines that appear. When you use a BY statement with a SAS procedure to process a data set in subgroups, each page printed by that procedure is headed by a BY line giving values of the BY variables that define the current subgroup of observations. If FBY= is omitted, the hardware character set is used to print BY lines. If you specify HBY=0, the BY lines do not appear. If CBY= is omitted, the first color in the COLORS= list (see the COLORS= option) is used. If HBY= is omitted, the height used is the default character size. If you specify HBY=0, the BY lines do not appear.

COLORS=(list)

Specifies the colors used to produce your displays if you do not want to use the default colors for your device. If you omit the COLORS= option, SAS/GRAPH uses any colors you specify in SAS/GRAPH statements and the default colors for your device to produce your displays. [SAS/GRAPH User's Guide: page. 469-483]

If you are using a pen plotter, SAS/GRAPH uses the colors in the COLORS= list to define the order of pens for a multiple pen plotter or to make a single pen plotter behave like a multiple pen plotter when it chooses colors automatically. You can specify the four colors in a COLORS= list; G3D chooses the first color for the title, the second for the axes, the third for the bottom surface, and the fourth for the top surface, just as it would do if you were using a four-color pen plotter.

CPATTERN=color

Specifies the default color to be used in PATTERN statements when a color has not been specified.

CSYMBOL=color

Specifies the default color to be used in SYMBOL statements when a color has not been specified.

CTITLE=color

FTITLE=typefont

Specifies default color and type font values. CTITLE= gives the default color to be used for all TITLE and FOOTNOTE lines. FTITLE= gives the default type font to be used for the first TITLE line. If CTITLE= is omitted, the first color in the COLORS= list is used (see the COLORS= option); if FTITLE= is omitted, the COMPLEX font is used for the first TITLE line.

*DEVICE=drivername

tells SAS/GRAPH what graphics device you are using. If you are running SAS/GRAPH interactively and no device name has been specified, you are prompted to enter a device name. See the section Device-independent graphics with SAS/Graph for details on using various terminal and plotting devices at York.

DISPLAY

NODISPLAY

Specifies whether or not graphics are displayed on the device. Use NODISPLAY to generate graphics which are directed to a file such as a GOUT dataset, which can be replayed later with the DISPLAY option.

GUNIT=PCT

GUNIT=IN | CM

GUNIT=CELL

Specifies the unit of measurement to use with character height specifications in TITLE, FOOTNOTE, NOTE, and SYMBOL statements and the HBY= option. With these options, if you specify a value for height but do not specify an explicit unit, the value of GUNIT= is used. If you specify GUNIT=PCT, then the unit used is a percentage of the display area. If you specify GUNIT=IN, then the unit used is inches. If you specify GUNIT=CM, then the unit used is centimeters. If you specify GUNIT=CELL, then the unit used is character cells. The default value is GUNIT=CELL.

HSIZE=inches

VSIZE=inches

sets the size of the area to be used on the device for the graphics display. If HSIZE=0 and VSIZE=0 (the default) are specified, the full display area is used.

Note: On the ZETA plotter, the default HSIZE and VSIZE give an 8.5 times 11 in. display area. For some types of graphs, you may need to set HSIZE and VSIZE equal to the same value to give a square display environment, for example, to make circles appear round rather than egg shaped.

INTERPOL=value

Specifies the default interpolation value for a SYMBOL statement when the I= option has not been specified. See the chapter "Enhancing Your Graphics Output Designs" [SAS/GRAPH User's Guide: Chap. 5] interpolation routine values in SYMBOL statements.

PENMOUNTS=number

Specifies the number of active pens to use if you have plotters with multiple pens. You are prompted to change the pens after the number of pens specified by PENMOUNTS= has been used. For other devices, PENMOUNTS= can be used to tell SAS/GRAPH the number of colors that can be displayed at one time. The maximum allowed value is 256.

ROTATE

Causes the graph to be rotated 90 degrees on the device. ROTATE can only be specified with certain hardcopy devices.

VPOS=rows

HPOS=columns

are used to specify the number of rows and columns in your graphics display area. Note that HPOS= and VPOS= do not affect the size of the graphics area, but merely divide it into cells.

SAS/GRAPH determines the size of a character cell for the display based on the values specified in the VPOS= and HPOS= options. The width of the character is scaled to retain the normal aspect of the font. The larger the size of your VPOS= and HPOS= values, the smaller the size of each character cell.

The VPOS= and HPOS= values may range from 10 to 300. Setting HPOS=0 and VPOS=0 causes the driver to use the default hardware character cell size for the device. For example, on a Keynote terminal the display is 24 x 80 cells.