gpr_polyline(A)

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