RECTANGLE Function
Draws a rectangle annotation around the specified
(X1, Y1) coordinates using the specified height and width. By default,
the (X1, Y1) coordinates constitute the center of the rectangle, though
you can change this behavior using the ANCHOR option.
Tip: |
An easy way to draw a square is to specify PIXEL for the
HEIGHTUNIT and WIDTHUNIT variables and then provide the same value
for the HEIGHT and WIDTH.
|
Syntax
Required Variables
- HEIGHT= numeric-value
- specifies the height of the annotation. Specify a positive
number greater than zero. You can use the HEIGHTUNIT variable to specify
the unit of measurement.
- WIDTH= numeric-value
- specifies the width of the annotation. Specify a positive
number greater than zero. You can use the WIDTHUNIT variable to specify
the unit of measurement.
- X1= numeric-value
- specifies the X coordinate of the annotation.
- Y1= numeric-value
- specifies the Y coordinate of the annotation.
Optional Variables
- ANCHOR= “TOPLEFT” | “TOP” |
“TOPRIGHT” | “RIGHT” | “BOTTOMRIGHT”
| “BOTTOM” | “BOTTOMLEFT” | “LEFT”
| “CENTER”
- specifies the anchor position of the annotation.
This point is placed on the specified X1 and Y1 positions.
- CORNERRADIUS= numeric-value
- specifies the roundness of the corners of rectangles. Specify a value from
0.0 (completely rectangular) to 1.0 (oval).
- DISCRETEOFFSET= numeric-value
- specifies an amount to offset the annotation from
a discrete value in data space. Specify a value from
-0.5 (left offset) to +0.5 (right offset).
- DISPLAY= “ALL” | “FILLED” |
“OUTLINE”
- specifies the fill and outline properties. You can specify that
the annotation be filled (FILLED), have an outline (OUTLINE), or both
(ALL).
- DRAWSPACE= “draw-space-value”
- specifies the drawing space and units for the annotation. DRAWSPACE can be used
rather than specify X1SPACE and Y1SPACE individually.
draw-space-value can
be one of the following:
Default:GRAPHPERCENT (unless overridden by a coordinate draw
space, such as X1SPACE)
Restriction:For the SGPANEL and SGSCATTER procedures, only GRAPHPERCENT,
GRAPHPIXEL, LAYOUTPERCENT, and LAYOUTPIXEL values are valid.
- FILLCOLOR= “color” | “style-attribute”
- specifies a fill color for the annotation. You can specify a color
or a style element attribute. Here is an example of a style attribute:
GraphData2:Color
You
can specify colors using the same color schemes that are supported
by
SAS/GRAPH software.
For more information, see Color-Naming Schemes in SAS/GRAPH: Reference.
Default:COLOR attribute in the graph’s current style
Interaction:This option takes effect only if the DISPLAY option
is specified as FILLED or ALL.
- FILLTRANSPARENCY= numeric-value
- specifies the transparency for the fill portion
of an annotation. Specify a value from
0.0 (completely opaque) to 1.0 (completely transparent).
- HEIGHTUNIT= “DATA” | “PERCENT”
| “PIXEL”
- specifies the dimension unit to use for the HEIGHT
value.
- LAYER= “BACK” | “FRONT”
- specifies whether the annotation is drawn in front
of (FRONT) or behind (BACK) the graph.
- LINECOLOR= “color” | “style-attribute”
- specifies a line color for the annotation. You can specify a color
or a style element attribute. Here is an example of a style attribute:
You
can specify colors using the same color schemes that are supported
by
SAS/GRAPH software.
For more information, see Color-Naming Schemes in SAS/GRAPH: Reference.
Default:COLOR attribute in the graph’s current style
- LINEPATTERN= “line-pattern”
- specifies a line pattern for the annotation. You can reference SAS patterns by number or by name. For a list of line patterns,
see Line Patterns.
Default:LineStyle attribute in the graph’s current
style
- LINETHICKNESS= n
- specifies the thickness of the line. You cannot specify
the unit of measure. The default unit of pixels is always used.
Default:LineThickness attribute in the graph’s current
style
- ROTATE= degrees
- rotates the annotation. Specify a number between
0 and 360.
- TRANSPARENCY= numeric-value
- specifies the degree of transparency for the annotation. Specify a value from
0.0 (completely opaque) to 1.0 (completely transparent).
- WIDTHUNIT= “DATA” | “PERCENT”
| “PIXEL”
- specifies the dimension unit to use for the WIDTH
value.
- X1SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
X coordinate.
draw-space-value can
be one of the following:
Default:GRAPHPERCENT
Restriction:For the SGPANEL and SGSCATTER procedures, only GRAPHPERCENT,
GRAPHPIXEL, LAYOUTPERCENT, and LAYOUTPIXEL values are valid.
- XAXIS= “X” | “X2”
- specifies which X axis to use for data space annotations.
- XC1= “text-string”
- specifies the character X coordinate of an annotation.
- Y1SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
Y coordinate.
draw-space-value can
be one of the following:
Default:GRAPHPERCENT
Restriction:For the SGPANEL and SGSCATTER procedures, only GRAPHPERCENT,
GRAPHPIXEL, LAYOUTPERCENT, and LAYOUTPIXEL values are valid.
- YAXIS= “Y” | “Y2”
- specifies which Y axis to use for data space annotations.
- YC1= “text-string”
- specifies the character Y coordinate of an annotation.