GDEVICE Procedure

Using the GDEVICE Windows

About the GDEVICE Windows

You can use GDEVICE windows instead of program mode to view, modify, copy, create, or delete device entries. You can perform tasks in the GDEVICE windows by entering values in the fields, by using the menus, and by issuing commands from the command line.
These are the thirteen GDEVICE windows in order of appearance:
  • DIRECTORY Window
  • Detail Window
  • Parameters Window
  • Gcolors Window
  • Chartype Window
  • Colormap Window
  • Metagraphics Window
  • Gprolog Window
  • Gepilog Window
  • Gstart Window
  • Gend Window
  • Host File Options Window
  • Host Commands Window
The fields in these windows represent device entry parameters. The GDEVICE windows group the device parameters by topic. When you open a device entry in Edit mode, you can modify the fields directly. For a description of each field, see the corresponding parameter in Graphics Options and Device Parameters Dictionary.
Note: Each entry in the dictionary states whether the entry (that is, the option or parameter) can be used by the GOPTIONS statement, the GDEVICE procedure, or any of the GDEVICE windows. Any entry that says it can be used by the GDEVICE procedure or a GDEVICE window is a device parameter.
Note: The parameters are sometimes an abbreviation of the field names. For example, in the Detail window, the “Driver query” field corresponds to the DRVQRY parameter, and the “Queued messages” field corresponds to the QMSG parameter.

GDEVICE Window Commands

You can navigate and manipulate the GDEVICE windows by entering commands on the command line, or selecting items from the menus. For a complete description of all the GDEVICE window commands, open the help for the GDEVICE windows. You can open the help by entering Help on the command line or by selecting Helpthen selectUsing This Window.
Note: In a Windows environment, the GDEVICE commands are presented on pop-up menus. Click the secondary mouse button on a GDEVICE window to access a pop-up menu.

DIRECTORY Window

This window is displayed when you start the GDEVICE procedure in window mode. It lists all the device entries in the default catalog or the catalog that you specified in the PROC GDEVICE statement. You can use it to do the following:
  • copy, rename, or delete device entries in the catalog
  • select a device entry whose parameters you want to browse or edit
You can enter these commands in the DIRECTORY window selection field:
B | S
open the Detail window and browse (B) or, if you are in Edit mode, edit (S) the selected device entry.
D
delete the selected device entry. You cannot restore a device entry once it has been deleted.
E
open the Detail window and edit the selected device entry.
R
rename the device entry or the description, or both.
You cannot edit the TYPE and UPDATED fields in the DIRECTORY Window.
The DIRECTORY Window
GDEVICE DIRECTORY Window
After the DIRECTORY window appears, you can navigate through the GDEVICE windows by selecting the Viewthen selectNext Screen.

Detail Window

This window contains device parameters that control basic characteristics of the device (for example, the size of the graphics output area).
The Detail Window
GDEVICE DETAIL Window

Parameters Window

This window includes additional device parameters that affect how graphs are drawn. For example, you can define the following parameters:
  • whether certain graphics primitives are drawn by your hardware or by SAS/GRAPH
  • whether to feed paper to printers or plotters automatically
  • whether to have SAS/GRAPH prompt you with messages under certain conditions
Note: If the device does not support a hardware characteristic, the catalog entry cannot enable the support.
The Parameters Window
GDEVICE Parameters window

Gcolors Window

This window lists the colors that the device driver uses by default when the NOGSTYLE option is in effect. When you do not explicitly specify the color of a graphics feature in your program or in a GOPTIONS statement, SAS/GRAPH uses this list to determine what color to use.
The Gcolors Window (partial view)
GDEVICE Gcolors Window

Chartype Window

This window lists the device-resident fonts that the device can use, along with information about the size of the characters. The Chartype value is the value to reference a font in another window. For example, you can enter a Chartype number in the Parameters window's Chartype field.
The Chartype Window (partial view)
GDEVICE Chartype Window

Colormap Window

This window enables you to specify a color map for the device. The FROM field specifies the name to assign to the color designated by the color value. The TO field specifies a predefined SAS/GRAPH color name. Once you have defined the color mapping, the new color name is available for use in any color option. For example, map the color name DAFFODIL to the SAS color value PAOY. Specify COLOR=DAFFODIL anywhere the COLOR= option is supported. The driver substitutes the color value PAOY. Contact SAS Technical Support for assistance in determining predefined SAS color names.
The Colormap Window (partial view)
GDEVICE Colormap Window

Metagraphics Window

This window is used by all drivers that support multiple color spaces (for example, RGB or CMYK). It is also used if the device entry is a Metagraphics (user-written) driver. Metagraphics drivers are created when a device entry that was provided by SAS cannot be adapted to support your graphics device. For information about Metagraphics drivers, contact SAS Technical Support.
CAUTION:
Do not alter the fields in the Metagraphics window unless you are changing the color scheme (colortype) or building a Metagraphics driver.
The Metagraphics Window
GCEVICE Metagraphics Window

Gprolog Window

This window enables you to specify one or more hexadecimal strings sent to the device before graphics commands are sent. Additional commands can be sent with the PREGPROLOG= and POSTGPROLOG= graphics options. See Graphics Options and Device Parameters Dictionary for descriptions of these options.

Gepilog Window

This window enables you to specify one or more hexadecimal strings that are sent to the device after graphics commands are sent. Additional commands can be sent with the PREGEPILOG= and POSTGEPILOG= graphics options. See Graphics Options and Device Parameters Dictionary for descriptions of these options.

Gstart Window

This window enables you to specify one or more hexadecimal strings that are placed at the beginning of each record of graphics data.

Gend Window

This window enables you to specify one or more hexadecimal strings that are placed at the end of each record of graphics data.

Host File Options Window

This window controls the output destination and formatting of the data stream produced by the driver. (Most of these values can also be specified with the GOPTIONS statement or with the FILENAME statement. See Specifying the Graphics Output File Type for Your Graph.)
The Host File Options Window
GDEVICE Host File Options Window

Host Commands Window

This window stores the host commands issued at driver initialization, before and after each graph is produced, and at driver termination. These commands are typically used to send graphics output to a hardcopy device such as a printer or a plotter.
The Host Commands Window
GDEVICE Host Commands Window