Chapter 45: 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 on page 1286 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 Chapter 8, Graphics Options and Device Parameters Dictionary, on page 261, Chapter 31, The GDEVICE Procedure, on page 915, and Chapter 3, Device Drivers, on page 41 for more information on setting graphics options and device parameters.
About the Pictures
Figure 45.1 on page 1286 shows a test pattern and gives the values of some of the device settings that are currently in effect. Table 45.1 on page 1288 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.
Figure 45.1: Picture 1 of the GTESTIT Procedure
| GTESTIT Value | Equivalent Graphics Option or Device Parameter | Description |
|---|---|---|
| D= | DEVICE= | shows the device driver you are using. |
| B= | shows the baud rate for the device. | |
| 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= |  | shows the height of character cells in pixels. |
| W= |  | 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. | ||
Note: The following two statements do not return the same parameters when used with PICTURE=1:
goptions dev=xcolor target=ps nodisplay; goptions dev=ps nodisplay;
The LOG window for picture 1, shown in Output 45.1, lists some of the same settings that are displayed by picture 1, plus some additional settings.
 |
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
| |
Picture 2 tests your device s ability to draw lines. Picture 2 always displays in the first color of the current colors list. Figure 45.2 on page 1287 shows picture 2 of the GTESTIT procedure.
Figure 45.2: Picture 2 of the GTESTIT Procedure
Picture 3 tests your device s ability to draw simple polygons, polygons with multiple boundaries (also known as holes ), ellipses, and justified text. Figure 45.3 on page 1287 shows picture 3 of the GTESTIT procedure.
Figure 45.3: Picture 3 of the GTESTIT Procedure
Table 45.1 on page 1288 explains the values displayed in picture 1 of the GTESTIT procedure. It also provides the equivalent graphics option or device parameter. Chapter 8, Graphics Options and Device Parameters Dictionary, on page 261 includes a complete description of the graphics options and device parameters.
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.
Table 45.2 on page 1289 lists GTESTIT values that appear only in the LOG window for picture 1: these values do not appear in the picture itself. Table 45.2 on page 1289 also provides the equivalent graphics option or device parameter. Chapter 8, Graphics Options and Device Parameters Dictionary, on page 261 contains complete information about the graphics options and device parameters.
| GTESTIT Value | Equivalent Graphics Option or Device Parameter | Description |
|---|---|---|
| Background color= | CBACK= | tells the background color used. |
| Color1= Color n = | 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. |
