PK_EDGE_optimise_o_t

struct PK_EDGE_optimise_o_s
    {
    int                      o_t_version;   --- version number of option
                                            --- structure
    double                   max_dev;       --- the desired maximum
                                            --- deviation (0)
    PK_EDGE_max_dev_t        set_max_dev;   --- whether or not 'max_dev'
                                            --- is set by the user
                                            --- (PK_EDGE_max_dev_edge_tol_c)
    PK_EDGE_optimise_short_t optimise_short;--- whether to optimise short
                                            --- edge
                                            --- (PK_EDGE_optimise_short_no_c)
    };

typedef struct PK_EDGE_optimise_o_s PK_EDGE_optimise_o_t;



This options structure holds optional controls for PK_EDGE_optimise.

Used in:

PK_EDGE_optimise

PK_EDGE_optimise_o_t has the following fields:

'max_dev'                     The desired upper bound for maximum
                              deviation.

'set_max_dev'                 Indicates the value of 'max_dev' is as
                              supplied by the user or the desired upper
                              bound is taken to be the current edge
                              tolerance.

                              If 'set_max_dev' is set to
                              PK_EDGE_max_dev_supplied_c, the user is
                              required to provide a value for 'max_dev'.

                              If 'set_max_dev' is set to
                              PK_EDGE_max_dev_edge_tol_c, the desired
                              upper bound is taken to be the current edge
                              tolerance.

'optimise_short'              Allows user control over whether short
                              edge should be optimised or not. Edge
                              is considered short, if no point on edge
                              is further away from the edge's vertices
                              than their respective vertex tolerances.

                              If 'optimise_short' is set to
                              PK_EDGE_optimise_short_no_c, short edge
                              will not be optimised.

                              If 'optimise_short' is set to
                              PK_EDGE_optimise_short_yes_c, attempt will
                              be made to optimise even short edge.