Chapter Contents

Previous

Next
SAS/GRAPH Software: Reference

About Annotate Graphics

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.


Graphics Elements

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

[IMAGE]

You can control the position of graphics elements in the following ways:


Coordinates

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.


Coordinate Systems

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

[IMAGE]

Coordinate System Values for XSYS, YSYS, ZSYS, and HSYS Variables describes the coordinate system values for the XSYS, YSYS, ZSYS, and HSYS variables.

Coordinate System Values for 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.


Ranges for Cells

The available range for coordinate systems that are measured in cells differs by area:

graphics output area
The range of cells that are available for the graphics output area depends on the device and the number of rows and columns that are set by the HPOS= and VPOS= graphics options or by the PCOLS and LCOLS device parameters.

procedure output area
As with the graphics output area, the range of cells available for the procedure output area depends on the device and the number of rows and columns set by the HPOS= and VPOS= graphics options or by the PCOLS and LCOLS device parameters. However, the procedure output area is sized after areas for titles and footnotes are allocated and is reduced accordingly. If you specify that the legend appear outside of the axis area, the procedure output area also decreases by the size of the legend.

See Procedure Output and the Graphics Output Area for descriptions of the procedure output area and the graphics output area.


Internal Coordinates

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:

xlast=50;

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

[IMAGE]

For a complete description, see Annotate Internal Coordinates.


Attributes

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.


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.