PK_TOPOL_make_general_body

PK_ERROR_code_t   PK_TOPOL_make_general_body
(
--- received arguments ---
int               n_topols,     --- number of topologies (> 0)
const PK_TOPOL_t  topols[],     --- array of topologies

--- returned arguments ---
PK_BODY_t  *const body,         --- general body
PK_TOPOL_t        copy_topols[] --- corresponding copy topologies
)


This function creates a general body from a set of topologies.


The geometry, topology and associated data of the 'topols' are copied into a
new general body.  If the new body requires additional regions and shells to
make it valid, then these are created.  Each member of 'topols' must be a
region, face, edge or vertex, which may occur in any combination and in any
order.  All the given 'topols' must belong to the same body which may be of any
type.

If 'topols' contains any tolerant edges, the copies of these tolerant edges in
the resultant body will have no geometry attached. In such cases, consider
using PK_EDGE_make_wire_body instead.

The new general body will be returned in 'body'.  The array 'copy_topols' is
the same length as 'topols' and each member of 'copy_topols' will be the copy
of the corresponding member of 'topols'.