PK_VERTEX_attach_points   


PK_ERROR_code_t   PK_VERTEX_attach_points
(
--- received arguments ---
int               n_vertices,     --- number of vertices
const PK_VERTEX_t vertices[],     --- vertices to have points attached
const PK_POINT_t  points[]        --- points to be attached to vertices
)


This function attaches points to vertices.


Specific Errors:
    PK_ERROR_has_parent           point is already attached
    PK_ERROR_geom_not_needed      'vertex' already owns geometry


The arrays vertices and points are both of the length n_vertices.
All the vertices must belong to the same body.

Points may not be shared.  No point may belong to a different body.