PK_ENTITY_find_reparam

PK_ERROR_code_t                   PK_ENTITY_find_reparam
(
--- received arguments ---
int                               n_entities,
PK_ENTITY_t                      *entities,     --- entities whose
                                                --- parameterisation
                                                --- quality should be
                                                --- assessed
const PK_ENTITY_find_reparam_o_t *options,      --- find reparam options

--- returned arguments ---
PK_ENTITY_find_reparam_r_t *const results       --- find reparam results
)


This function identifies classic geometries, associated with the entities
received in 'entities', for which the reliability of Parasolid operations could
be improved by modifying their parameterisation.


Specific Errors:
    PK_ERROR_unsuitable_entity   (MILD)    'entities' contains an entity
                                            of class other than body, face
                                            or surface, or is an array of
                                            more than one body.


The given 'entities' should be an array of one of the following: a single body
(PK_CLASS_body), a collection of one or more faces (PK_CLASS_face) or a
collection of one or more surfaces (PK_CLASS_surf).

This function searches the entities received in 'entities' for classic
geometries for which the reliability of Parasolid operations could be improved
by modifying their parameterisation. All of the relevant geometries found are
grouped into sets in which all the contained geometries share a common
parameterisation and must be reparameterised simultaneously to preserve the
geometric dependencies between them (e.g. a collection of offsets of a common
underlying surface and the underlying surface itself.)

The sets are complete in that all geometries not found in the search but whose
parameterisation depends on or supports a geometry in the set are also
included. The parameterisation of geometries within a set will therefore not
be affected by reparameterisations of geometries outside of it. Conversely the
parameterisation of geometries outside of the set will not be affected by
reparameterisation of those within it.

Each set is also associated with a recommended revised parameterisation of the
geometries it contains.

The return structure PK_ENTITY_find_reparam_r_t contains the sets of geometries
and recommended reparameterisations. See its documentation for more details.

Surfaces of the following classes are checked for reparameterisation:

    PK_CLASS_bsurf
    PK_CLASS_spun ( with the underlying curve of the class PK_CLASS_bcurve )
    PK_CLASS_swept ( with the underlying curve of the class PK_CLASS_bcurve )
    PK_CLASS_offset ( with the underlying surface of one of the above )

The structure PK_ENTITY_find_reparam_o_t contains user control options. See its
documentation for more details.