PK_FACE_reparameterise_surf

PK_ERROR_code_t                        PK_FACE_reparameterise_surf
(
--- received arguments ---
int                                    n_faces,       --- number of faces
PK_FACE_t                              faces[],       --- faces
const PK_FACE_reparameterise_surf_o_t *options,       --- options

--- returned arguments ---
PK_FACE_reparameterise_surf_r_t *const results        --- results
)


This function reparameterises the surfaces attached to the given 'faces'.
Any sp-curves and intersection curves that are dependent on the surfaces are
modified. Surfaces remain geometrically unaltered.

This function does not support facet geometry [NF]


Specific Errors:
    PK_ERROR_wrong_entity_in_array (MILD)    given faces are not from same
                                             body
    PK_ERROR_duplicate_array_item  (MILD)    duplication in faces array
    PK_ERROR_missing_geom          (MILD)    face does not have a geometry
    PK_ERROR_unsuitable_entity     (MILD)    geometry unsuitable for the
                                             requested reparameterisation
    PK_ERROR_reparam_failed        (SERIOUS) reparameterisation failed




Permitted surface types are PK_CLASS_bsurf, PK_CLASS_offset, PK_CLASS_swept and
PK_CLASS_spun. For surfaces of type PK_CLASS_swept and PK_CLASS_spun,
underlying curve must be of type PK_CLASS_bcurve.

By appropriate specifications in the options structure, this function allows
the U,V directions to be transposed, reversed or rescaled. If more than one
reparameterisation option is specified, then the transforms are applied in the
following order:

    (1) Transpose the U and V directions,
    (2) Reverse the U and/or V directions,
    (3) Rescale the U and/or V directions (using a new parameter interval).

Care should be taken when combining reparameterisation options, since the
reverse and rescale transforms will be applied to the transposed U,V
directions.

Supported reparameterisations for different surface types are:

Surface Type     | Transpose | Reverse U | Reverse V | Rescale U| Rescale V
---------------------------------------------------------------------------
PK_CLASS_bsurf   |    Yes    |   Yes     |    Yes    |   Yes    |  Yes
PK_CLASS_swept   |    No     |   Yes     |    No     |   Yes    |  No
PK_CLASS_spun    |    No     |   Yes     |    No     |   Yes    |  No

For surface of type PK_CLASS_offset, underlying surface type determines
permitted reparameterisations.

Alternatively application may set all reparameterisation  options to
PK_LOGICAL_false, and Parasolid will chose whether to rescale the U/V
intervals to improve surface quality.

If 'geom_sharing' option is set to PK_geom_sharing_keep_fail_c, user must pass
in all construction geometry that is dependent on the surfaces of the faces
passed in.