PK_FIN_find_mtopols

PK_ERROR_code_t                PK_FIN_find_mtopols
(
--- received arguments ---
PK_FIN_t                       fin,     --- a fin
const PK_FIN_find_mtopols_o_t *options, --- options structure

--- returned arguments ---
int                     *const n_mvertices,
PK_MVERTEX_t           **const mvertices,
int                     *const n_mfins,
PK_MFIN_t              **const mfins,
PK_LOGICAL_t            *const sense    --- whether the mfins are
                                        --- aligned with the fin
)


This function finds the mvertices and/or mfins along a fin.


Specific Errors:
    PK_ERROR_missing_geom      (MILD)  there is either no curve on the fin and
                                       its edge, or no surface on the face of
                                       the fin
    PK_ERROR_classic_geometry  (MILD)  either the curve on the fin or its edge
                                       is not a polyline, or the surface on the
                                       face of the fin is not a mesh
    PK_ERROR_invalid_geometry  (MILD)  the geometry is invalid


This function returns an array of mvertices and/or an array of mfins which lie
along a given fin. The user may choose whether to return the mvertices or just
the number of mvertices via the options structure, and similarly for mfins.

The order of the mvertices and mfins is in the direction of the fin. A 'sense'
is also returned which is PK_LOGICAL_true if the mfins point in the same
direction as the fin and is PK_LOGICAL_false otherwise.