0026106: BRepMesh - revision of data model
[occt.git] / src / BRepMesh / BRepMesh_DefaultRangeSplitter.hxx
diff --git a/src/BRepMesh/BRepMesh_DefaultRangeSplitter.hxx b/src/BRepMesh/BRepMesh_DefaultRangeSplitter.hxx
new file mode 100644 (file)
index 0000000..db9229a
--- /dev/null
@@ -0,0 +1,150 @@
+// Created on: 2016-07-07
+// Copyright (c) 2016 OPEN CASCADE SAS
+// Created by: Oleg AGASHIN
+//
+// This file is part of Open CASCADE Technology software library.
+//
+// This library is free software; you can redistribute it and/or modify it under
+// the terms of the GNU Lesser General Public License version 2.1 as published
+// by the Free Software Foundation, with special exception defined in the file
+// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
+// distribution for complete text of the license and disclaimer of any warranty.
+//
+// Alternatively, this file may be used under the terms of Open CASCADE
+// commercial license or contractual agreement.
+
+#ifndef _BRepMesh_DefaultRangeSplitter_HeaderFile
+#define _BRepMesh_DefaultRangeSplitter_HeaderFile
+
+#include <Standard_Type.hxx>
+#include <gp_Pnt2d.hxx>
+#include <BRepAdaptor_HSurface.hxx>
+#include <IMeshData_Types.hxx>
+#include <IMeshData_Face.hxx>
+
+struct IMeshTools_Parameters;
+
+//! Default tool to define range of discrete face model and 
+//! obtain grid points distributed within this range.
+class BRepMesh_DefaultRangeSplitter
+{
+public:
+
+  //! Constructor.
+  BRepMesh_DefaultRangeSplitter()
+    : myIsValid (Standard_True)
+  {
+  }
+
+  //! Destructor.
+  virtual ~BRepMesh_DefaultRangeSplitter()
+  {
+  }
+
+  //! Resets this splitter. Must be called before first use.
+  Standard_EXPORT virtual void Reset(const IMeshData::IFaceHandle& theDFace,
+                                     const IMeshTools_Parameters& theParameters);
+
+  //! Registers border point.
+  Standard_EXPORT virtual void AddPoint(const gp_Pnt2d& thePoint);
+
+  //! Updates discrete range of surface according to its geometric range.
+  Standard_EXPORT virtual void AdjustRange();
+
+  //! Returns True if computed range is valid.
+  Standard_EXPORT virtual Standard_Boolean IsValid();
+
+  //! Scales the given point from real parametric space 
+  //! to face basis and otherwise.
+  //! @param thePoint point to be scaled.
+  //! @param isToFaceBasis if TRUE converts point to face basis,
+  //! otherwise performs reverse conversion.
+  //! @return scaled point.
+  Standard_EXPORT gp_Pnt2d Scale(const gp_Pnt2d&        thePoint,
+                                 const Standard_Boolean isToFaceBasis) const;
+
+  //! Returns list of nodes generated using surface data and specified parameters.
+  //! By default returns null ptr.
+  Standard_EXPORT virtual Handle(IMeshData::ListOfPnt2d) GenerateSurfaceNodes(
+    const IMeshTools_Parameters& theParameters) const;
+
+  //! Returns point in 3d space corresponded to the given 
+  //! point defined in parameteric space of surface.
+  inline gp_Pnt Point(const gp_Pnt2d& thePoint2d) const
+  {
+    return GetSurface()->Value(thePoint2d.X(), thePoint2d.Y());
+  }
+
+protected:
+
+  //! Computes parametric tolerance taking length along U and V into account.
+  virtual void computeTolerance(
+    const Standard_Real theLenU,
+    const Standard_Real theLenV);
+
+  //! Computes parametric delta taking length along U and V and value of tolerance into account.
+  virtual void computeDelta(
+    const Standard_Real theLengthU,
+    const Standard_Real theLengthV);
+
+public:
+  //! Returns face model.
+  inline const IMeshData::IFaceHandle& GetDFace() const
+  {
+    return myDFace;
+  }
+
+  //! Returns surface.
+  inline const Handle(BRepAdaptor_HSurface)& GetSurface() const
+  {
+    return myDFace->GetSurface();
+  }
+
+  //! Returns U range.
+  inline const std::pair<Standard_Real, Standard_Real>& GetRangeU() const
+  {
+    return myRangeU;
+  }
+
+  //! Returns V range.
+  inline const std::pair<Standard_Real, Standard_Real>& GetRangeV() const
+  {
+    return myRangeV;
+  }
+
+  //! Returns delta.
+  inline const std::pair<Standard_Real, Standard_Real>& GetDelta () const
+  {
+    return myDelta;
+  }
+
+  inline const std::pair<Standard_Real, Standard_Real>& GetToleranceUV() const
+  {
+    return myTolerance;
+  }
+
+private:
+
+  //! Computes length along U direction.
+  Standard_Real computeLengthU();
+
+  //! Computes length along V direction.
+  Standard_Real computeLengthV();
+
+  //! Updates discrete range of surface according to its geometric range.
+  void updateRange(const Standard_Real     theGeomFirst,
+                   const Standard_Real     theGeomLast,
+                   const Standard_Boolean  isPeriodic,
+                   Standard_Real&          theDiscreteFirst,
+                   Standard_Real&          theDiscreteLast);
+
+protected:
+  IMeshData::IFaceHandle                  myDFace;
+  std::pair<Standard_Real, Standard_Real> myRangeU;
+  std::pair<Standard_Real, Standard_Real> myRangeV;
+  std::pair<Standard_Real, Standard_Real> myDelta;
+  std::pair<Standard_Real, Standard_Real> myTolerance;
+  Standard_Boolean                        myIsValid;
+};
+
+#endif
\ No newline at end of file