PK_CURVE_find_length

PK_ERROR_code_t      PK_CURVE_find_length
(
--- received arguments ---
PK_CURVE_t           curve,      --- curve to find length of
PK_INTERVAL_t        interval,   --- parametric interval of curve

--- returned arguments ---
double        *const length,     --- nominal arc length of curve
PK_INTERVAL_t *const range       --- range bounding actual arc length
)


This function evaluates the arc length of that part of the given curve
specified by the given parametric interval.


Specific Errors:
    PK_ERROR_zero_interval      the 'interval' has no parametric extent (MILD)
    PK_ERROR_curve_too_short    the requested interval of the curve has
                                no physical extent (MILD)


The information is returned in the form of a calculated arc 'length' and an
interval containing lower and upper bounds on the true arc length.
For curves of class PK_CLASS_line or PK_CLASS_circle, the returned 'length'
is exact.  For all other curves, the 'length' is an approximation.