PK_PLINE_create   

PK_ERROR_code_t      PK_PLINE_create
(
--- received arguments ---
const PK_PLINE_sf_t *pline_sf, --- polyline standard form

--- returned arguments ---
PK_PLINE_t    *const pline     --- polyline
)


This function creates a polyline from the standard form.


Specific Errors:
    PK_ERROR_insufficient_points    too few 'positions' have been supplied
                                    (MILD)
    PK_ERROR_coincident_points      repeated consecutive position vectors
                                    (MILD)
    PK_ERROR_incompatible_props     the end points of the polyline coincide
                                    (MILD)


Takes a standard form and creates a polyline. Refer to the documentation
of PK_PLINE_sf_t for a description of the standard form.