liboce-foundation-dev 0.17.1-1 / usr / include / oce / Bnd_Box2d.hxx

// This file is generated by WOK (CPPExt).
// Please do not edit this file; modify original file instead.
// The copyright and license terms as defined for the original file apply to 
// this header file considered to be the "object code" form of the original source.

#ifndef _Bnd_Box2d_HeaderFile
#define _Bnd_Box2d_HeaderFile

#include <Standard.hxx>
#include <Standard_DefineAlloc.hxx>
#include <Standard_Macro.hxx>

#include <Standard_Real.hxx>
#include <Standard_Integer.hxx>
#include <Standard_Boolean.hxx>
class Standard_ConstructionError;
class gp_Pnt2d;
class gp_Dir2d;
class gp_Trsf2d;


//! Describes a bounding box in 2D space.
//! A bounding box is parallel to the axes of the coordinates
//! system. If it is finite, it is defined by the two intervals:
//! -   [ Xmin,Xmax ], and
//! -   [ Ymin,Ymax ].
//! A bounding box may be infinite (i.e. open) in one or more
//! directions. It is said to be:
//! -   OpenXmin if it is infinite on the negative side of the   "X Direction";
//! -   OpenXmax if it is infinite on the positive side of the   "X Direction";
//! -   OpenYmin if it is infinite on the negative side of the   "Y Direction";
//! -   OpenYmax if it is infinite on the positive side of the   "Y Direction";
//! -   WholeSpace if it is infinite in all four directions. In
//! this case, any point of the space is inside the box;
//! -   Void if it is empty. In this case, there is no point included in the box.
//! A bounding box is defined by four bounds (Xmin, Xmax, Ymin and Ymax) which
//! limit the bounding box if it is finite, six flags (OpenXmin, OpenXmax, OpenYmin,
//! OpenYmax, WholeSpace and Void) which describe the bounding box if it is infinite or empty, and
//! -   a gap, which is included on both sides in any direction when consulting the finite bounds of the box.
class Bnd_Box2d 
{
public:

  DEFINE_STANDARD_ALLOC

  
  //! Creates an empty 2D bounding box.
  //! The constructed box is qualified Void. Its gap is null.
    Bnd_Box2d();
  
  //! Sets this bounding box so that it covers the whole 2D
  //! space, i.e. it is infinite in all directions.
      void SetWhole() ;
  
  //! Sets this 2D bounding box so that it is empty. All points are outside a void box.
      void SetVoid() ;
  
  //! Sets this 2D bounding box so that it bounds
  //! the point P. This involves first setting this bounding box
  //! to be void and then adding the point PThe rectangle bounds   the  point <P>.
      void Set (const gp_Pnt2d& P) ;
  
  //! Sets this 2D bounding box so that it bounds
  //! the half-line defined by point P and direction D, i.e. all
  //! points M defined by M=P+u*D, where u is greater than
  //! or equal to 0, are inside the bounding area. This involves
  //! first setting this 2D box to be void and then adding the   half-line.
      void Set (const gp_Pnt2d& P, const gp_Dir2d& D) ;
  
  //! Enlarges this 2D bounding box, if required, so that it
  //! contains at least:
  //! -   interval [ aXmin,aXmax ] in the "X Direction",
  //! -   interval [ aYmin,aYmax ] in the "Y Direction"
  Standard_EXPORT   void Update (const Standard_Real aXmin, const Standard_Real aYmin, const Standard_Real aXmax, const Standard_Real aYmax) ;
  
  //! Adds a point of coordinates (X,Y) to this bounding box.
  Standard_EXPORT   void Update (const Standard_Real X, const Standard_Real Y) ;
  
  //! Returns the gap of this 2D bounding box.
      Standard_Real GetGap()  const;
  
  //! Set the gap of this 2D bounding box to abs(Tol).
      void SetGap (const Standard_Real Tol) ;
  
  //! Enlarges     the  box  with    a  tolerance  value.
  //! This means that the minimum values of its X and Y
  //! intervals of definition, when they are finite, are reduced by
  //! the absolute value of Tol, while the maximum values are
  //! increased by the same amount.
      void Enlarge (const Standard_Real Tol) ;
  
  //! Returns the bounds of this 2D bounding box.
  //! The gap is included. If this bounding box is infinite (i.e. "open"), returned values
  //! may be equal to +/- Precision::Infinite().
  //! if IsVoid()
  Standard_EXPORT   void Get (Standard_Real& aXmin, Standard_Real& aYmin, Standard_Real& aXmax, Standard_Real& aYmax)  const;
  
  //! The Box will be infinitely long in the Xmin direction.
      void OpenXmin() ;
  
  //! The Box will be infinitely long in the Xmax direction.
      void OpenXmax() ;
  
  //! The Box will be infinitely long in the Ymin direction.
      void OpenYmin() ;
  
  //! The Box will be infinitely long in the Ymax direction.
      void OpenYmax() ;
  
  //! Returns true if this bounding box is open in the Xmin direction.
      Standard_Boolean IsOpenXmin()  const;
  
  //! Returns true if this bounding box is open in the Xmax direction.
      Standard_Boolean IsOpenXmax()  const;
  
  //! Returns true if this bounding box is open in the Ymin direction.
      Standard_Boolean IsOpenYmin()  const;
  
  //! Returns true if this bounding box is open in the Ymax direction.
      Standard_Boolean IsOpenYmax()  const;
  

  //! Returns true if this bounding box is infinite in all 4
  //! directions (Whole Space flag).
      Standard_Boolean IsWhole()  const;
  

  //! Returns true if this 2D bounding box is empty (Void flag).
      Standard_Boolean IsVoid()  const;
  
  //! Returns a bounding box which is the result of applying the
  //! transformation T to this bounding box.
  //! Warning
  //! Applying a geometric transformation (for example, a
  //! rotation) to a bounding box generally increases its
  //! dimensions. This is not optimal for algorithms which use it.
  Standard_EXPORT   Bnd_Box2d Transformed (const gp_Trsf2d& T)  const;
  
  //! Adds the 2d box <Other> to <me>.
  Standard_EXPORT   void Add (const Bnd_Box2d& Other) ;
  
  //! Adds  the 2d pnt <P> to <me>.
      void Add (const gp_Pnt2d& P) ;
  
  //! Extends <me> from the Pnt <P> in the direction <D>.
      void Add (const gp_Pnt2d& P, const gp_Dir2d& D) ;
  
  //! Extends the Box  in the given Direction, i.e. adds
  //! a half-line. The box may become infinite in 1 or 2
  //! directions.
  Standard_EXPORT   void Add (const gp_Dir2d& D) ;
  
  //! Returns True if the 2d pnt <P> is out <me>.
  Standard_EXPORT   Standard_Boolean IsOut (const gp_Pnt2d& P)  const;
  
  //! Returns True if <Box2d> is out <me>.
  Standard_EXPORT   Standard_Boolean IsOut (const Bnd_Box2d& Other)  const;
  
  //! Returns True if transformed <Box2d> is out <me>.
      Standard_Boolean IsOut (const Bnd_Box2d& Other, const gp_Trsf2d& T)  const;
  
  //! Compares  a transformed  bounding with  a    transformed
  //! bounding. The default implementation is  to make a copy
  //! of <me> and <Other>, to transform them and to test.
      Standard_Boolean IsOut (const gp_Trsf2d& T1, const Bnd_Box2d& Other, const gp_Trsf2d& T2)  const;
  
  Standard_EXPORT   void Dump()  const;
  
  //! Computes the squared diagonal of me.
      Standard_Real SquareExtent()  const;




protected:





private:



  Standard_Real Xmin;
  Standard_Real Xmax;
  Standard_Real Ymin;
  Standard_Real Ymax;
  Standard_Real Gap;
  Standard_Integer Flags;


};


#include <Bnd_Box2d.lxx>





#endif // _Bnd_Box2d_HeaderFile