PK_ERROR_code_t                        PK_BCURVE_create_by_fitting
(
--- received arguments ---
const PK_BCURVE_create_by_fitting_o_t *options,  --- options for fitting

--- returned arguments ---
PK_BCURVE_t                            bcurves[],--- array of b-curves, some
                                                 --- possibly PK_ENTITY_null
PK_BCURVE_fit_fault_t           *const fault     --- any faults found
)


This function creates a set of bcurves by curve-fitting to within a tolerance.


Specific Errors:
    PK_ERROR_insufficient_curves    insufficient curves to fit



This function will tolerantly fit one or more bcurves to sets of point and
tangent data. Controls for fitting the bcurves are provided in the
PK_BCURVE_create_by_fitting_o_t option structure. If successful, the
resultant bcurves will have equal knot sets and parameterisation.  The sample
data is provided to the fitting algorithm by evaluator functions which may be
either application-supplied or the Parasolid-internal Chain-of-curves
evaluator.  The Chain-of-curves evaluaton method will fit a single bcurve to a
chain of curves defined by the data provided in the chain field of the
PK_BCURVE_fit_eval_data_t structure.

If during fitting an error occurs an attempt will be made to return bcurves
along with information on the error occuring. The fault structure will
contain status information and error data for the fitting.

For further details see the "B-Curves and B-Surfaces" chapter
of the Functional Description.