|SAS/GRAPH Software: Reference|
When you create Annotate graphics, you specify these things:
The following sections describe these components of the graphics output that are produced by an Annotate data set.
In an Annotate data set, the FUNCTION variable determines the graphics element that is drawn. The particular graphics elements that you can draw are shown in Annotate Graphics Elements along with the value of the FUNCTION variable or Annotate macro that draws them.
Annotate Graphics Elements
You can control the position of graphics elements in the following ways:
Coordinates specify where to put graphics elements. These variables can contain coordinate values:
Coordinates are interpreted in terms of a coordinate system in order to identify a precise location in the graphics output.
A coordinate system determines how coordinates are interpreted. You specify a coordinate system to use for each dimension, using the XSYS, YSYS, and ZSYS variables (for X, Y, and Z, respectively). Use ZSYS to annotate graphics output only from the G3D procedure.
You also specify a coordinate system for the SIZE variable using the HSYS variable. HSYS takes the same kinds of values as XSYS, YSYS, and ZSYS. The SIZE variable specifies the size of a graphics element, such as the width of lines (for example, FRAME), the radius of pie slices (for example, PIE, PIECNTR, and PIEXY), or the height of text (for example, LABEL and SYMBOL).
These are the important components of the Annotate coordinate systems:
Areas and Their Coordinate Systems
Coordinate System Values for XSYS, YSYS, ZSYS, and HSYS Variables describes the coordinate system values for the XSYS, YSYS, ZSYS, and HSYS variables.
|Type of Coordinates||Area||Units||Range||Value for XSYS, YSYS, ZSYS, HSYS|
|Absolute||data||%||0-100% of axis||1' *|
|data||values||minimum to maximum of axis||2' *|
|graphics output area||%||0-100% of graphics output area||3'|
|graphics output area||cells||0 to limit of graphics output area||4'|
|procedure output area||%||0-100% of procedure output area||5'|
|procedure output area||cells||0 to limit of procedure output area||6'|
|Relative||data||%||0-100% of axis||7' *|
|data||values||minimum to maximum of axis||8' *|
|graphics output area||%||0-100% of graphics output area||9'|
|graphics output area||cells||0 to limit of graphics output area||A'|
|procedure output area||%||0-100% of procedure output area||B'|
|procedure output area||cells||0 to limit of procedure output area||C'|
|*Coordinate systems 1, 2, 7, and 8 are not valid with block, pie or star charts in the GCHART procedure or surface, prism or block maps with the GMAP procedure.|
The available range for coordinate systems that are measured in cells differs by area:
See Procedure Output and the Graphics Output Area for descriptions of the procedure output area and the graphics output area.
The Annotate facility maintains two pairs of internal coordinates that are stored in internal variables:
Many functions use these internal coordinates as a starting point, relying on the coordinates that are specified with the function as an ending point. For example, in the BAR function, the (XLAST, YLAST) coordinate pair is used for the lower left corner; the position defined by the X and Y variables is used for the upper-right corner. (See the BAR function on BAR Function for details.) These internal variables can also provide default coordinates if X, XC, Y, or YC contains a missing value.
The internal coordinates are automatically updated by some of the Annotate functions. The text functions, LABEL and SYMBOL, update the (XLSTT,YLSTT) variables. The BAR, DRAW, MOVE, PIE, and POINT functions update the (XLAST,YLAST) variables.
You cannot explicitly assign a value to XLAST, YLAST, XLSTT, or YLSTT because they are internal variables. For example, you cannot make this assignment:
However, you can use several functions to directly manipulate the values of the internal coordinates. The functions are shown in Programming Functions That Manipulate System Variables.
Programming Functions That Manipulate System Variables
For a complete description, see Annotate Internal Coordinates.
Attribute variables control the appearance of the graphics elements. Each function uses only a subset of these variables. See Summary of Annotate Variables for a list of attribute variables.
What an attribute variable controls often depends on the graphics element to which it applies. For example, the SIZE variable controls the width of a line when it is used with FUNCTION='DRAW', but it controls the text height when it is used with FUNCTION='LABEL'.
For a complete description of the attribute variables and the aspect of the graphics elements that they controls, see Annotate Variables.
Top of Page
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.