extent.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2025 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
/*******************************************************************************
** $RCSfile: tdbextent.h,v $ $Revision: 1.17 $ $State: Exp $
*******************************************************************************/
#ifndef extent_H_
#define extent_H_


#include "geometry/geometryDefines.h"
#include "geometry/point.h"
#ifndef NO_VRLINK
#include <matrix/vlVector.h>
#endif
#include <iosfwd>
class DtChord;
class DtSphere;


class DT_DLL_geometry DtExtent
{
public:

   DtExtent();

   DtExtent(const DtExtent& orig);


   DtExtent(const double minX, const double maxX,
            const double minY, const double maxY,
            const double minZ, const double maxZ );

   DtExtent(const DtPoint& p0, const DtPoint& p1);

   DtExtent(const DtChord& lineSeg);

   virtual ~DtExtent();

   DtExtent& operator=(const DtExtent& orig);

   virtual bool operator==(const DtExtent& rhs) const;
   virtual bool operator!=(const DtExtent& rhs) const;

//- -------------- access/manipulate size/shape routines -----------------

   double minX() const;
   double minY() const;
   double minZ() const;
   double maxX() const;
   double maxY() const;
   double maxZ() const;

   void setMinX(double x);
   void setMinY(double y);
   void setMinZ(double z);
   void setMaxX(double x);
   void setMaxY(double y);
   void setMaxZ(double z);

   virtual const DtPoint center() const;

   virtual void setCenter(const DtPoint& p);

   virtual void setFromCenter(const DtPoint& p,
                              const double& xDist, 
                              const double& yDist, 
                              const double& zDist);


   double xSize() const;
   double ySize() const;
   double zSize() const;

   virtual DtPoint maxPoint() const;

   virtual DtPoint minPoint() const;

   bool empty() const;

   virtual void expandToInclude(const DtExtent& otherExtent);

   virtual void expandToInclude(const DtPoint& point);
   
   //- --------------- intersection tests ---------------------------   
   //- ---  could be potentially moved to an DtExtentIntersector class ---

   virtual bool contains(const DtExtent& otherExtent) const;

   virtual bool contains(const DtPoint& point) const;

   virtual bool contains(const DtChord& chord) const;
   
   bool intersects(const DtExtent& otherExtent) const;

   bool doesNotIntersect(const DtExtent& otherExtent) const;

   bool intersects(const DtSphere& sphere) const;

protected:

   bool intersectsLineOfChord(const DtChord& chord, 
      double& distInChordLengthsFirst, double& distInChordLengthsLast) const;

   bool intersectsSoFar(const double pointVal,
      const double rayVal, const double side0, const double side1, 
      double &firstTime, double &lastTime) const;

//- --------------- end intersection tests ---------------------------   

protected:
   void guaranteeValidConstruction();

protected:
   double myMinX;
   double myMaxX;
   double myMinY;
   double myMaxY;
   double myMinZ;
   double myMaxZ;

public:

   static DtExtent& nullExtent();

};

#define tdbextent_inl
#include "geometry/extent.inl"
#undef tdbextent_inl

DT_DLL_geometry std::ostream& operator<<(std::ostream& os, const DtExtent& extent);
DT_DLL_geometry std::istream& operator>>(std::istream& is, DtExtent& extent);

#endif