PK_section_2_r_t

struct PK_section_2_r_s
    {
    PK_section_result_t     result;         --- result of sectioning operation
    int                     n_front_bodies; --- number of front bodies
    PK_BODY_t              *front_bodies;   --- bodies in front of section
    int                     n_back_bodies;  --- number of back bodies
    PK_BODY_t              *back_bodies;    --- bodies behind section
    int                     n_front_faces;  --- number of front faces
    PK_FACE_t              *front_faces;    --- faces in front of section
    int                     n_back_faces;   --- number of back faces
    PK_FACE_t              *back_faces;     --- faces behind section
    int                     n_reports;      --- number of reports
    PK_section_report_r_t  *reports;        --- array of report structures
    };
typedef struct PK_section_2_r_s PK_section_2_r_t;




This structure contains the results of a section operation for bodies
or faces.

Used in:

PK_BODY_section_with_sheet_2
PK_FACE_section_with_sheet_2
PK_section_2_r_f

The arrays of entities are returned under the control of the 'fence'
field of an options structure, and will be set to (NULL, 0) if not
requested, or empty (length of zero).

Description of fields:



'result'                 This status field indicates the overall state of
                         the sectioning operation. Permitted values are :

                           PK_section_result_success_c
                           PK_section_result_no_clash_c
                           PK_section_result_failed_c



'n_front_bodies'         The number of bodies in the 'front_bodies' array.


'front_bodies'           The array of resultant bodies in front of the
                         sectioning tool. If the 'result' field is set
                         to 'PK_section_result_failed_c', the array will
                         be set to null.




'n_back_bodies'          The number of bodies in the 'back_bodies' array.


'back_bodies'            The array of resultant bodies behind the
                         sectioning tool. If the 'result' field is set
                         to 'PK_section_result_failed_c', the array will
                         be set to null.



'n_front_faces'          The number of faces in the 'front_faces' array.


'front_faces'            The array of new faces of the resultant bodies
                         in front of the sectioning tool. If the 'result'
                         field is set to 'PK_section_result_failed_c', the
                         array will be set to null.



'n_back_faces'           The number of faces in the 'back_faces' array.


'back_faces'             The array of new faces of the resultant bodies
                         behind the sectioning tool. If the 'result' field
                         is set to 'PK_section_result_failed_c', the array
                         will be set to null.



'n_reports'              The number of sectioning reports in the 'reports'
                         array.


'reports'               This array may contain supplementary information
                        regarding the outcome of the sectioning operation.
                        For example, if the operation failed, the reports
                        may contain topology related to the failure.


Destroying the returned data structure

When the application wishes to free the memory associated
with the results structure, the function 'PK_section_2_r_f'
must be used.