PK_BODY_contains_vector

PK_ERROR_code_t       PK_BODY_contains_vector
(
--- received arguments ---
PK_BODY_t             body,      --- the body
PK_VECTOR_t           vector,    --- the position vector

--- returned arguments ---
PK_enclosure_t *const enclosure, --- enclosure code
PK_TOPOL_t     *const topology   --- topology which coincides with given vector
)


This function determines whether the point represented by the given
position vector lies inside, outside, or on the boundary of the given body.


The unique topological entity of lowest dimensionality which belongs to the
the body and coincides with or contains the point is also returned.

A vertex, edge, or face is regarded as being on the boundary of the
body if it is adjacent to one or more void regions; otherwise, it is
regarded as lying inside the body.

The following combinations of return arguments are possible:

                       returned                returned
  containment          enclosure code          topological entity
  -----------          --------------          ------------------
  inside:              PK_enclosure_inside_c   a vertex, edge, face, or
                                               solid region
  outside:             PK_enclosure_outside_c  a void region
  on the boundary:     PK_enclosure_on_c       a vertex, edge, or face