PK_BODY_find_extreme

PK_ERROR_code_t                   PK_BODY_find_extreme
(
--- received arguments ---
PK_BODY_t                         body,        --- body on which extreme sought
PK_VECTOR_t                       direction_1, --- first direction
PK_VECTOR_t                       direction_2, --- second direction
PK_VECTOR_t                       direction_3, --- third direction
const PK_BODY_find_extreme_o_t   *options,     --- find extreme options

--- returned arguments ---
PK_VECTOR_t                *const extreme,     --- position of extreme point
PK_TOPOL_t                 *const topol        --- topology on which extreme
                                               --- point lies
)


This function finds the extreme point on the given 'body' in 'direction_1'.
If this extreme is not a single point, then  'direction_2' and 'direction_3'
are used successively to reduce the number of extreme points to one.

Currently 'options' is an empty option structure.


Specific Errors:
    PK_ERROR_coplanar               directions are coplanar
    PK_ERROR_missing_geom           insufficient geometry
    PK_ERROR_cant_find_extreme      failed to find extreme point


'topol' returns the topological entity of the lowest dimensionality on which
the extreme lies (in order of precedence: vertex, edge, face).

The body may not have rubber faces/edges.
The three directions must not be coplanar.

See Finding bounds for more information.