PK_SURF_find_non_aligned_box

PK_ERROR_code_t    PK_SURF_find_non_aligned_box
(
--- received arguments ---
PK_SURF_t          surf,          --- surface
PK_UVBOX_t         parms,         --- 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
surface.


Specific Errors:
    PK_ERROR_bad_parameter            the parameter box is invalid on 'surf'


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

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.