PK_BODY_find_facesets

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 all the facesets on the body and splits those that are
divided by the input edges into smaller facesets. It then returns the facesets
that are selected by the options and, if requested, the input edges that
bound each faceset.



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



Introduction

This function finds all the facesets made up of back faces of the given 'body'.
From these facesets, it returns those that are selected by the options. The
default behaviour is to return all the facesets.

See Finding facesets in the Functional Description for more
information.

A faceset is all the faces in a shell of the 'body' that contains back
faces, unless the shell's faces are divided into two or more subsets by some
of the input edges, in which case each subset is a separate faceset.

The 'edges' may be supplied in any order. If no edges are supplied then there
will be as many facesets as there are shells that contain back faces in the
body.

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 facesets returned by the function.
 o 'want_bounds' to specify if the edges bounding each 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.