GDRAW Call :: SAS/IML(R) 13.1 User's Guide

GDRAW Call

CALL GDRAW (x, y <*>, style <*>, color <*>, window <*>, viewport ) ;

The GDRAW subroutine is a graphical call that draws a polyline. This call is part of the traditional graphics subsystem, which is no longer being developed.

The required arguments to the GDRAW subroutine are as follows:

x: is a vector that contains the horizontal coordinates of points used to draw a sequence of lines.
y: is a vector that contains the vertical coordinates of points used to draw a sequence of lines.

The optional arguments to the GDRAW 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 GDRAW subroutine draws a sequence of connected lines from points represented by values in x and y, which must be vectors of the same length. If x and y have $n$ points, there are $n-1$ lines. The first line is from the point $(x_1,y_1)$ to $(x_2,y_2)$ . 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 GDRAW subroutine follows:

call gstart;
/* line from (50,50) to (75,75) */
call gdraw({50 75},{50 75});
call gshow;