PK_SURF_ask_faces   


PK_ERROR_code_t   PK_SURF_ask_faces
(
--- received arguments ---
PK_SURF_t         surf,             --- a surface

--- returned arguments ---
int        *const n_faces,          --- number of faces (>= 0)
PK_FACE_t **const faces             --- faces (optional)
)


This function returns the set of faces to which the given surface is attached.


The output array faces is optional. If it is set to NULL, then the function
will only compute the number of faces lying on a surface.