PK_BODY_create_topology_o_t

struct PK_BODY_create_topology_o_s
    {
    int              o_t_version;    --- version number
    PK_BODY_type_t   body_type;      --- preferred result body type
                                     --- (PK_BODY_type_general_c)
    int              n_extra_faults; --- number of extra faults to return (0)
    PK_BODY_fault_t *extra_faults;   --- extra faults to return (NULL)
    };
typedef struct PK_BODY_create_topology_o_s
               PK_BODY_create_topology_o_t;



This structure contains optional controls for PK_BODY_create_topology

Used in:

PK_BODY_create_topology

The fields are as follows:

'body_type'        This indicates the expected type of the created body.  If
                   the body cannot be made to be of this type then its type
                   will be PK_BODY_type_general_c.  Note that if a body just
                   consists of any number of isolated vertices, then the
                   expected type may be specified as either
                   PK_BODY_type_minimum_c or PK_BODY_type_acorn_c.

'n_extra_faults'   number of extra faults that may be returned.  See "Extra
                   Faults" below.

'extra_faults'     extra faults that may be returned. See "Extra Faults"
                   below.

Extra Faults:
By default, PK_BODY_create_topology will only return the specific faults:
    PK_BODY_fault_wrong_child_c
    PK_BODY_fault_extra_parent_c
    PK_BODY_fault_extra_child_c
    PK_BODY_fault_missing_parent_c
    PK_BODY_fault_bad_loop_c
    PK_BODY_fault_bad_shells_c
    PK_BODY_fault_bad_region_c
    PK_BODY_fault_extra_parent_c.
Any other fault is returned as PK_BODY_fault_unknown_c.  The fields
'n_extra_faults' and 'extra_faults' may be used to request that further
specific topological faults may be returned.  The extra faults that may be
requested are:
    PK_BODY_fault_bad_fa_sh_rg_c
    PK_BODY_fault_disjoint_shell_c
    PK_BODY_fault_empty_region_c