LINE

Draws a polyline

Operating state:

SGOP

Syntax

Details

Syntax

return-code-variable=GDRAW('LINE', n, x-values, y-values);

Required Arguments

n: numeric constant or numeric variable name; the number of vertices (x and y pairs) in the polygon. You can specify a missing value (.) for n. If n is missing, the number of vertices is computed from the number of x and y pairs.

x-values: list of numeric constants, variables, or OF arguments that describe the x coordinates for the vertices in units based on the current window system.

y-values: list of numeric constants, variables, or OF argument lists that describe the y coordinates for the vertices in units based on the current window system.

Return Codes

This function returns:: 0, 4, 61, 86, 100, or 301. See Return Codes for DSGI Routines and Functions.

Details

The GDRAW('LINE' . . . ) function draws one line, a series of connected lines, or a dot. The line attributes and bundles affect the appearance of this primitive. See DATA Step Graphics Interface Routines for a list of these attributes.

Note: All of the x coordinates are listed in the function first, followed by the y coordinates. This primitive takes the first n values and stores them as x coordinates and the next n values and stores them as y coordinates.