gpr_move(A) — Apollo

GPR_$MOVE                         GPR Calls                          GPR_$MOVE


NAME
     gpr_$move - sets the current position to the given position.

FORMAT
     gpr_$move (x, y, status)

DESCRIPTION
     This routine sets the current position to the given position.

     The current position is the starting point for many drawing and text
     operations.

     gpr_$move does not draw any lines.

     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 move operation.

   Input Parameters
     x    The x-coordinate, which becomes the current x-coordinate, in
          gpr_$coordinate_t format. This is a 2-byte integer.  Its values must
          be within bitmap limits, unless clipping is enabled.

     y    The y-coordinate, which becomes the current y-coordinate, in
          gpr_$coordinate_t format.  This is a 2-byte integer. Its values must
          be within bitmap limits, unless clipping is enabled.

   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
