1 // Copyright (C) 2017-2019 CEA/DEN, EDF R&D
3 // This library is free software; you can redistribute it and/or
4 // modify it under the terms of the GNU Lesser General Public
5 // License as published by the Free Software Foundation; either
6 // version 2.1 of the License, or (at your option) any later version.
8 // This library is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 // Lesser General Public License for more details.
13 // You should have received a copy of the GNU Lesser General Public
14 // License along with this library; if not, write to the Free Software
15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
20 // File: GeomAPI_Ellipse2d.h
21 // Created: 26 April 2017
22 // Author: Artem ZHIDKOV
24 #ifndef GeomAPI_Ellipse2d_H_
25 #define GeomAPI_Ellipse2d_H_
27 #include <GeomAPI_Interface.h>
34 /**\class GeomAPI_Ellipse2d
36 * \brief Ellipse in 2D
38 class GeomAPI_Ellipse2d : public GeomAPI_Interface
41 /// \brief Constructs ellipse by center, X-axis and given radii
42 GEOMAPI_EXPORT GeomAPI_Ellipse2d(const std::shared_ptr<GeomAPI_Pnt2d>& theCenter,
43 const std::shared_ptr<GeomAPI_Dir2d>& theXAxis,
44 const double theMajorRadius,
45 const double theMinorRadius);
47 /// \brief Constructs ellipse by center and two points lying on the ellipse:
48 /// first of them defines an axis of the ellipse
49 /// and another is just placed on the ellipse.
50 GEOMAPI_EXPORT GeomAPI_Ellipse2d(const std::shared_ptr<GeomAPI_Pnt2d>& theCenter,
51 const std::shared_ptr<GeomAPI_Pnt2d>& theAxisPoint,
52 const std::shared_ptr<GeomAPI_Pnt2d>& thePassingPoint);
54 /// Returns center of the ellipse
55 GEOMAPI_EXPORT std::shared_ptr<GeomAPI_Pnt2d> center() const;
57 /// Returns first focus of the ellipse
58 GEOMAPI_EXPORT std::shared_ptr<GeomAPI_Pnt2d> firstFocus() const;
60 /// Returns second focus of the ellipse
61 GEOMAPI_EXPORT std::shared_ptr<GeomAPI_Pnt2d> secondFocus() const;
63 /// Returns minor radius of the ellipse
64 GEOMAPI_EXPORT double minorRadius() const;
66 /// Returns major radius of the ellipse
67 GEOMAPI_EXPORT double majorRadius() const;
69 /// Calculate minimal distance between the ellipse and a line.
70 /// Return corresponding points on the ellipse and on the line.
71 GEOMAPI_EXPORT double distance(const std::shared_ptr<GeomAPI_Lin2d>& theLine,
72 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnMe,
73 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnLine);
75 /// Calculate minimal distance between the ellipse and a circle.
76 /// Return corresponding points on the ellipse and on the circle.
77 GEOMAPI_EXPORT double distance(const std::shared_ptr<GeomAPI_Circ2d>& theCircle,
78 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnMe,
79 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnCircle);
81 /// Calculate minimal distance between two ellipses.
82 /// Return corresponding points on the ellipses.
83 GEOMAPI_EXPORT double distance(const std::shared_ptr<GeomAPI_Ellipse2d>& theEllipse,
84 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnMe,
85 std::shared_ptr<GeomAPI_Pnt2d>& thePointOnEllipse);