PK_CURVE_eval_curvature_handed

PK_ERROR_code_t     PK_CURVE_eval_curvature_handed
(
--- received arguments ---
PK_CURVE_t          curve,            --- curve to receive message
double              t,                --- parametric position on curve
PK_HAND_t           hand_direction,   --- evaluation direction

--- returned arguments ---
PK_VECTOR1_t *const tangent,          --- tangent
PK_VECTOR1_t *const principal_normal, --- principal normal
PK_VECTOR1_t *const binormal,         --- binormal
double       *const curvature         --- curvature
)


This function behaves like PK_CURVE_eval_curvature but takes an
additional direction argument.


Specific Errors:
    PK_ERROR_bad_parameter            not permitted to evaluate outside of
                                      range (MILD)
    PK_ERROR_at_terminator            parameter at terminator of the curve
                                      (MILD)
    PK_ERROR_eval_failure             internal evaluator failure (MILD)


Like PK_CURVE_eval_curvature, this function returns the curvature, tangent,
principal normal and binormal at a given parameter on a curve segment
determined by an additional direction argument ( see the definition in
PK_CURVE_eval_handed ).