PK_ERROR_code_t      PK_EDGE_split_at_param
(
--- received arguments ---
PK_EDGE_t            edge,          --- Target edge
double               param,         --- parameter to split at

--- returned arguments ---
PK_VERTEX_t   *const new_vertex,    --- new vertex
PK_EDGE_t     *const new_edge       --- new edge (may be null)
)


This function splits an edge at the given parameter.


Specific Errors:

    PK_ERROR_bad_parameter              Supplied parameter is outside
                                        edge range.
    PK_ERROR_coincident                 Supplied parameter evaluates to
                                        a point coincident with edge
                                        vertex
    PK_ERROR_bad_edge                  edge does not have geometry





Description

The edge is split at given parameter. Allowable parameter range
can be found by using 'PK_EDGE_ask_geometry'.

The function will handle both accurate and tolerant edges.

As a result new vertex and new edge may be created. The returned agruments
must point to a valid storage.

If given parameter is outside the edge range, 'PK_ERROR_bad_parameter'
will be raised. Also if the parameter evaluates to a position coincident
with any of the edge vertices then 'PK_ERROR_coincident' will be raised.
Vertex tolerance is taken into account.