PK_MFACET_find_perimeters_o_t

struct PK_MFACET_find_perimeters_o_s
    {
    int                      o_t_version;  --- version number
    PK_LOGICAL_t             want_plines;  --- whether to return
                                           --- pline(s) and pline_mfins
                                           --- for each mloop
                                           --- (PK_LOGICAL_false)
    PK_MTOPOL_track_t        track_type;   --- type of mfacetset
                                           --- tracking
                                           --- (PK_MTOPOL_track_none_c)
    PK_MTOPOL_select_cb_f_t  select_cb;    --- callback function
                                           --- (NULL)
    PK_POINTER_t             select_data;  --- context data for the
                                           --- callback function
                                           --- (NULL)
    PK_CLASS_t               select_mtopol_class;
                                           --- class type of the input
                                           --- mtopol of the callback
                                           --- (PK_CLASS_mfin)
    PK_selector_type_t       select_wire_mfins;
                                           --- whether to include
                                           --- wire mfins in the
                                           --- perimeters
                                           --- (PK_selector_type_exclude_c)
    int                      min_n_mfacets;
                                           --- only return perimeters and
                                           --- other data for mfacetsets with
                                           --- at least this number of mfacets
                                           --- (1)
    };

typedef struct PK_MFACET_find_perimeters_o_s PK_MFACET_find_perimeters_o_t;



This structure contains optional arguments for PK_MFACET_find_perimeters.

Used in:

PK_MFACET_find_perimeters

The options provided are:

'want_plines'               If set to PK_LOGICAL_true then one or more
                            polylines will be returned as a PK_PLINE_t for
                            each mloop.

'track_type'                This option allows the application to specify the
                            type of tracking in 'track_mfacetsets' in the
                            results structure. Currently, this must be set to
                            the default PK_MTOPOL_track_none_c, otherwise
                            PK_ERROR_not_implemented is returned.

'select_cb'                 This callback function of type
                            PK_MTOPOL_select_cb_t determines the criterion for
                            selecting either the given mfacet, or the mfacet of
                            the given mfin. If 'select_cb' is set to NULL, the
                            selection of mfacets will be limited to
                            `mfacets[]'. See here for more
                            information.

'select_data'               This is a pointer to application data that may be
                            used to communicate information between the
                            application and its callback function 'select_cb'.

'select_mtopol_class'       This determines the class of mtopol passed to
                            'select_cb'. If 'select_mtopol_class' is
                            PK_CLASS_mfin, the selected facet will be the
                            mfacet of the given mfin.
                            The class PK_CLASS_mvertex is currently not
                            allowed and returns PK_ERROR_not_implemented. See
                            here for more information.

'select_wire_mfins'         If set to PK_selector_type_include_c, the
                            wire mfin portions of perimeters will
                            be included in the return structure.
                            If set to PK_selector_type_exclude_c,
                            the wire mfin portions will be omitted.
                            PK_selector_type_off_c is not a valid option and
                            setting 'select_wire_mfins' to this value will
                            return PK_ERROR_not_implemented.

'min_n_mfacets'             If set to a non-negative integer, mfacetsets with
                            fewer than this number of facets will be ignored.
                            For example, 'num_perimeters' will refer only to
                            perimeters of mfacetsets with at least this number
                            of mfacets, and similarly for all other returned
                            data.