csBox3 Class Reference
[Geometry utilities]
A bounding box in 3D space.
More...
#include <box.h>
Inheritance diagram for csBox3:

Public Methods | |
float | MinX () const |
Get the minimum X value of the box. | |
float | MinY () const |
Get the minimum Y value of the box. | |
float | MinZ () const |
Get the minimum Z value of the box. | |
float | MaxX () const |
Get the maximum X value of the box. | |
float | MaxY () const |
Get the maximum Y value of the box. | |
float | MaxZ () const |
Get the maximum Z value of the box. | |
float | Min (int idx) const |
Get Min component for 0 (x), 1 (y), or 2 (z). | |
float | Max (int idx) const |
Get Max component for 0 (x), 1 (y), or 2 (z). | |
const csVector3 & | Min () const |
Get the 3d vector of minimum (x, y, z) values. | |
const csVector3 & | Max () const |
Get the 3d vector of maximum (x, y, z) values. | |
csVector3 | GetCorner (int corner) const |
Return every corner of this bounding box from 0 to 7. | |
void | GetEdgeInfo (int edge, int &v1, int &v2, int &fleft, int &fright) const |
Given an edge index (CS_BOX_EDGE_Xyz_xyz etc.) return the two vertices (index CS_BOX_CORNER_xyz etc.) and left/right faces (CS_BOX_SIDE_x etc.). | |
uint8 * | GetFaceEdges (int face) const |
Given a face index (CS_BOX_SIDE_x etc.) return the four edges oriented clockwise around this face (CS_BOX_EDGE_Xyz_xyz etc.). | |
csVector3 | GetCenter () const |
Get the center of this box. | |
void | SetCenter (const csVector3 &c) |
Set the center of this box. | |
void | SetSize (const csVector3 &s) |
Set the size of the box but keep the center intact. | |
csBox2 | GetSide (int side) const |
Get a side of this box as a 2D box. | |
int | GetVisibleSides (const csVector3 &pos, int *visible_sides) const |
Fill the array (which should be three long at least) with all visible sides (CS_BOX_SIDE_x etc. | |
csSegment3 | GetEdge (int edge) const |
Return every edge (segment) of this bounding box from 0 to 23 (use one of the CS_BOX_EDGE_Xyz_xyz etc. | |
void | GetEdge (int edge, csSegment3 &e) const |
Return every edge (segment) of this bounding box from 0 to 23 (use one of the CS_BOX_EDGE_Xyz_xyz etc. | |
bool | In (float x, float y, float z) const |
Test if the given coordinate is in this box. | |
bool | In (const csVector3 &v) const |
Test if the given coordinate is in this box. | |
bool | Overlap (const csBox3 &box) const |
Test if this box overlaps with the given box. | |
bool | Contains (const csBox3 &box) const |
Test if this box contains the other box. | |
bool | Empty () const |
Test if this box is empty. | |
void | StartBoundingBox () |
Initialize this box to empty. | |
void | StartBoundingBox (const csVector3 &v) |
Initialize this box to one vertex. | |
void | AddBoundingVertex (float x, float y, float z) |
Add a new vertex and recalculate the bounding box. | |
void | AddBoundingVertex (const csVector3 &v) |
Add a new vertex and recalculate the bounding box. | |
void | AddBoundingVertexSmart (float x, float y, float z) |
Add a new vertex and recalculate the bounding box. | |
void | AddBoundingVertexSmart (const csVector3 &v) |
Add a new vertex and recalculate the bounding box. | |
csBox3 () | |
Initialize this box to empty. | |
csBox3 (const csVector3 &v) | |
Initialize this box with one point. | |
csBox3 (const csVector3 &v1, const csVector3 &v2) | |
Initialize this box with two points. | |
csBox3 (float x1, float y1, float z1, float x2, float y2, float z2) | |
Initialize this box with the given values. | |
void | Set (const csVector3 &bmin, const csVector3 &bmax) |
Sets the bounds of the box with the given values. | |
void | Set (float x1, float y1, float z1, float x2, float y2, float z2) |
Sets the bounds of the box with the given values. | |
void | SetMin (int idx, float val) |
Set Min component for 0 (x), 1 (y), or 2 (z). | |
void | SetMax (int idx, float val) |
Set Max component for 0 (x), 1 (y), or 2 (z). | |
bool | AdjacentX (const csBox3 &other) const |
Test if this box is adjacent to the other on the X side. | |
bool | AdjacentY (const csBox3 &other) const |
Test if this box is adjacent to the other on the Y side. | |
bool | AdjacentZ (const csBox3 &other) const |
Test if this box is adjacent to the other on the Z side. | |
int | Adjacent (const csBox3 &other) const |
Test if this box is adjacent to the other one. | |
int | CalculatePointSegment (const csVector3 &pos) const |
Assume that 3D space is divided into 27 areas. | |
void | GetConvexOutline (const csVector3 &pos, csVector3 *array, int &num_array, bool bVisible=false) const |
Get a convex outline (not a polygon unless projected to 2D) for for this box as seen from the given position. | |
bool | Between (const csBox3 &box1, const csBox3 &box2) const |
Test if this box is between two others. | |
void | ManhattanDistance (const csBox3 &other, csVector3 &dist) const |
Calculate the minimum manhattan distance between this box and another one. | |
float | SquaredOriginDist () const |
Calculate the squared distance between (0,0,0) and the box This routine is extremely efficient. | |
float | SquaredOriginMaxDist () const |
Calculate the squared distance between (0,0,0) and the point on the box which is furthest away from (0,0,0). | |
bool | ProjectBox (const csTransform &trans, float fov, float sx, float sy, csBox2 &sbox, float &min_z, float &max_z) const |
Project this box to a 2D bounding box given the view point transformation and also the field-of-view and shift values (for perspective projection). | |
bool | ProjectOutline (const csTransform &trans, float fov, float sx, float sy, csPoly2D &poly, float &min_z, float &max_z) const |
Project this box to the 2D outline given the view point transformation and also the field-of-view and shift values (for perspective correction). | |
bool | ProjectBoxAndOutline (const csTransform &trans, float fov, float sx, float sy, csBox2 &sbox, csPoly2D &poly, float &min_z, float &max_z) const |
Project this box to the 2D outline given the view point transformation and also the field-of-view and shift values (for perspective correction). | |
csBox3 & | operator+= (const csBox3 &box) |
Compute the union of two bounding boxes. | |
csBox3 & | operator+= (const csVector3 &point) |
Compute the union of a point with this bounding box. | |
csBox3 & | operator *= (const csBox3 &box) |
Compute the intersection of two bounding boxes. | |
bool | TestIntersect (const csBox3 &box) const |
Test if the two boxes have an intersection. | |
Static Public Methods | |
int | OtherSide (int side) |
Static function to get the 'other' side (i.e. | |
Protected Types | |
typedef uint8 | bFace [4] |
Indices of four clock-wise edges (0..23). | |
Protected Attributes | |
csVector3 | minbox |
The top-left of this bounding box. | |
csVector3 | maxbox |
The bottom-right. | |
Static Protected Attributes | |
bEdge | edges [24] |
Index by edge number. | |
bFace | faces [6] |
Index by CS_BOX_SIDE_? number. | |
Friends | |
csBox3 | operator+ (const csBox3 &box1, const csBox3 &box2) |
Compute the union of two bounding boxes. | |
csBox3 | operator+ (const csBox3 &box, const csVector3 &point) |
Compute the union of a bounding box and a point. | |
csBox3 | operator * (const csBox3 &box1, const csBox3 &box2) |
Compute the intersection of two bounding boxes. | |
bool | operator== (const csBox3 &box1, const csBox3 &box2) |
Tests if two bounding boxes are equal. | |
bool | operator!= (const csBox3 &box1, const csBox3 &box2) |
Tests if two bounding boxes are unequal. | |
bool | operator< (const csBox3 &box1, const csBox3 &box2) |
Tests if box1 is a subset of box2. | |
bool | operator> (const csBox3 &box1, const csBox3 &box2) |
Tests if box1 is a superset of box2. | |
bool | operator< (const csVector3 &point, const csBox3 &box) |
Tests if a point is contained in a box. |
Detailed Description
A bounding box in 3D space.In order to operate correctly, this bounding box assumes that all values entered or compared against lie within the range (-CS_BOUNDINGBOX_MAXVALUE, CS_BOUNDINGBOX_MAXVALUE). It is not recommended to use points outside of this range.
Definition at line 503 of file box.h.
Member Typedef Documentation
|
Indices of four clock-wise edges (0..23).
|
Constructor & Destructor Documentation
|
Initialize this box to empty.
Definition at line 751 of file box.h. References CS_BOUNDINGBOX_MAXVALUE. |
|
Initialize this box with one point.
|
|
Initialize this box with two points.
Definition at line 763 of file box.h. References Empty(), and StartBoundingBox(). |
|
Initialize this box with the given values.
Definition at line 768 of file box.h. References Empty(), and StartBoundingBox(). |
Member Function Documentation
|
Add a new vertex and recalculate the bounding box.
Reimplemented in csOBB. Definition at line 709 of file box.h. References AddBoundingVertex(), csVector3::x, csVector3::y, and csVector3::z. |
|
Add a new vertex and recalculate the bounding box.
Definition at line 701 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. Referenced by AddBoundingVertex(). |
|
Add a new vertex and recalculate the bounding box. This version is a little more optimal. It assumes however that at least one point has been added to the bounding box. Definition at line 731 of file box.h. References AddBoundingVertexSmart(), csVector3::x, csVector3::y, and csVector3::z. |
|
Add a new vertex and recalculate the bounding box. This version is a little more optimal. It assumes however that at least one point has been added to the bounding box. Definition at line 719 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. Referenced by AddBoundingVertexSmart(). |
|
Test if this box is adjacent to the other one. Return -1 if not adjacent or else any of the CS_BOX_SIDE_x etc. flags to indicate the side of this box that the other box is adjacent with. |
|
Test if this box is adjacent to the other on the X side.
|
|
Test if this box is adjacent to the other on the Y side.
|
|
Test if this box is adjacent to the other on the Z side.
|
|
Test if this box is between two others.
|
|
Assume that 3D space is divided into 27 areas. One is inside the box. The other 26 are rectangular segments around the box. This function will calculate the right segment for a given point and return that. |
|
Test if this box contains the other box.
Definition at line 667 of file box.h. References maxbox, minbox, csVector3::x, csVector3::y, and csVector3::z. |
|
Test if this box is empty.
Definition at line 675 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. Referenced by csBox3(). |
|
Get the center of this box.
|
|
Get a convex outline (not a polygon unless projected to 2D) for for this box as seen from the given position. The coordinates returned are world space coordinates. Note that you need place for at least six vectors in the array. If you set bVisible true, you will get all visible corners - this could be up to 7. |
|
Return every corner of this bounding box from 0 to 7. This contrasts with Min() and Max() because those are only the min and max corners. Corner 0 = xyz, 1 = xyZ, 2 = xYz, 3 = xYZ, 4 = Xyz, 5 = XyZ, 6 = XYz, 7 = XYZ. Use CS_BOX_CORNER_xyz etc. defines. CS_BOX_CENTER3 also works. Reimplemented in csOBB. Referenced by csPolygonMeshBox::SetBox(). |
|
Return every edge (segment) of this bounding box from 0 to 23 (use one of the CS_BOX_EDGE_Xyz_xyz etc. indices). The returned edge is undefined for any other index. Definition at line 636 of file box.h. References edges, csSegment3::SetEnd(), and csSegment3::SetStart(). |
|
Return every edge (segment) of this bounding box from 0 to 23 (use one of the CS_BOX_EDGE_Xyz_xyz etc. indices). The returned edge is undefined for any other index. Definition at line 626 of file box.h. References edges. |
|
Given an edge index (CS_BOX_EDGE_Xyz_xyz etc.) return the two vertices (index CS_BOX_CORNER_xyz etc.) and left/right faces (CS_BOX_SIDE_x etc.).
Definition at line 565 of file box.h. References edges. |
|
Given a face index (CS_BOX_SIDE_x etc.) return the four edges oriented clockwise around this face (CS_BOX_EDGE_Xyz_xyz etc.).
Definition at line 577 of file box.h. References faces. |
|
Get a side of this box as a 2D box. Use CS_BOX_SIDE_x etc. defines. |
|
Fill the array (which should be three long at least) with all visible sides (CS_BOX_SIDE_x etc. defines) as seen from the given point. Returns the number of visible sides. |
|
Test if the given coordinate is in this box.
Definition at line 652 of file box.h. References In(), csVector3::x, csVector3::y, and csVector3::z. |
|
Test if the given coordinate is in this box.
Definition at line 643 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. Referenced by In(). |
|
Calculate the minimum manhattan distance between this box and another one.
|
|
Get the 3d vector of maximum (x, y, z) values.
|
|
Get Max component for 0 (x), 1 (y), or 2 (z).
Definition at line 543 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. |
|
Get the maximum X value of the box.
|
|
Get the maximum Y value of the box.
|
|
Get the maximum Z value of the box.
|
|
Get the 3d vector of minimum (x, y, z) values.
|
|
Get Min component for 0 (x), 1 (y), or 2 (z).
Definition at line 540 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. |
|
Get the minimum X value of the box.
|
|
Get the minimum Y value of the box.
|
|
Get the minimum Z value of the box.
|
|
Compute the intersection of two bounding boxes.
|
|
Compute the union of a point with this bounding box.
|
|
Compute the union of two bounding boxes.
|
|
Static function to get the 'other' side (i.e. CS_BOX_SIDE_X to CS_BOX_SIDE_x, ...). |
|
Test if this box overlaps with the given box.
Definition at line 658 of file box.h. References maxbox, minbox, csVector3::x, csVector3::y, and csVector3::z. |
|
Project this box to a 2D bounding box given the view point transformation and also the field-of-view and shift values (for perspective projection). The transform should transform from world to camera space (using Other2This). The minimum and maximum z are also calculated. If the bounding box is behind the camera then the 'sbox' will not be calculated (min_z and max_z are still calculated) and the function will return false. If the camera is inside the transformed box then this function will return true and a conservative screen space bounding box is returned. |
|
Project this box to the 2D outline given the view point transformation and also the field-of-view and shift values (for perspective correction). The minimum and maximum z are also calculated. If the box is fully behind the camera then false is returned and this function will not do anything. If the box is partially behind the camera you will get an outline that is conservatively correct (i.e. it will overestimate the box). In addition to the outline this function also returns the projected screen-space box. So it is a combination of ProjectBox() and ProjectOutline(). |
|
Project this box to the 2D outline given the view point transformation and also the field-of-view and shift values (for perspective correction). The minimum and maximum z are also calculated. If the box is fully behind the camera then false is returned and this function will not do anything. If the box is partially behind the camera you will get an outline that is conservatively correct (i.e. it will overestimate the box). |
|
Sets the bounds of the box with the given values.
Definition at line 780 of file box.h. References StartBoundingBox(), csVector3::x, csVector3::y, and csVector3::z. |
|
Sets the bounds of the box with the given values.
|
|
Set the center of this box. This will not change the size of the box but just relocate the center. |
|
Set Max component for 0 (x), 1 (y), or 2 (z).
Definition at line 799 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. |
|
Set Min component for 0 (x), 1 (y), or 2 (z).
Definition at line 791 of file box.h. References csVector3::x, csVector3::y, and csVector3::z. |
|
Set the size of the box but keep the center intact.
|
|
Calculate the squared distance between (0,0,0) and the box This routine is extremely efficient.
|
|
Calculate the squared distance between (0,0,0) and the point on the box which is furthest away from (0,0,0). This routine is extremely efficient. |
|
Initialize this box to one vertex.
|
|
Initialize this box to empty.
Definition at line 684 of file box.h. References CS_BOUNDINGBOX_MAXVALUE, csVector3::x, csVector3::y, and csVector3::z. |
|
Test if the two boxes have an intersection.
|
Friends And Related Function Documentation
|
Compute the intersection of two bounding boxes.
|
|
Tests if two bounding boxes are unequal.
|
|
Compute the union of a bounding box and a point.
|
|
Compute the union of two bounding boxes.
|
|
Tests if a point is contained in a box.
|
|
Tests if box1 is a subset of box2.
|
|
Tests if two bounding boxes are equal.
|
|
Tests if box1 is a superset of box2.
|
Member Data Documentation
|
Index by edge number. Edge e and e+1 with e even are opposite edges. (CS_BOX_EDGE_...) Definition at line 523 of file box.h. Referenced by GetEdge(), and GetEdgeInfo(). |
|
Index by CS_BOX_SIDE_? number.
Definition at line 525 of file box.h. Referenced by GetFaceEdges(). |
|
The bottom-right.
Definition at line 509 of file box.h. Referenced by Contains(), and Overlap(). |
|
The top-left of this bounding box.
Definition at line 507 of file box.h. Referenced by Contains(), and Overlap(). |
The documentation for this class was generated from the following file:
- csgeom/box.h
Generated for Crystal Space by doxygen 1.2.18