PK_MESH_find_laminar_mfins

PK_ERROR_code_t                       PK_MESH_find_laminar_mfins
(
--- received arguments ---
PK_MESH_t                             mesh,      --- the mesh
const PK_MESH_find_laminar_mfins_o_t *options,   --- option structure

--- returned arguments ---
PK_MESH_find_laminar_mfins_r_t *const results    --- results structure
)


This function returns the laminar mfins in the given 'mesh'.


Specific Errors:
    PK_ERROR_mesh_has_no_mfins        The mesh has no mfins. (MILD)
    PK_ERROR_mesh_open_components     The mesh has open components
                                      and the 'open_comps' option is
                                      PK_MESH_open_comps_no_c. (MILD)
    PK_ERROR_bad_option_data          Bad option data. (MILD)


The laminar mfins are grouped into components. A component is a connected set
of mfins ordered in the direction of the mfins. Each component will have
at least one mfin, but the number of components may be zero. Components will
be divided at any mvertex that has more than one laminar mfin pointing into it.

In general each component will correspond to a closed loop of mfins, but where
these cannot be unambiguously determined, the 'open_comps' option controls how
and whether open components are returned. If the 'open_comps' option is set to
PK_MESH_open_comps_no_c (the default) then each component corresponds to a
closed loop of mfins. Otherwise the components may be open.

The PK_MESH_find_laminar_mfins_o_t structure contains user control options.
See its documentation and here for details.

The components are returned in a PK_MESH_find_laminar_mfins_r_t structure.