GPR_$POLYLINE GPR Calls GPR_$POLYLINE
NAME
gpr_$polyline - draws a series of connected lines.
FORMAT
gpr_$polyline (x, y, npositions, status)
DESCRIPTION
This routine draws a series of connected lines: drawing begins at the
current position, draws to the first given coordinate position, then sets
the current position to the first given position. This is repeated for
all given positions. The given coordinates are added to the correspond-
ing elements of the coordinate origin for the current bitmap. The resul-
tant coordinate position is the destination of the polyline drawn.
Input Parameters
x List of the x-coordinates of all the successive positions.
gpr_$coordinate_array_t, a ten-element array of 2-byte integers, is
an example of such an array. The actual array can have up to 32767
elements. The values must be within the bitmap limits, unless clip-
ping is enabled.
y List of the y-coordinates of all the successive positions.
gpr_$coordinate_array_t, a ten-element array of 2-byte integers, is
an example of such an array. The actual array can have up to 32767
elements. The values must be within the bitmap limits, unless clip-
ping is enabled.
npositions
Number of coordinate positions. This is a 2-byte integer in the
range 1 - 32767.
Output Parameters
status
Completion status, in status_$t format.
NOTES
When you have clipping enabled, you can specify coordinates outside the
bitmap limits. With clipping disabled, specifying coordinates outside
the bitmap limits results in an error.