PK_FACE_identify_blends

PK_ERROR_code_t                    PK_FACE_identify_blends
(
--- received arguments ---
int                                n_faces,     --- number of faces
const PK_FACE_t                    faces[],     --- faces
const PK_blend_identify_t          ident_type,  --- type of blend to identify
const PK_FACE_identify_blends_o_t *options,     --- options [PF]

--- returned arguments ---
PK_FACE_identify_blends_r_t *const results      --- results
)


Given an array of 'faces' (all from the same body) and the type of blends that
should be identified this function will return all constant radius rolling ball
blends of the required 'ident_type' which satisfy the 'options' specified.

This function offers partial support for facet geometry [PF]


Specific Errors:
PK_ERROR_wrong_entity_in_array (MILD) given faces are not from the same body


See Identifying blends for more information.

Terminology:
A "chain of blends" is a connected set of blend faces which have the same
convexity and for which there is a single radius at which we could reapply all
the blends in the chain and produce a result that was within tolerance of the
original blends.

The 'faces' define a set of faces in which to search for blend faces.
Depending on the value of PK_blend_identify_t requested, this
function will return all constant radius rolling ball blend faces within the
set of faces specified, all chains of blends starting from the faces in the
set or all blends that depend on faces in the set but that are not themselves
in the set.

Note: faces with non-manifold topology will not be identified as blends.

The PK_FACE_identify_blends_o_t structure contains user control options.  See
its documentation for details.

Refer to the PK_FACE_identify_blends_r_t documentation for information about
the arrays returned in the 'results' structure.