GPR_$PGON_POLYLINE                GPR Calls                 GPR_$PGON_POLYLINE


NAME
     gpr_$pgon_polyline - defines a series of line segments forming part of a
     polygon boundary.

FORMAT
     gpr_$pgon_polyline (x, y, npositions, status)

DESCRIPTION
     This routine defines a series of line segments forming part of a polygon
     boundary.

     gpr_$pgon_polyline defines a series of line segments that comprise part
     of a polygon to be filled in by either (1) gpr_$close_fill_pgon , by (2)
     gpr_$close_return_pgon and gpr_$multitrapezoid, or by (3)
     gpr_$close_return_pgon_tri and gpr_$multitriangle.  The lines are not
     drawn on the screen until the polygon is filled in by either routines
     (1), (2), or (3) above. To draw an unfilled polygon, use gpr_$polyline.

     gpr_$pgon_polyline must be called only when the line segments of a
     polygon are being defined.  See the routine gpr_$start_pgon for more
     information.

   Input Parameters
     x    List of the x-coordinates of all the successive positions.  The
          gpr_$coordinate_array_t type, a ten-element array of 2-byte
          integers, is an example of such an array.  The actual array can have
          up to 32767 elements.  The values must be within the bitmap limits,
          unless clipping is enabled.

     y    List of the y-coordinates of all the successive positions.  The
          gpr_$coordinate_array_t type, a ten-element array of 2-byte
          integers, is an example of such an array.  The actual array can have
          up to 32767 elements.  The values must be within the bitmap limits,
          unless clipping is enabled.

     npositions
          Number of coordinate positions.  This is a 2-byte integer in the
          range 1 - 32767.

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

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

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.