PK_FACE_classify_details

PK_ERROR_code_t                     PK_FACE_classify_details
(
--- received arguments ---
int                                 n_facesets,  --- number of facesets
PK_FACE_array_t                     facesets[],  --- facesets
PK_detail_t                         details[],   --- details
const PK_FACE_classify_details_o_t *options,     --- options structure

--- returned arguments ---
PK_FACE_classify_details_r_t *const results      --- results
)


This function classifies the given faceset as details of some type.

This function does not support facet geometry [NF]


Specific Errors:
    PK_ERROR_not_implemented       (MILD) requested option not implemented
    PK_ERROR_not_connected         (MILD) the faces of a faceset do not form
                                   a connected set
    PK_ERROR_not_in_same_body      (MILD) faces not all from same body
    PK_ERROR_duplicate_array_item  (MILD) some face appears more than once in
                                   a faceset


This function attempts to recognize each of the given 'facesets' as comprising
a detail whose form is indicated by the corresponding entry in the 'details'
argument.

If the faceset cannot be recognized as such a detail then the 'detail_type' in
the PK_detail_def_t for this faceset will be set to PK_detail_type_unknown_c.

If the faceset can be recognized as such a detail, then the 'detail_type' will
be set to the appropriate type and the detail definition for that type will
be placed in the 'detail' field of the PK_detail_def_t.

RESTRICTIONS:
Currently members of the 'details' array may only take the values:
    PK_detail_hole_cyl_c
    PK_detail_hole_cyl_through_c
    PK_detail_hole_cyl_blind_c
If the detail is set to PK_detail_hole_cyl_c then both through and blind holes
will be recognized.  If set to one of the others, then only through or blind
holes will be recognized.

RESTRICTIONS ON HOLE RECOGNITION:
 - a hole cannot be recognized if any loop bounding the given faceset does
   not encircle the hole axis
 - a hole cannot be recognized if it has a blend at an open end onto more than
   one face (ie the blend itself is composed of more than one face)