POLYLINE Function

Specifies the beginning point of a polyline, which is a connected series of line segments. This function is used in conjunction with one or more POLYCONT functions to draw a series of connected straight lines.

Requirement:	The SG annotation data set must also specify at least one instance of the POLYCONT function immediately after the POLYLINE function.
Note:	The POLYLINE object is similar to a POLYGON, except that the POLYLINE object does not need to be a closed shape.

Syntax

FUNCTION= “POLYLINE”;

Required Variables

X1= numeric-value: specifies the X coordinate of the annotation.

Default:none

Y1= numeric-value: specifies the Y coordinate of the annotation.

Default:none

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).

Default:0.0 (no offset)

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:

DATAPERCENT
DATAPIXEL
DATAVALUE
GRAPHPERCENT
GRAPHPIXEL
LAYOUTPERCENT
LAYOUTPIXEL
WALLPERCENT
WALLPIXEL

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.

See:For more information about these values, see Drawing Space Values.

LAYER= “BACK” | “FRONT”: specifies whether the annotation is drawn in front of (FRONT) or behind (BACK) the graph.

Default:FRONT

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:
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

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).

Default:0.0

X1SPACE= “draw-space-value”

specifies the drawing space of the annotation’s X coordinate.

draw-space-value can be one of the following:

DATAPERCENT
DATAPIXEL
DATAVALUE
GRAPHPERCENT
GRAPHPIXEL
LAYOUTPERCENT
LAYOUTPIXEL
WALLPERCENT
WALLPIXEL

Default:GRAPHPERCENT

Restriction:For the SGPANEL and SGSCATTER procedures, only GRAPHPERCENT, GRAPHPIXEL, LAYOUTPERCENT, and LAYOUTPIXEL values are valid.

See:For more information about these values, see Drawing Space Values.

XAXIS= “X” | “X2”: specifies which X axis to use for data space annotations.

Default:X

XC1= “text-string”: specifies the character X coordinate of an annotation.

Default:none

Y1SPACE= “draw-space-value”

specifies the drawing space of the annotation’s Y coordinate.

draw-space-value can be one of the following:

DATAPERCENT
DATAPIXEL
DATAVALUE
GRAPHPERCENT
GRAPHPIXEL
LAYOUTPERCENT
LAYOUTPIXEL
WALLPERCENT
WALLPIXEL

Default:GRAPHPERCENT

Restriction:For the SGPANEL and SGSCATTER procedures, only GRAPHPERCENT, GRAPHPIXEL, LAYOUTPERCENT, and LAYOUTPIXEL values are valid.

See:For more information about these values, see Drawing Space Values.

YAXIS= “Y” | “Y2”: specifies which Y axis to use for data space annotations.

Default:Y

YC1= “text-string”: specifies the character Y coordinate of an annotation.

Default:none