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

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


Given an array of faces (all belonging to 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.


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


Terminology:
A "chain of blends" is a connected set of blend faces which have the same
radius and convexity.


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.

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.