PK_BSURF_reparameterise

PK_ERROR_code_t                       PK_BSURF_reparameterise
(
--- received arguments ---
PK_BSURF_t                            bsurf,       --- bsurf to reparameterise
const PK_BSURF_reparameterise_o_t    *options      --- option structure
)


This function performs a general U,V reparameterisation of the received
'bsurf', including options to transpose, reverse or rescale the U,V
directions. The 'bsurf' remains geometrically unaltered.


Specific Errors:
    PK_ERROR_bad_interval             (MILD) Knots of the new interval are too
                                             close to each other
    PK_ERROR_is_attached              (MILD) 'bsurf' could not be
                                             reparameterised because it is
                                             attached to topology or owned by
                                             other geometry


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.

Note also that transposing the U and V directions, or reversing a single
parameter direction, will reverse the direction of the surface normal.