PK_BODY_ask_faces

PK_ERROR_code_t   PK_BODY_ask_faces
(
--- received arguments ---
PK_BODY_t         body,             --- a body

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


This function returns the set of faces in the given 'body'.


Depending upon the configuration of the 'body' ( see PK_BODY_ask_config ) this
function returns:
    PK_BODY_config_standard_c      all faces of the standard 'body'

    PK_BODY_config_compound_c      all faces of all children of the compound
                                   'body'

    PK_BODY_config_child_c         all faces of the child 'body'

For solids which were created using the primitive creation functions the
faces are returned in a standard order. For other solids the ordering
is not significant and may change without notice in future product releases.

The output array 'faces' is optional. If it is set to NULL, the function
will only compute the number of faces in the body.

See Data structure enquiries for related functions.