PK_FACE_ask_faces_adjacent

PK_ERROR_code_t                       PK_FACE_ask_faces_adjacent
(
--- received arguments ---
int                                   n_faces,          --- number of faces
const PK_FACE_t                       faces[],          --- array of faces
const PK_FACE_ask_faces_adjacent_o_t *options,          --- options structure

--- returned arguments ---
int                            *const n_faces_adjacent, --- number of adjacent
                                                        --- faces
PK_FACE_t                     **const faces_adjacent    --- adjacent faces
)


This function returns all faces which are immediately adjacent to the given
array of faces


An adjacent face is one which shares an edge or vertex (or both) with a given
face