PK_GEOM_range_vector_many_o_t

struct PK_GEOM_range_vector_many_o_s
    {
    int                 o_t_version;    --- version number of option structure
    PK_LOGICAL_t        have_tolerance; --- whether tolerance value is
                                        --- provided (PK_LOGICAL_false)
    double              tolerance;      --- tolerance on accuracy of
                                        --- distance measurement
    PK_range_bound_t    bound;          --- bounds on minimum separation
    PK_range_guess_t   *guesses;        --- guesses for end on 'geom' (NULL)
                                        --- [NF]
    PK_range_opt_t      opt_level;      --- the level of analysis
                                        --- (PK_range_opt_performance_c)
    };

typedef struct PK_GEOM_range_vector_many_o_s PK_GEOM_range_vector_many_o_t;



The structure contains optional controls for PK_GEOM_range_vector_many.

Used in:

PK_GEOM_range_vector_many

'have_tolerance'     whether a tolerance value is provided.

'tolerance'          a tolerance on the accuracy of the minimum distance
                     measurement. This will allow slacker computation of
                     minimum distance, when default accuracy is not required.
                     The default accuracy will be the linear precision
                     of the modeller.

'bound'              structure consisting of:
                     'have_upper_bound'  whether an upper bound is supplied.
                     'upper_bound'       an upper bound on the minimum
                                         distance to be computed.
                                         If supplied the minimum distance
                                         achieved will only be identified
                                         if it is less than the bound.
                     'have_lower_bound'  whether a lower bound is supplied.
                     'lower_bound'       a lower bound on the minimum distance.
                                         For this option, if the closest
                                         approach between entities is found
                                         to be less than this bound, no
                                         solution will be determined.

'guesses'             an array of estimate structures, for the end of the
                      separation on the geometry, of the form:

                     'type'        form of guess, either:
                                   PK_range_guess_no_c     : no guess
                                   PK_range_guess_param_c  : parametric guess
                                   PK_range_guess_vector_c : position guess.
                     'parameters'  an array of up to 2 parameters.
                     'vector'      end position vector.

                     For a curve, a curve parameter estimate may be supplied.
                     For a surface, surface parameter estimates may be
                     supplied.
                     For a curve or surface, a position vector estimate
                     may be supplied. Such an estimate is expected to
                     be on or close to the entity.
                     You may specify either a position vector estimate or
                     a parameter estimate but not both types of estimate.

                     The array contains the estimates of the closest points
                     for the positions provided in 'vectors'.
                     If no estimate is supplied the 'guesses' can be NULL
                     otherwise it must have length 'n_vectors'.

                     Currently, it is not possible to provide estimates for a
                     subset of the positions.

'opt_level'          an option to control the level of analysis that is
                     undertaken to resolve closely separated local minima.
                     (PK_range_opt_performance_c)


See here for more information about the options available.