The GTESTIT Procedure

Overview

The GTESTIT procedure is a diagnostic tool for testing the installation of SAS/GRAPH software and the configuration of your device. Use the GTESTIT procedure when you want to

test a new device
test the settings of a device driver that you are developing
identify the colors and some of the SAS/GRAPH lines and fills for your device
review some of your current settings of device parameters and graphics options
test changes in settings of device parameters and graphics options.

The GTESTIT procedure produces three pictures that help you determine the configuration of your graphics device and graphics options and parameters. Refer to About the Pictures for examples of the pictures. Although it does not show the settings of all device parameters and graphics options, the GTESTIT procedure does show some of the most commonly used ones.

If you use a GOPTIONS statement to change one or more graphics options for the current SAS session, or if you run the GDEVICE procedure to change the parameter settings for your device, you can use the GTESTIT procedure to confirm that those changes took effect.

For example, if you use the GOPTIONS statement to set HPOS=45 and COLORS=(RED GREEN), you can display picture 1 in the GTESTIT procedure to confirm that the graphics output area is divided into 45 columns and that foreground colors have been limited to red and green.

See Graphics Options and Device Parameters Dictionary, The GDEVICE Procedure, and Device Drivers for more information on setting graphics options and device parameters.

About the Pictures

Picture 1 of the GTESTIT Procedure shows a test pattern and gives the values of some of the device settings that are currently in effect. GTESTIT Values Displayed in Picture 1 describes the graphics options and device parameters that are displayed in the picture. The values of most of the displayed settings are determined by device parameters that are specified in the catalog entry for the current device or by graphics options that are specified in a GOPTIONS statement.

Note: The following two statements do not return the same parameters when used with PICTURE=1: [cautionend]

goptions dev=xcolor target=ps nodisplay;
goptions dev=ps nodisplay;

The LOG window for picture 1, shown in Sample Log from GTESTIT Procedure, lists some of the same settings that are displayed by picture 1, plus some additional settings.

Picture 1 of the GTESTIT Procedure

[IMAGE]

Picture 2 tests your device's ability to draw lines. Picture 2 always displays in the first color of the current colors list. Picture 2 of the GTESTIT Procedure shows picture 2 of the GTESTIT procedure.

Picture 2 of the GTESTIT Procedure

[IMAGE]

Picture 3 tests your device's ability to draw simple polygons, polygons with multiple boundaries (also known as holes), ellipses, and justified text. Picture 3 of the GTESTIT Procedure shows picture 3 of the GTESTIT procedure.

Picture 3 of the GTESTIT Procedure

[IMAGE]

GTESTIT Values Displayed in Picture 1 explains the values displayed in picture 1 of the GTESTIT procedure. It also provides the equivalent graphics option or device parameter. Graphics Options and Device Parameters Dictionary includes a complete description of the graphics options and device parameters.

GTESTIT Values Displayed in Picture 1
GTESTIT Value Equivalent Graphics Option or Device Parameter Description

D= DEVICE= shows the device driver you are using.

R= VPOS= shows the number of rows.

C= HPOS= shows the number of columns.

P= MAXCOLORS= shows the total number of colors (foreground and background) that your device can display. If your device can display more than 15 colors, picture 1 shows only 15 colors, but the LOG window lists all of the available colors.

H= &#30 shows the height of character cells in pixels.

W= &#30 shows the width of character cells in pixels.

MAX= MAXPOLY= shows the maximum number of vertices that can be processed by a hardware polygon command. If MAX=0, then the number of vertices is unbounded. If MAX=***, then the value is greater than 999.

D= * DASHLINE= shows the hardware dashed-line patterns available. The value displayed is a hexadecimal string.

RF= * RECTFILL= shows the hardware rectangle-fill patterns available. The value displayed is a hexadecimal string.

S= * SYMBOLS= shows the hardware symbols available. The value displayed is a hexadecimal string.

OPTS= * DEVOPTS= shows the other hardware options available. The value displayed is a hexadecimal string.

NCOLORS= COLORS= shows the number of colors in the colors list or the number of foreground colors.

F= FILLINC= shows the solid fill increment (the number of pixels between strokes when doing a solid fill).

* In the device entry, this field may be blank. If blank, the value displayed by the GTESTIT procedure comes from an internal default in the device driver.

***GTESTIT Values Displayed in Picture 1***
GTESTIT Value	Equivalent Graphics Option or Device Parameter	Description
D=	DEVICE=	shows the device driver you are using.
R=	VPOS=	shows the number of rows.
C=	HPOS=	shows the number of columns.
P=	MAXCOLORS=	shows the total number of colors (foreground and background) that your device can display. If your device can display more than 15 colors, picture 1 shows only 15 colors, but the LOG window lists all of the available colors.
H=	&#30	shows the height of character cells in pixels.
W=	&#30	shows the width of character cells in pixels.
MAX=	MAXPOLY=	shows the maximum number of vertices that can be processed by a hardware polygon command. If MAX=0, then the number of vertices is unbounded. If MAX=***, then the value is greater than 999.
D= *	DASHLINE=	shows the hardware dashed-line patterns available. The value displayed is a hexadecimal string.
RF= *	RECTFILL=	shows the hardware rectangle-fill patterns available. The value displayed is a hexadecimal string.
S= *	SYMBOLS=	shows the hardware symbols available. The value displayed is a hexadecimal string.
OPTS= *	DEVOPTS=	shows the other hardware options available. The value displayed is a hexadecimal string.
NCOLORS=	COLORS=	shows the number of colors in the colors list or the number of foreground colors.
F=	FILLINC=	shows the solid fill increment (the number of pixels between strokes when doing a solid fill).
* In the device entry, this field may be blank. If blank, the value displayed by the GTESTIT procedure comes from an internal default in the device driver.

About the LOG

shows a sample of the information that appears in the LOG window after running picture 1 in the GTESTIT procedure. An asterisk (*) after the P=, MAX=, or F= option indicates that the value for that option is greater than 999.

Sample Log from GTESTIT Procedure

1 proc gtestit picture=1; 2 run; 3 quit; D=PSCOLOR B=1200 R= 25 C= 70 P=256 H= 16 W= 9 MAX=*** D=C000000000000000 RF=8000800000000000 S=0000000000000000 OPTS=D59A244009280000 NCOLORS= 1 Background color = WHITE Color 1 = BLACK Ratio = 0.71429 Hsize = 5.99539 Vsize = 4.28242 F=1

GTESTIT Values Shown in the LOG Window lists GTESTIT values that appear only in the LOG window for picture 1: these values do not appear in the picture itself. GTESTIT Values Shown in the LOG Window also provides the equivalent graphics option or device parameter. Graphics Options and Device Parameters Dictionary contains complete information about the graphics options and device parameters.

GTESTIT Values Shown in the LOG Window
GTESTIT Value Equivalent Graphics Option or Device Parameter Description

Background color= CBACK= tells the background color used.

Color1=...Colorn= COLORS= lists the default colors list for the device. N is equal to the NCOLORS= value.

Ratio= ASPECT= shows the aspect ratio of the device, which is the ratio of width to height of character cells.

Hsize= HSIZE= shows the horizontal size of the area used on the device for the graphics display. The default unit is inches.

Vsize= VSIZE= shows the vertical size of the area used on the device for the graphics display. The default unit is inches.

***GTESTIT Values Shown in the LOG Window***
GTESTIT Value	Equivalent Graphics Option or Device Parameter	Description
Background color=	CBACK=	tells the background color used.
Color1=...Colorn=	COLORS=	lists the default colors list for the device. N is equal to the NCOLORS= value.
Ratio=	ASPECT=	shows the aspect ratio of the device, which is the ratio of width to height of character cells.
Hsize=	HSIZE=	shows the horizontal size of the area used on the device for the graphics display. The default unit is inches.
Vsize=	VSIZE=	shows the vertical size of the area used on the device for the graphics display. The default unit is inches.

Chapter Contents
Previous
Next
Top of Page