PK_TOPOL_remove_body_component

PK_ERROR_code_t  PK_TOPOL_remove_body_component
(
--- received arguments ---
const PK_TOPOL_t topol,     --- a topological entity in required component

--- returned arguments ---
PK_BODY_t *const body       --- result body
)


This function extracts a connected component of a body as a new body.


Specific Errors:
    PK_ERROR_unsuitable_entity    given region is not solid


The given topological entity 'topol' may be a vertex, edge, face, or solid
region.  The function determines the connected component of the owning body
which contains 'topol' and removes it into another body.  If the body is not
disjoint then 'body' will be PK_ENTITY_null.