BoundingBox.h

#pragma once
 
#include <Foundation/Math/Vec3.h>
 
 
template <typename Type>
class plBoundingBoxTemplate
{
public:
  // Means this object can be copied using memcpy instead of copy construction.
  PL_DECLARE_POD_TYPE();
 
  using ComponentType = Type;
 
public:
  plBoundingBoxTemplate();
 
  plBoundingBoxTemplate(const plVec3Template<Type>& vMin, const plVec3Template<Type>& vMax); // [tested]
 
#if PL_ENABLED(PL_MATH_CHECK_FOR_NAN)
  void AssertNotNaN() const
  {
    PL_ASSERT_ALWAYS(!IsNaN(), "This object contains NaN values. This can happen when you forgot to initialize it before using it. Please check that "
                               "all code-paths properly initialize this object.");
  }
#endif
 
  [[nodiscard]] static plBoundingBoxTemplate<Type> MakeZero();
 
  [[nodiscard]] static plBoundingBoxTemplate<Type> MakeInvalid(); // [tested]
 
  [[nodiscard]] static plBoundingBoxTemplate<Type> MakeFromCenterAndHalfExtents(const plVec3Template<Type>& vCenter, const plVec3Template<Type>& vHalfExtents); // [tested]
 
  [[nodiscard]] static plBoundingBoxTemplate<Type> MakeFromMinMax(const plVec3Template<Type>& vMin, const plVec3Template<Type>& vMax); // [tested]
 
  [[nodiscard]] static plBoundingBoxTemplate<Type> MakeFromPoints(const plVec3Template<Type>* pPoints, plUInt32 uiNumPoints, plUInt32 uiStride = sizeof(plVec3Template<Type>)); // [tested]
 
  bool IsValid() const; // [tested]
 
  bool IsNaN() const; // [tested]
 
  void GetCorners(plVec3Template<Type>* out_pCorners) const; // [tested]
 
  const plVec3Template<Type> GetCenter() const; // [tested]
 
  const plVec3Template<Type> GetExtents() const; // [tested]
 
  const plVec3Template<Type> GetHalfExtents() const; // [tested]
 
  void ExpandToInclude(const plVec3Template<Type>& vPoint); // [tested]
 
  void ExpandToInclude(const plBoundingBoxTemplate& rhs); // [tested]
 
  void ExpandToInclude(const plVec3Template<Type>* pPoints, plUInt32 uiNumPoints, plUInt32 uiStride = sizeof(plVec3Template<Type>)); // [tested]
 
  void ExpandToCube(); // [tested]
 
  void Grow(const plVec3Template<Type>& vDiff); // [tested]
 
  bool Contains(const plVec3Template<Type>& vPoint) const; // [tested]
 
  bool Contains(const plBoundingBoxTemplate& rhs) const; // [tested]
 
  bool Contains(const plVec3Template<Type>* pPoints, plUInt32 uiNumPoints, plUInt32 uiStride = sizeof(plVec3Template<Type>)) const; // [tested]
 
  bool Contains(const plBoundingSphereTemplate<Type>& sphere) const; // [tested]
 
  bool Overlaps(const plBoundingBoxTemplate& rhs) const; // [tested]
 
  bool Overlaps(const plVec3Template<Type>* pPoints, plUInt32 uiNumPoints, plUInt32 uiStride = sizeof(plVec3Template<Type>)) const; // [tested]
 
  bool Overlaps(const plBoundingSphereTemplate<Type>& sphere) const; // [tested]
 
  bool IsIdentical(const plBoundingBoxTemplate& rhs) const; // [tested]
 
  bool IsEqual(const plBoundingBoxTemplate& rhs, Type fEpsilon = plMath::DefaultEpsilon<Type>()) const; // [tested]
 
  void Translate(const plVec3Template<Type>& vDiff); // [tested]
 
  void ScaleFromCenter(const plVec3Template<Type>& vScale); // [tested]
 
  void ScaleFromOrigin(const plVec3Template<Type>& vScale); // [tested]
 
  void TransformFromCenter(const plMat4Template<Type>& mTransform); // [tested]
 
  void TransformFromOrigin(const plMat4Template<Type>& mTransform); // [tested]
 
  const plVec3Template<Type> GetClampedPoint(const plVec3Template<Type>& vPoint) const; // [tested]
 
  Type GetDistanceSquaredTo(const plVec3Template<Type>& vPoint) const; // [tested]
 
  Type GetDistanceSquaredTo(const plBoundingBoxTemplate& rhs) const; // [tested]
 
  Type GetDistanceTo(const plVec3Template<Type>& vPoint) const; // [tested]
 
  Type GetDistanceTo(const plBoundingSphereTemplate<Type>& sphere) const; // [tested]
 
  Type GetDistanceTo(const plBoundingBoxTemplate& rhs) const; // [tested]
 
  bool GetRayIntersection(const plVec3Template<Type>& vStartPos, const plVec3Template<Type>& vRayDir, Type* out_pIntersectionDistance = nullptr,
    plVec3Template<Type>* out_pIntersection = nullptr) const; // [tested]
 
  bool GetLineSegmentIntersection(const plVec3Template<Type>& vStartPos, const plVec3Template<Type>& vEndPos, Type* out_pLineFraction = nullptr,
    plVec3Template<Type>* out_pIntersection = nullptr) const; // [tested]
 
  const plBoundingSphereTemplate<Type> GetBoundingSphere() const; // [tested]
 
 
public:
  plVec3Template<Type> m_vMin;
  plVec3Template<Type> m_vMax;
};
 
template <typename Type>
bool operator==(const plBoundingBoxTemplate<Type>& lhs, const plBoundingBoxTemplate<Type>& rhs); // [tested]
 
template <typename Type>
bool operator!=(const plBoundingBoxTemplate<Type>& lhs, const plBoundingBoxTemplate<Type>& rhs); // [tested]
 
 
#include <Foundation/Math/Implementation/BoundingBox_inl.h>