gpr_$multiline

GPR_$MULTILINE                    GPR Calls                     GPR_$MULTILINE


NAME
     gpr_$multiline - draws a series of disconnected lines.

FORMAT
     gpr_$multiline (x, y, npositions, status)

DESCRIPTION
     This routine draws a series of disconnected lines.

     gpr_$multiline alternately moves to new positions and draws lines:  it
     moves to the first given position, draws a line from the first to the
     second given position, moves to the third position, etc.  After the last
     line has been drawn or the last move has been made, the endpoint becomes
     the current position.

     The given coordinates are added to the corresponding elements of the
     coordinate origin for the current bitmap.  The resultant coordinate posi-
     tion is the destination of the multiline drawn.

     If you specify an odd number of coordinate positions, then the system
     will use the last point as the new current position (but will not use it
     to draw a line).

   Input Parameters
     x    List of the x-coordinates of all the successive coordinate positions
          in gpr_$coordinate_array_t format.  This is an array of 2-byte
          integers.  The values must be within the bitmap limits, unless clip-
          ping is enabled.

     y    List of the y-coordinates of all the successive coordinate positions
          in gpr_$coordinate_array_t format.  This is an array of 2-byte
          integers.  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
