gpr_arc_3p() — Apollo Domain/OS SR10.4.1

GPR_$ARC_3P                       GPR Calls                        GPR_$ARC_3P


NAME
     gpr_$arc_3p - draws an arc.

FORMAT
     gpr_$arc_3p (point_2, point_3, status)

DESCRIPTION
     This routine draws an arc from the current position through two other
     specified points.  It is geometrically possible to draw an arc through
     any three non-colinear points.  The gpr_$arc_3p routine begins the arc at
     the current position, continues the arc through point_2, and completes
     the arc at point_3.  After the arc is drawn, point_3 becomes the new
     current position.

   Input Parameters
     point_2
          The second point on the arc, in gpr_$position_$t format.  This data
          type is 4 bytes long.

     point_3
          The third point on the arc, in gpr_$position_t format.  This data
          type is 4 bytes long.

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

SEE ALSO
     gpr_$move.

NOTES
     You can use the gpr_$move command to re-establish the current position.

     The call returns an error if any of the three points are equal or if the
     three points are colinear.

     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
