PK_ERROR_code_t PK_BSURF_add_v_knot
(
--- received arguments ---
PK_BSURF_t      bsurf,      --- bsurf
double          v           --- V split parameter

--- returned arguments ---
)


This modifies the given bsurf by inserting a knot at the given v split
parameter.


Specific Errors:
    PK_ERROR_is_attached            bsurf is attached to geometry
    PK_ERROR_bad_parameter          bad V parameter given
    PK_ERROR_bad_knots              invalid knot multiplicity


This function modifies a B-surface by inserting a V knot, resulting in
the addition of a (possibly null) column of patches.
The shape of the B-surface is not changed.

The parameter v at which the new knot is to be inserted must be within the
range as given by PK_SURF_ask_params.

The new knot must not increase the multiplicity of any existing knot to more
than the order for an end knot, or order-1 for an internal knot.

If v lies within a patch then a new column of patches will be added to the
surface.

If v lies on a patch boundary then the column of patches added will be null.
Adding a null segment to a surface only affects the B-spline
representation (it duplicates a knot).

A B-surface cannot be modified if it is attached to a face.