Defines a 2D bounding box. More...
Public Member Functions | |
ModelData_Box2d () | |
Constructor. Creates a box with infinite boundaries. | |
ModelData_Box2d (const ModelData_Point2dd &theCorner1, const ModelData_Point2dd &theCorner2) | |
Constructor. More... | |
ModelData_Box2d (const Bnd_Box2d &theBox) | |
Constructor. | |
const ModelData_Point2d & | MinCorner () const |
ModelData_Point2d & | MinCorner () |
const ModelData_Point2d & | MaxCorner () const |
ModelData_Point2d & | MaxCorner () |
ModelData_Point2d | Center () const |
Returns a center point. Returns a middle of the diagonal between MinCorner() and MaxCorner(). | |
void | Add (const ModelData_Point2d &thePoint) |
Adjusts the box corners so that it contains thePoint. More... | |
void | Add (const ModelData_Box2d &theBox) |
Adjusts the box corners so that it contains theBox. | |
void | Clear () |
Resets the box. More... | |
void | SetXRange (double theMin, double theMax) |
Sets the range of box along X axis to the specified values. | |
void | SetYRange (double theMin, double theMax) |
Sets the range of box along Y axis to the specified values. | |
void | SetRange (size_t theIdx, double theMin, double theMax) |
Sets one range of the box to the specified values. More... | |
double | Range (size_t theIdx) const |
Returns the length of range along specified axis. | |
double | XRange () const |
Returns the length of range along X axis. | |
double | YRange () const |
Returns the length of range along Y axis. | |
void | Enlarge (double theX, double theY) |
Enlarge the box dimensions by specified values. More... | |
void | Enlarge (double theSize) |
Enlarge the box dimensions by specified value. More... | |
ModelData_Box2d | Enlarged (double theX, double theY) const |
Return the box with dimensions enlarged by specified values. More... | |
ModelData_Box2d | Enlarged (double theSize) const |
Return the box with dimensions enlarged by specified value. More... | |
bool | IsIn (const ModelData_Point2d &thePoint) const |
Returns true if the point lies inside the box. | |
bool | Intersects (const ModelData_Box2d &theOther) const |
Returns the other box has at least one common point with this box. | |
bool | IsInfinite () const |
Returns true if at least one coordinate is infinite. More... | |
void | Multiply (double theValue) |
Scales box by scalar value. More... | |
ModelData_Box2d | Multiplied (double theValue) const |
Returns the box scaled by scalar value. | |
void | Transform (const ModelData_Transformation2d &theTransformation) |
Transforms the box. More... | |
ModelData_Box2d | Transformed (const ModelData_Transformation2d &theTransformation) const |
Returns the transformed box. | |
operator Bnd_Box2d () const | |
Casts to a Bnd_Box object. | |
Defines a 2D bounding box.
The box is defined via two corners - MinCorner() and MaxCorner() - containing minimum and maximum coordinates respectively.
cadex::ModelData_Box2d::ModelData_Box2d | ( | const ModelData_Point2dd & | theCorner1, |
const ModelData_Point2dd & | theCorner2 | ||
) |
Constructor.
Creates a box with specified corners.
void cadex::ModelData_Box2d::Add | ( | const ModelData_Point2d & | thePoint | ) |
Adjusts the box corners so that it contains thePoint.
Takes into account only finite coordinates of thePoint (those whose absolute value is less than \(10^{100}\)).
void cadex::ModelData_Box2d::Clear | ( | ) |
Resets the box.
Assigns infinite values to the coordinates, so that IsInfinite() returns true.
|
inline |
Enlarge the box dimensions by specified value.
Each box extent is shifted by \(\frac{1}{2}\cdot\mathrm{theSize}\) to the negative and positive side along respective axis.
|
inline |
Enlarge the box dimensions by specified values.
Each box extent is shifted by \(\frac{1}{2}\) of the specified shift value to the negative and positive side along respective axis.
|
inline |
Return the box with dimensions enlarged by specified value.
Each box extent of the result is shifted by \(\frac{1}{2}\cdot\mathrm{theSize}\) to the negative and positive side along respective axis compared to the original.
|
inline |
Return the box with dimensions enlarged by specified values.
Each box extent of the result is shifted by \(\frac{1}{2}\) of the specified shift value to the negative and positive side along respective axis compared to the original.
bool cadex::ModelData_Box2d::IsInfinite | ( | ) | const |
Returns true if at least one coordinate is infinite.
"Infinite" means that coordinate's absolute value is greater than \(10^{100}\).
|
inline |
Returns the MaxCorner property.
|
inline |
Returns the MaxCorner property.
|
inline |
Returns the MinCorner property.
|
inline |
Returns the MinCorner property.
void cadex::ModelData_Box2d::Multiply | ( | double | theValue | ) |
Scales box by scalar value.
Performs the scaling transformation of all the points of the box in the form:
\[ P'=\mathrm{theValue}\; P \]
where \(P\) and \(P'\) are the box points before and after transformation respectively and \(\mathrm{theValue}\) is the scale factor.
|
inline |
Sets one range of the box to the specified values.
Range axis | Index |
---|---|
X | 0 |
Y | 1 |
void cadex::ModelData_Box2d::Transform | ( | const ModelData_Transformation2d & | theTransformation | ) |
Transforms the box.
If the transformation does not contain anything besides perhaps a translation, the box dimensions are kept as is and its position is recalcuated accordingly.
If rotation or scale are present, all box corners are transformed and a new axis-aligned box containing them is built. If the box was infinite in one of the directions, the new box will also be infinite in the directions that are results of applying the transformation to the original directions. The new box most likely has larger dimensions than the original.
For more accurate results, it's recommended instead to transform the arguments the box was built from and only then calculate the box.