Museum

GPR_$CIRCLE                       GPR Calls                        GPR_$CIRCLE


NAME
     gpr_$circle - draws a circle.

FORMAT
     gpr_$circle (center, radius, status)

DESCRIPTION
     This routine draws a circle with the specified radius around the speci-
     fied center point.

     The coordinates you specify for the paramenter center are added to the
     corresponding coordinates of the origin for the current bitmap.  The
     resultant coordinate position is the center of the circle.

   Input Parameters
     center
          The center of the circle, in gpr_$position_t format.  This data type
          is 4 bytes long.

     radius
          The radius of the circle.  This is a 2-byte integer in the range 1 -
          32767.

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

NOTES
     gpr_$circle does not change the current position.

     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.