PK_CURVE_find_non_aligned_box

PK_ERROR_code_t    PK_CURVE_find_non_aligned_box
(
--- received arguments ---
PK_CURVE_t         curve,          --- curve
PK_INTERVAL_t      t_int,          --- t parameter range

--- returned arguments ---
PK_VECTOR_t *const centre,         --- box centre
PK_VECTOR_t        axes[3],        --- box axes
double             widths[3],      --- box width in each axis direction
int         *const dimension       --- box dimension
)


This function computes a non axis-aligned box bounding a portion of the
given curve.


Specific Errors:
    PK_ERROR_bad_parameter      the given interval is invalid on 'curve' (MILD)


A non axis-aligned box is calculated to enclose the given region of parameter
space on a curve.

The non axis-aligned box is a cuboid described by returning its centre, an
orthonormal set of three axis vectors, and three doubles giving the width of
the box in each axis direction.

Note that the widths are the distances from the centre to the box boundary in
each axis direction, so that the box has volume

            2*widths[0] * 2*widths[1] * 2*widths[2].

An integer 'dimension' indicates when the box degenerates to a plane,
line or point.

         Dimension:                 Significance:
         ----------                 -------------
            0                       a single point.
            1                       an interval on a straight line.
            2                       a rectangular region of a plane.
            3                       a cuboid region of 3-space.

See here for more information.