Issue #2068: change of arc is by jump even due to smooth mouse movement

[modules/shaper.git] / src / GeomAlgoAPI / GeomAlgoAPI_Circ2dBuilder.h

diff --git a/src/GeomAlgoAPI/GeomAlgoAPI_Circ2dBuilder.h b/src/GeomAlgoAPI/GeomAlgoAPI_Circ2dBuilder.h
new file mode 100644 (file)
index 0000000..6aad612
--- /dev/null
+++ b/src/GeomAlgoAPI/GeomAlgoAPI_Circ2dBuilder.h
@@ -0,0 +1,76 @@
+// Copyright (C) 2017-20xx CEA/DEN, EDF R&D
+
+// File:        GeomAlgoAPI_Circ2dBuilder.h
+// Created:     3 April 2017
+// Author:      Artem ZHIDKOV
+
+#ifndef GeomAlgoAPI_Circ2dBuilder_H_
+#define GeomAlgoAPI_Circ2dBuilder_H_
+
+#include <GeomAlgoAPI.h>
+
+#include <memory>
+#include <vector>
+
+class GeomAPI_Ax3;
+class GeomAPI_Circ2d;
+class GeomAPI_Pnt2d;
+class GeomAPI_Shape;
+
+/// \class GeomAlgoAPI_Circ2dBuilder
+/// \ingroup DataAlgo
+/// \brief Creates circle in 2D space satisfying combination of the following constraints:
+///        * center of a circle
+///        * passing through the point
+///        * tangent to a curve
+///        * fixed radius
+class GeomAlgoAPI_Circ2dBuilder
+{
+public:
+  /// \brief Create a builder object.
+  ///        Constraints should be applied separately.
+  /// \param thePlane [in]  plane to project tangent curves
+  GEOMALGOAPI_EXPORT
+  GeomAlgoAPI_Circ2dBuilder(const std::shared_ptr<GeomAPI_Ax3>& thePlane);
+
+  /// \brief Set fixed radius of the circle
+  GEOMALGOAPI_EXPORT
+  void setRadius(const double theRadius);
+
+  /// \brief Set fixed center of the circle
+  GEOMALGOAPI_EXPORT
+  void setCenter(const std::shared_ptr<GeomAPI_Pnt2d>& theCenter);
+
+  /// \brief Constrain circle to be tangent to the given edge
+  GEOMALGOAPI_EXPORT
+  void addTangentCurve(const std::shared_ptr<GeomAPI_Shape>& theEdge);
+
+  /// \brief Constrain circle to pass through the given point
+  GEOMALGOAPI_EXPORT
+  void addPassingPoint(const std::shared_ptr<GeomAPI_Pnt2d>& thePoint);
+
+  /// \brief Optional constraint to find circle closest to the given point
+  GEOMALGOAPI_EXPORT
+  void setClosestPoint(const std::shared_ptr<GeomAPI_Pnt2d>& thePoint);
+
+  /// \brief Build circle
+  GEOMALGOAPI_EXPORT
+  std::shared_ptr<GeomAPI_Circ2d> circle();
+
+  /// \brief Create a circle passing through three points
+  GEOMALGOAPI_EXPORT
+  static std::shared_ptr<GeomAPI_Circ2d>
+      circle(const std::shared_ptr<GeomAPI_Pnt2d>& theFirstPoint,
+             const std::shared_ptr<GeomAPI_Pnt2d>& theSecondPoint,
+             const std::shared_ptr<GeomAPI_Pnt2d>& theThirdPoint);
+
+private:
+  std::shared_ptr<GeomAPI_Ax3>                  myPlane;
+  std::shared_ptr<GeomAPI_Pnt2d>                myCenter;
+  std::vector< std::shared_ptr<GeomAPI_Pnt2d> > myPassingPoints;
+  std::vector< std::shared_ptr<GeomAPI_Shape> > myTangentShapes;
+  std::shared_ptr<GeomAPI_Pnt2d>                myClosestPoint;
+  double                                        myRadius;
+};
+
+#endif