PK_BCURVE_create_spline

PK_ERROR_code_t                    PK_BCURVE_create_spline
(
--- received arguments ---
int                                n_positions,     --- number of positions
const PK_VECTOR_t                 *positions,       --- positions to spline
                                                    --- through
const PK_BCURVE_create_spline_o_t *options,         --- options

--- returned arguments ---
PK_BCURVE_t                 *const bcurve,          --- B-curve
PK_BCURVE_spline_t          *const status,          --- status
int                         *const n_fault_values,  --- number of fault_values
int                        **const fault_values     --- fault values
)


This function creates a B-curve by splining through a set of positions, with
optional parameters and derivatives.

NOTE: This function is deprecated and has been superseded by
PK_BCURVE_create_spline_2.



Specific Errors:
    PK_ERROR_insufficient_points    too few 'positions' have been supplied
                                    (MILD)
    PK_ERROR_bad_position           a position is outside size box (MILD)


At least two distinct positions must be supplied.

Parameters and derivatives corresponding to the positions can be supplied
in the option structure, as can the degree, knotset and periodicity.

The function returns:

    'bcurve'         the created B-curve if the operation is successful.

    'status'         a token indicating the success or otherwise of the
                     operation.

    'n_fault_values' the number of 'fault_values' returned.

    'fault_values'   additional information associated with the value of
                     'status'.  See the documentation of PK_BCURVE_spline_t
                     for details.

See here for more information about this function.