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:
    PK_ERROR_invalid_geometry   Surface fails geometry checks.(MILD)
    PK_ERROR_not_on_surface     Given 'position' is not on or lies
                                outside of the parameteric limits of
                                the surface.(MILD)
    PK_ERROR_system_error       Parameters for the given 'position'
                                could not be determined.(MILD)



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.