SbBox3f(3IV)

NAME
     SbBox3f (SbBox3f) - 3D box class

INHERITS FROM
     SbBox3f

SYNOPSIS
     #include <Inventor_c/SbBox.h>

          Functions from class SbBox3f:

     SbBox3f *           SbBox3fCreate()
     SbBox3f *           SbBox3fCreateBounds(float xmin, float ymin, float
                              zmin float xmax, float ymax, float zmax)
     SbBox3f *           SbBox3fCreateMinMax(const SbVec3f *min, const SbVec3f
                              *max)
     voidvoid            SbBox3fDelete(SbBox3f *this)
     const SbVec3f *     SbBox3fGetMinConst(SbBox3f *this)
     const SbVec3f *     SbBox3fGetMaxConst(SbBox3f *this)
     SbVec3f             SbBox3fGetCenter(SbBox3f *this)
     void                SbBox3fExtendByPt(SbBox3f *this, const SbVec3f
                              *point)
     void                SbBox3fExtendByBox(SbBox3f *this, const SbBox3f *box)
     SbBool              SbBox3fIntersectPt(SbBox3f *this, const SbVec3f
                              *point)
     SbBool              SbBox3fIntersectBox(SbBox3f *this, const SbBox3f
                              *box)
     void                SbBox3fSetBounds(SbBox3f *this, float xmin, float
                              ymin, float zmin, float xmax, float ymax, float
                              zmax)
     void                SbBox3fSetBoundsMinMax(SbBox3f *this, const SbVec3f
                              *min, const SbVec3f *max)
     void                SbBox3fGetBounds(SbBox3f *this, float *xmin, float
                              *ymin, float *zmin, float *xmax, float *ymax,
                              float *zmax)
     void                SbBox3fGetBoundsMinMax(SbBox3f *this, SbVec3f *min,
                              SbVec3f *max)
     void                SbBox3fGetOrigin(SbBox3f *this, float *x0, float *y0,
                              float *z0)
     void                SbBox3fGetSize(SbBox3f *this, float *x, float *y,
                              float *z)
     void                SbBox3fMakeEmpty(SbBox3f *this)
     SbBool              SbBox3fIsEmpty(SbBox3f *this)
     SbBool              SbBox3fHasVol(SbBox3f *this)
     void                SbBox3fGetSpan(SbBox3f *this, SbVec3f *dir, float
                              *dMin, float *dMax)
     void                SbBox3fXf(SbBox3f *this, const SbMatrix *mx)
     float               SbBox3fGetVol(SbBox3f *this)

DESCRIPTION
     3D box which has planes parallel to the major axes and is specified by
     two points on a diagonal. This class is part of the standard Inventor
     datatype classes and is used as input and output to geometry operations
     (see SoGetBoundingBoxAction).

FUNCTIONS
     SbBox3f *           SbBox3fCreate()
     SbBox3f *           SbBox3fCreateBounds(float xmin, float ymin, float
                              zmin float xmax, float ymax, float zmax)
     SbBox3f *           SbBox3fCreateMinMax(const SbVec3f *min, const SbVec3f
                              *max)
     voidvoid            SbBox3fDelete(SbBox3f *this)
          Constructors and destructor for a 3D float box. xmin, ymin, zmin,
          xmax, ymax and zmax are the bounds of the box. min and max are the
          corners of the diagonal that define the box.

     const SbVec3f *     SbBox3fGetMinConst(SbBox3f *this)
     const SbVec3f *     SbBox3fGetMaxConst(SbBox3f *this)
          Returns the minimum and maximum points of the box. The minimum point
          is the corner of the box with the lowest X, Y, and Z values. The
          maximum point is the corner of the box with the highest X, Y, and Z
          values.

     SbVec3f             SbBox3fGetCenter(SbBox3f *this)
          Returns the center of the box.

     void                SbBox3fExtendByPt(SbBox3f *this, const SbVec3f
                              *point)
     void                SbBox3fExtendByBox(SbBox3f *this, const SbBox3f *box)
          Extends this box (if necessary) to contain the specified point or
          other box.

     SbBool              SbBox3fIntersectPt(SbBox3f *this, const SbVec3f
                              *point)
     SbBool              SbBox3fIntersectBox(SbBox3f *this, const SbBox3f
                              *box)
          Returns TRUE if the specified point or box intersects this box.

     void                SbBox3fSetBounds(SbBox3f *this, float xmin, float
                              ymin, float zmin, float xmax, float ymax, float
                              zmax)
     void                SbBox3fSetBoundsMinMax(SbBox3f *this, const SbVec3f
                              *min, const SbVec3f *max)
          Sets the corners of the box.

     void                SbBox3fGetBounds(SbBox3f *this, float *xmin, float
                              *ymin, float *zmin, float *xmax, float *ymax,
                              float *zmax)
     void                SbBox3fGetBoundsMinMax(SbBox3f *this, SbVec3f *min,
                              SbVec3f *max)
          Gets the corners of the box.
     void                SbBox3fGetOrigin(SbBox3f *this, float *x0, float *y0,
                              float *z0)
          Gets box origin which is the same as the minimum corner of the box.

     void                SbBox3fGetSize(SbBox3f *this, float *x, float *y,
                              float *z)
          Gets box size.

     void                SbBox3fMakeEmpty(SbBox3f *this)
          Makes an empty box.

     SbBool              SbBox3fIsEmpty(SbBox3f *this)
          Returns TRUE if the box is empty, and FALSE otherwise.

     SbBool              SbBox3fHasVol(SbBox3f *this)
          Returns TRUE if all three dimensions of the box have positive size,
          and FALSE otherwise.

     void                SbBox3fGetSpan(SbBox3f *this, SbVec3f *dir, float
                              *dMin, float *dMax)
          Finds the span of a box along a specified direction. The span is the
          total distance the box occupies along a given direction. The total
          distance is returned in the form of a minimum and maximum distance
          from the origin of each of the corners of the box along the given
          direction. The difference between these two values is the span.

     void                SbBox3fXf(SbBox3f *this, const SbMatrix *mx)
          Transforms box by matrix, enlarging box to contain result.

     float               SbBox3fGetVol(SbBox3f *this)
          Returns the volume of the box.


FILE FORMAT/DEFAULTS
     Box3f {
     }

SEE ALSO
     SbXfBox3f, SbBox2f, SbBox2s, SbVec3f, SbVec2f, SbVec2s, SbMatrix,
     SoGetBoundingBoxAction