gpr_close_return_pgon() — Apollo Domain/OS SR10.3.5

GPR_$CLOSE_RETURN_PGON            GPR Calls             GPR_$CLOSE_RETURN_PGON


NAME
     gpr_$close_return_pgon - closes the currently open polygon and returns
     the list of trapezoids within its interior.

FORMAT
     gpr_$close_return_pgon (list_size, trapezoid_list, trapezoid_number,
                             status)

DESCRIPTION
     This routine closes the currently open polygon and returns the list of
     trapezoids within its interior.

     gpr_$close_return_pgon returns a list of trapezoids within a polygon
     interior that the graphics program can draw at a later time with the rou-
     tine gpr_$multitrapezoid.

     The trapezoid_number parameter is always the total number of trapezoids
     composing the polygon interior.  If this number is greater than the
     list-size parameter, some trapezoids were left out of the trapezoid_list
     for lack of space.

   Input Parameters
     list_size
          The maximum number of trapezoids that the routine is to return.
          This is a 2-byte integer.

   Output Parameters
     trapezoid_list
          The trapezoids returned. This is a gpr_$trap_list_t array of up to
          10 elements.

     trapezoid_number
          The number of trapezoids that exist within the polygon interior.
          This is a 2-byte integer.

     status
          Completion status, in status_$t format.

NOTES
     gpr_$close_return_pgon does not work when the decomposition technique is
     gpr_$non_overlapping_tris.
Museum
