PK_EDGE_optimise

PK_ERROR_code_t                    PK_EDGE_optimise
(
--- received arguments ---
PK_EDGE_t                          edge,                --- edge to be
                                                        --- optimised
const PK_EDGE_optimise_o_t        *options,             --- option structure

--- returned arguments ---
PK_EDGE_optimise_result_t   *const result,              --- whether the edge
                                                        --- has been modified
double                      *const achieved_deviation   --- maximum measured
                                                        --- deviation
)


Given a tolerant edge, this function attempts to set a tolerance on
the edge that lies between the maximum deviation and the desired upper bound.




Definitions

Maximum deviation     The maximum deviation is the greatest deviation
                      between any two curves of the edge including all fin
                      curves and any nominal geometry.


The function returns a 'result', of type PK_EDGE_optimise_result_t
which has two values PK_EDGE_optimise_success_c and
PK_EDGE_optimise_failure_c.

PK_EDGE_optimise_success_c indicates that the edge tolerance has been
modified such that it lies between the maximum deviation and the desired upper
bound specified by the user.

PK_EDGE_optimise_failure_c indicates that Parasolid was unable to find a new
tolerance for the edge that lay between the maximum deviation and the desired
upper bound specified by the user.

The 'achieved_deviation' is always returned (regardless of whether the edge
was optimised) and reflects the maximum deviation.