GPR_$LINE                         GPR Calls                          GPR_$LINE


NAME
     gpr_$line - draws a line from the current position to the end point sup-
     plied.

FORMAT
     gpr_$line (x, y, status)

DESCRIPTION
     This routine draws a line from the current position to the end point sup-
     plied.  The current position is updated to the end point.

     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 line drawn.

     After the line has been drawn, its end point becomes the current posi-
     tion.

   Input Parameters
     x    The x-coordinate, which designates the end point of the line and
          then becomes the current x-coordinate.  Use gpr_$coordinate_t for-
          mat. This is a 2-byte integer.  Its values must be within the bitmap
          limits, unless clipping is enabled.

     y    The y-coordinate, which designates the end point of the line and
          then becomes the current y-coordinate.  Use gpr_$coordinate_t for-
          mat.  This is a 2-byte integer. Its values must be within the bitmap
          limits, unless clipping is enabled.

   Output Parameters
     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$move.

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.

     To set a new position without drawing a line, use gpr_$move.