PK_SURF_fix_degens

PK_ERROR_code_t               PK_SURF_fix_degens
(
--- received arguments ---
PK_SURF_t                     surf,       --- surface to be fixed
const PK_SURF_degens_t       *degens,     --- degeneracies
const PK_SURF_fix_degens_o_t *options,    --- options structure

--- returned arguments ---
PK_SURF_fix_degens_r_t *const results     --- results
)


This function attempts to fix degeneracies in the given surface.

This function does not support facet geometry [NF]


Specific Errors:
    PK_ERROR_invalid_geometry     The surface has invalidities other than
                                  degeneracies (PK_ERROR_mild)
    PK_ERROR_fix_degens_failed    Failure (PK_ERROR_serious)


This function generates a valid surface that fits within the supplied tolerance
to the supplied 'surf'. The resultant surface will not have degeneracies,
except possibly for parametric degeneracies along an entire boundary of the
surface (since surfaces with these degeneracies can still be attached to
faces).

PK_SURF_find_degens should first be called on 'surf', and the resulting
PK_SURF_degens_t structure passed to this function.

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