PK_BODY_imprint_plane_2

PK_ERROR_code_t                  PK_BODY_imprint_plane_2
(
--- received arguments ---
PK_BODY_t                        body,        --- target body
PK_PLANE_t                       plane,       --- tool plane
const PK_BODY_imprint_plane_o_t *options,     --- options

--- returned arguments ---
PK_TOPOL_track_r_t        *const tracking     --- tracking information
)


This function intersects the supplied plane with the faces of the body and
imprints edges and vertices at the intersections.


Specific Errors:

    PK_ERROR_cant_do_imprint       (SERIOUS)  Failed to perform imprint
    PK_ERROR_wire_body             (MILD)     Target is wire body
    PK_ERROR_bad_tolerance         (MILD)     The supplied tolerance is invalid
    PK_ERROR_partial_no_intersect  (MILD)     No intersection of body's faces
                                              and plane



Edges and vertices are added to the body where the plane intersects with the
faces of the body (except where they already exist). This function does not
support wire bodies and does not imprint topology for intersections between the
given plane and any wire components of the body.

The returned tracking structure holds a single tracking record of type
PK_TOPOL_track_create_c. This contains a list of the imprinted edges as
product topologies, and may include existing edges along which the plane
intersects the body. Note that existing edges resulting from faces coincident
with the plane will not be returned.

Further control may be provided to this function using the option structure.

See here for more information.