PK_ERROR_code_t PK_EDGE_repair
(
--- received arguments ---
int n_edges, --- number of edges (may be zero)
const PK_EDGE_t edges[], --- edges
const PK_EDGE_repair_o_t *options, --- options structure
--- returned arguments ---
PK_TOPOL_track_r_t *const tracking --- tracking information
)
This function attempts to repair an array of edges, i.e. make them valid.
The option structure determines which type of repair is attempted. At present
there is only one type of repair provided: ensuring that an edge lies on its
adjacent surfaces, by setting a suitable tolerance on the edge if necessary.
Specific Errors:
PK_ERROR_missing_geom either the edge has no curve or the
adjacent faces have no surfaces
PK_ERROR_bad_tolerance either the edge is too short or
the required tolerance is greater than
the 'max_tolerance' option allows
PK_ERROR_failed_to_create_sp SP-curve generator failed
PK_ERROR_tolerances_too_tight SP-curve generator could not achieve
tolerance
This function is primarily intended for use when a model is being imported into
Parasolid via a data exchange format. If necessary, it will set a tolerance on
an edge to ensure that it lies on its adjacent surfaces. The tolerance will
not be greater than the limit given in the option structure.
Tracking information will be returned in tracking. This will contain one
track record for each edge which is split by this operation, if any.