PK_ERROR_code_t                     PK_BODY_find_facesets
(
--- received arguments ---
PK_BODY_t                           body,       --- body
int                                 n_edges,    --- no of bounding edges
const PK_EDGE_t                     edges[],    --- bounding edges from body
const PK_BODY_find_facesets_o_t    *options,    --- find options

--- returned arguments ---
PK_BODY_find_facesets_r_t    *const results     --- find results
)



This function finds facesets bounded by given edges on the body.
It returns the facesets selected by the options and, if requested,
their bounding edges.



Specific Errors:
    PK_ERROR_unsuitable_topology    (MILD) one topology is unsuitable
    PK_ERROR_inconsistent_facesets  (MILD) failure to find coherent faceset
                                           and edgeset arrays.



Introduction

The function, based on chains of the connected given edges, finds the facesets
bounded by these chains.
The edges may be supplied in any order.

This function is not supported for general bodies.


PK_BODY_find_facesets Options

The option structure passed to this function provides following controls:

 o selector and alternate to specify whether and how the user
   wants to restrict the resulting facesets.
 o want_bounds to specify if the edges bounding every returned faceset
   are required.

Refer to the PK_BODY_find_facesets_o_t documentation for more
detailed information about the options within this structure.


Returned Arguments

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