The GDRAWL subroutine is a graphical call that draws individual lines.

The required arguments to the GDRAWL subroutine are as follows:

xy1

is a matrix of points used to draw a sequence of lines.

xy2

is a matrix of points used to draw a sequence of lines.

The optional arguments to the GDRAWL subroutine are as follows:

style

is a numeric matrix or literal that specifies an index that corresponds to a valid line style.

color

is a valid SAS color, where color can be specified as a quoted text string (such as 'RED'), the name of a character matrix that contains a valid color as an element, or a color number (such as 1) that refers to a color in the color list.

window

is a numeric matrix or literal that specifies a window. This is given in world coordinates and has the form

{minimum-x minimum-y maximum-x maximum-y}

viewport

is a numeric matrix or literal that specifies a viewport. This is given in normalized coordinates and has the same form as the window argument.

The GDRAWL subroutine draws a sequence of lines specified by their beginning and ending points. The matrices xy1 and xy2 must have the same number of rows and columns. The first two columns (other columns are ignored) of xy1 give the coordinates of the beginning points of the line segment, and the first two columns of xy2 have coordinates of the corresponding endpoints. If xy1 and xy2 have rows, lines are drawn.

The lines are drawn in the same color and line style. The coordinates in use for this graphics command are world coordinates. An example that uses the GDRAWL call follows:

proc iml;
call gstart;
/* three line segments */
xy1 = { 0  0,  25 50, 50 75};
xy2 = {25 25,  50 50, 75 50};
call gdrawl(xy1, xy2);
call gshow;