PK_CURVE_fix_degens

PK_ERROR_code_t                PK_CURVE_fix_degens
(
--- received arguments ---
PK_CURVE_t                     curve,      --- curve to be fixed
const PK_CURVE_degens_t       *degens,     --- degeneracies
const PK_CURVE_fix_degens_o_t *options,    --- options structure

--- returned arguments ---
PK_CURVE_fix_degens_r_t *const results     --- results
)


This function attempts to fix degeneracies on the given curve.

This function does not support facet geometry [NF]


Specific Errors:
    PK_ERROR_invalid_geometry       The curve has invalidities other than
                                    degeneracies or self-intersections (MILD)
    PK_ERROR_cant_make_valid_split  The SP-curve cannot be repaired by
                                    splitting (SERIOUS)
    PK_ERROR_fix_degens_failed      Failure (SERIOUS)


This function generates one or more valid curves that, where possible, fit
within tolerance to the supplied 'curve'. The resultant curve(s) will be free
of degeneracies.

PK_CURVE_find_degens should first be called on 'curve', and the resulting
PK_CURVE_degens_t structure passed to this function.

If 'curve' is an SP-curve that crosses degeneracies on the underlying surface,
it will be split at the degeneracies, and multiple resultant curves returned.
If this is not possible without trimming (and thus producing a broken chain
of SP-curves) the error PK_ERROR_cant_make_valid_split will be returned and
the surface should be repaired instead.

Where possible, the maximum deviation between 'curve' and the resultant
approximation will be limited by 'tolerance', however this condition is not
guaranteed.

See here for more information.