PK_MFACET_ask_mfacet_adjacent

PK_ERROR_code_t    PK_MFACET_ask_mfacet_adjacent
(
--- received arguments ---
PK_MFACET_t        mfacet,         --- the 'mfacet'
PK_MFIN_index_t    mfin_index,     --- index of mfin within 'mfacet'

--- returned arguments ---
PK_MFACET_t *const mfacet_adjacent --- adjacent mfacet
)


This function returns the adjacent mfacet to the given 'mfacet' which abuts
this 'mfacet' along the mfin with the given 'mfin_index'. If the mfin with the
given 'mfin_index' is laminar then the returned 'mfacet_adjacent' will be
PK_MTOPOL_null. The mfin_index is either 0, 1 or 2.


Specific Errors:
    PK_ERROR_bad_mfin_index     The mfin_index value is not valid. (MILD)