LINE Function
Draws a line annotation from the specified (X1,
Y1) coordinates to the specified (X2,Y2) coordinates.
Syntax
Required Variable
- X1= numeric-value
- specifies the first X coordinate of the annotation.
- X2= numeric-value
- specifies the second X coordinate of the annotation.
- Y1= numeric-value
- specifies the first Y coordinate of the annotation.
- Y2= numeric-value
- specifies the second Y coordinate of the annotation.
Optional Variables
- 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).
- DRAWSPACE= “draw-space-value”
- specifies the drawing space and units for the annotation. DRAWSPACE can be used
rather than specify individual values for X1SPACE, X2SPACE, Y1SPACE,
and Y2SPACE.
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.
- 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
- TRANSPARENCY= numeric-value
- specifies the degree of transparency for the annotation. Specify a value from
0.0 (completely opaque) to 1.0 (completely transparent).
- X1SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
first 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.
Note:If you do not also specify the X2SPACE= value, then the
second X coordinate uses the default drawing space.
- X2SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
second 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.
Note:If you do not also specify the X1SPACE= value, then the
first X coordinate uses the default drawing space.
- XAXIS= “X” | “X2”
- specifies which X axis to use for data space annotations.
- XC1= “text-string”
- specifies the character X coordinate of an annotation.
- XC2= “text-string”
- specifies the second character X coordinate of an
annotation.
- Y1SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
second 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.
Note:If you do not also specify the Y2SPACE= value, then the
second Y coordinate uses the default drawing space.
- Y2SPACE= “draw-space-value”
- specifies the drawing space of the annotation’s
second 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.
Note:If you do not also specify the Y1SPACE= value, then the
first Y coordinate uses the default drawing space.
- YAXIS= “Y” | “Y2”
- specifies which Y axis to use for data space annotations.
- YC1= “text-string”
- specifies the character Y coordinate of an annotation.
- YC2= “text-string”
- specifies the second character Y coordinate of an
annotation.