include/opencascade/GeomBndLib_Torus.hxx

0001 // Copyright (c) 2025 OPEN CASCADE SAS
0002 //
0003 // This file is part of Open CASCADE Technology software library.
0004 //
0005 // This library is free software; you can redistribute it and/or modify it under
0006 // the terms of the GNU Lesser General Public License version 2.1 as published
0007 // by the Free Software Foundation, with special exception defined in the file
0008 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
0009 // distribution for complete text of the license and disclaimer of any warranty.
0010 //
0011 // Alternatively, this file may be used under the terms of Open CASCADE
0012 // commercial license or contractual agreement.
0013
0014 #ifndef GeomBndLib_Torus_HeaderFile
0015 #define GeomBndLib_Torus_HeaderFile
0016
0017 #include <Bnd_Box.hxx>
0018 #include <Geom_ToroidalSurface.hxx>
0019 #include <Standard.hxx>
0020 #include <Standard_DefineAlloc.hxx>
0021
0022 //! Computes bounding box for a toroidal surface (Geom_ToroidalSurface).
0023 //! Uses 8-point polygon approximation via GeomBndLib_ConicHelpers and
0024 //! extremal-point computation for degenerate torus (Ra < Ri).
0025 class GeomBndLib_Torus
0026 {
0027 public:
0028   DEFINE_STANDARD_ALLOC
0029
0030   GeomBndLib_Torus(const occ::handle<Geom_ToroidalSurface>& theSurf)
0031       : myGeom(theSurf)
0032   {
0033   }
0034
0035   GeomBndLib_Torus(const GeomBndLib_Torus&)            = delete;
0036   GeomBndLib_Torus& operator=(const GeomBndLib_Torus&) = delete;
0037   GeomBndLib_Torus(GeomBndLib_Torus&&)                 = delete;
0038   GeomBndLib_Torus& operator=(GeomBndLib_Torus&&)      = delete;
0039
0040   const occ::handle<Geom_ToroidalSurface>& Geometry() const { return myGeom; }
0041
0042   //! Compute bounding box for full torus.
0043   [[nodiscard]] Standard_EXPORT Bnd_Box Box(double theTol) const;
0044
0045   //! Compute bounding box for torus patch [theUMin, theUMax] x [theVMin, theVMax].
0046   [[nodiscard]] Standard_EXPORT Bnd_Box
0047     Box(double theUMin, double theUMax, double theVMin, double theVMax, double theTol) const;
0048
0049   //! Compute precise bounding box for torus patch using PSO + Powell optimization.
0050   [[nodiscard]] Standard_EXPORT Bnd_Box
0051     BoxOptimal(double theUMin, double theUMax, double theVMin, double theVMax, double theTol) const;
0052
0053   //! Compute precise bounding box for full torus.
0054   [[nodiscard]] Standard_EXPORT Bnd_Box BoxOptimal(double theTol) const;
0055
0056 private:
0057   occ::handle<Geom_ToroidalSurface> myGeom;
0058 };
0059
0060 #endif // GeomBndLib_Torus_HeaderFile