PK_SURF_parameterise_vector   


PK_ERROR_code_t   PK_SURF_parameterise_vector
(
--- received arguments ---
PK_SURF_t         surf,           --- a surf
PK_VECTOR_t       position,       --- position on surf

--- returned arguments ---
PK_UV_t    *const uv              --- parameters of position on surf
)


Find parameters of a point on a surface


Specific Errors:


Returns the parameters of the given point, provided that it lies on the
given surface. The parameters will lie in the range given in
PK_SURF_ask_uvbox for this surface. At parametric singularities,
such as sphere poles, the non-degenerate parameter is returned as
the lowest value in its range. The function works for any surface type.

The surface must be capable of passing the checks imposed by PK_GEOM_check.