The PROC GKEYMAP Statement names the key map or device map to
be created or output as a data set. If the procedure creates a key map or
a device map, it identifies the data set that is used as input. If it outputs
a map, it identifies the data set to which the map is written.
PROC GKEYMAP
NAME=map-name
data-set-argument
<option(s)>;
|
|
data-set-argument
must be one or more of the following:
|
|
option(s) can be one or more of the
following:
|
-
NAME=map-name
- identifies the map that is to be created
or converted to a SAS data set. Key maps are stored as map-name.KEYMAP,
and device maps are stored as map-name.DEVMAP. The value of
the KEYMAP or DEVMAP option determines the type of map and the extension added
to map-name. It is possible to use the same map-name
value for both a key map and a device map.
If you create a key map or device map, the map is stored
as an entry in the catalog GFONTn.FONTS where n
is a number from 1 to 9, and you must use a LIBNAME statement to specify a
libref for GFONTn. See About the Libref GFONT0 for details.
If you specify an existing key
map or device map, SAS/GRAPH software
searches for the map using the same search path that it uses to search for
fonts. See Font Locations
for details.
-
DATA=keymap-data-set
- identifies the input data set for the GKEYMAP
procedure. Used only when you are creating a key map or device map.
-
OUT=output-data-set
- identifies the output data set to which
the data from a key map or device map are to be written. Used only when you
output an existing key map or device map as a SAS data set.
You can specify as many options as you want and list
them in
any order.
-
DEVICE=device-name
- specifies the device driver that a device
map is associated with, where device-name is the name of an entry
in a device catalog. DEVICE= is not required when creating a device map, but
it can be used if you want to limit the use of the device map to one particular
driver. If you do not use DEVICE=, the device map can be used with any device.
DEVICE= is valid only if you are creating a device map.
-
DEVMAP | KEYMAP
- specifies whether you are working with a
device map or a key map. The default is KEYMAP unless you use an option that
can be used only with DEVMAP. This option also specifies the type of map
you are outputting as a data set.
-
TYPE=MAP11 |
MAP1N
- specifies whether you are mapping characters
in a device map one-to-one or one-to-many. If you specify TYPE=MAP11 (the
default), each character in a graphics text string is mapped to only one character
on the output device. If you specify TYPE=MAP1N, a single character in a graphics
text string can be mapped to multiple characters on the output device. For
example, if two characters have to be sent to the graphics output device to
display a single hardware character, specify TYPE=MAP1N. Specify TYPE=MAP1N
only when you create a device map.
-
MULTFONT
- specifies that an alternate hardware character
set is required to display one or more characters in the device map. Specify
the MULTFONT option only when you create a device map.
To generate a data set from an existing key map or device map,
follow these steps:
- Specify the name of the key map or device map
with the NAME= argument. If the map is user generated, you must first submit
a LIBNAME statement to associate the libref GFONT0 with the location where
the map is stored, and NAME= must specify the name that was specified for
the key map or device map when it was created. If the map is an Institute-supplied
map, it is located in the catalog SASHELP.FONTS, and you do not need to submit
a LIBNAME statement to access it.
- In the OUT= argument, specify the name of the
data set to which the data are to be written. By default, the data set is
written to the temporary library WORK.
- Use the DEVMAP option if a device map is selected.
- Optionally, use the PRINT
procedure to display
the newly created data set (most values will be unprintable, so you should
use a $HEX2. format for the FROM and TO variables).
To create and use a key map or device map, follow these steps:
- Submit a
LIBNAME statement that associates the
libref GFONT0 with the location where your map is to be stored.
- Create a data set that contains the mapping information
you need. You can use a DATA step to create all of the mapping information
for the key map or device map, or you can create a data set from an existing
key map or device map, then update that data set with the mappings that you
need. This process is illustrated in Modifying a Key Map.
- Use the GKEYMAP procedure to create
the key map
or device map, using as input the data set that contains the mapping information.
The GKEYMAP procedure stores the map in the catalog GFONT0.FONTS.
- Use the KEYMAP= or DEVMAP= option in a GOPTIONS
statement to assign the key map or device map in your SAS session. The specified
map is used automatically in your SAS/GRAPH programs.
(The device map is used only when you use a hardware character
set.)
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.
