ENPOGC   

Equivalent PK functions: PK_CURVE_eval_curvature

ENPOGC ( curve, coords, tangnt, prnorm, binorm, curvat, ifail )
===============================================================

  Enquire point on general curve.

Receives:
  KI_tag_curve             *curve          --- curve enquired of
  KI_vec_position           coords         --- position of interest on curve

Returns:
  KI_vec_normal             tangnt         --- tangent direction ratio
  KI_vec_direction          prnorm         --- normal direction ratio
  KI_vec_normal             binorm         --- binormal direction ratio
  KI_dbl_curvature         *curvat         --- curvature
  KI_cod_error             *ifail          --- failure code

Specific errors:
  KI_at_terminator          coords at terminator of curve
  KI_not_on_curve           coords not within resolution distance of curve
  KI_invalid_geometry       the curve fails to pass checks

Description:
  Calculates the tangent, principal normal, binormal and curvature of the
  curve at the given point. The first three are returned as direction
  ratios (normalised vectors).

  The application program should check the curvature, and ignore the
  normals if the curvature is very small.

  An example where this would occur is a straight line, which of course
  has a curvature of zero. In this case the principal normal and binormal
  directions are not returned.

  The curve must be capable of passing the checks imposed by CHCKEN.
  The self intersection check is only performed if the appropriate option is set
  (see SEINTP).