PK_BODY_ask_vertices

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

--- returned arguments ---
int          *const n_vertices,     --- number of vertices (>= 0)
PK_VERTEX_t **const vertices        --- vertices (optional)
)


This function returns the set of vertices 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 vertices of the standard 'body'

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

    PK_BODY_config_child_c         all vertices of the child 'body'

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

See Data structure enquiries for related functions.