GPR_$START_PGON                   GPR Calls                    GPR_$START_PGON


NAME
     gpr_$start_pgon - defines the starting position of a polygon.

FORMAT
     gpr_$start_pgon (x, y, status)

DESCRIPTION
     This routine defines the starting position of a polygon.

     gpr_$start_pgon defines the first point in a polygon boundary.  This rou-
     tine is used in conjunction with gpr_$pgon_polyline to define a connected
     series of edges composing one closed loop of a polygon's boundary.

     This routine closes any previously open loop of edges by defines the
     starting position of a polygon.  connecting its last endpoint to its
     first endpoint with an edge.  Then, the routine starts the new loop.

   Input Parameters
     x    The 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, 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.

SEE ALSO
     gpr_$multitriangle, gpr_$multitrapezoid, gpr_$close_return_pgon_tri,
     gpr_$close_return_pgon, gpr_$close_fill_pgon.

NOTES
     To see the polygon, you must fill it, by calling one of the following:

        ⊕  gpr_$close_fill_pgon.

        ⊕  A combination of gpr_$close_return_pgon and gpr_$multitrapezoid.

        ⊕  A combination of gpr_$close_return_pgon_tri and gpr_$multitriangle.