PK_FACE_delete_blends

PK_ERROR_code_t                  PK_FACE_delete_blends
(
--- received arguments ---
int                              n_faces,   --- number of faces
const PK_FACE_t                  faces[],   --- faces to delete
double                           tolerance, --- tolerance
const PK_FACE_delete_blends_o_t *options,   --- options [PF]

--- returned arguments ---
PK_TOPOL_track_r_t        *const tracking,  --- tracking information
PK_TOPOL_local_r_t        *const results    --- status information
)


This function deletes the given faces.

This function offers partial support for facet geometry [PF]


Specific Errors:
    PK_ERROR_face_check_fails       (SERIOUS) Face check has failed
    PK_ERROR_face_face_check_fails  (SERIOUS) Operation has resulted in
                                              face/face inconsistency
    PK_ERROR_cant_heal_wound        (SERIOUS) Can't heal wound
    PK_ERROR_non_manifold           (SERIOUS) * can't heal wound with
                                                non-manifold boundary
                                              * 'faces' do not form a
                                                manifold set or a
                                                neighbourhood of 'faces'
                                                is not manifold.


The faces must all come from the same body. The algorithm is based on the
assumption that the faces represent a blend feature, and is unsuitable for
use as a general face deletion operation.

See Deleting blend faces for more information.

Tracking
The PK_TOPOL_track_r_t structure contains topology tracking information on
the operation. In the case of this function, the tracking information
records returned  will be of type PK_TOPOL_track_derive_c, reporting edges
or faces derived directly from the deleted faces, or of type
 PK_TOPOL_track_create_c for the cap faces if any.

Error handling
If this function returns PK_ERROR_cant_heal_wound, a report of type
PK_REPORT_1_t will be returned via the Parasolid Report mechanism, when
possible. This will contain a record with a 'status' of PK_REPORT_1_bad_blend_c
and 'old_items' containing the identified faces that could not be deleted
successfully.