PK_ENTITY_range

PK_ERROR_code_t            PK_ENTITY_range
(
--- received arguments ---
int                        n_entities_1,  --- no. of entities in first array
const PK_ENTITY_t          entities_1[],  --- first entity array
const PK_TRANSF_t          tf_1[],        --- transforms for first entities
int                        n_entities_2,  --- no. of entities in second array
const PK_ENTITY_t          entities_2[],  --- second entity array
const PK_TRANSF_t          tf_2[],        --- transforms for second entities
const PK_ENTITY_range_o_t *options,       --- options structure [PF]

--- returned arguments ---
PK_ENTITY_range_r_t *const results        --- result structure
)


This function finds the global minimum/maximum separation between two arrays
of entities.

This function offers partial support for facet geometry [PF]


Specific Errors:
    PK_ERROR_bad_option_data       bad option data given (MILD)
    PK_ERROR_bad_parameter         bad parameter given (MILD)
    PK_ERROR_wrong_entity          given entity is of the wrong type (MILD)
    PK_ERROR_missing_geom          given entity has missing geometry (MILD)
    PK_ERROR_no_closest_approach   failed to find closest approach (MILD)
    PK_ERROR_unsupported_transf    unsupported type of transformation (MILD)




PK_ENTITY_range will find the global minimum/maximum distance between the
two arrays of entities 'entities_1' and 'entities_2'.

The following entity types are supported:
    - vertex, edge, face, and body,
    - surface, curve, and point.

One input array cannot contain both geometrical and topological entities.

Dealing with transforms
If 'tf_1' or 'tf_2' is NULL then no entities will be transformed, otherwise
each entity will be transformed by the corresponding transformation.

Each transformation provided must be a rigid motion, a reflection, or
PK_ENTITY_null (in which case it is treated as the identity transformation).