X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FGeomAlgoAPI%2FGeomAlgoAPI_PointBuilder.h;h=fe2a56e1e2c5df350493c4900a9588325d3f8a08;hb=97917d3698f5a2f7fc9596e7c755ff8f6751e373;hp=64e479ce1cfbb300b3e16b840b43eadbaae788ba;hpb=f1cd93fd02a54259f72e3191d037323a496b2bef;p=modules%2Fshaper.git diff --git a/src/GeomAlgoAPI/GeomAlgoAPI_PointBuilder.h b/src/GeomAlgoAPI/GeomAlgoAPI_PointBuilder.h index 64e479ce1..fe2a56e1e 100644 --- a/src/GeomAlgoAPI/GeomAlgoAPI_PointBuilder.h +++ b/src/GeomAlgoAPI/GeomAlgoAPI_PointBuilder.h @@ -1,8 +1,21 @@ -// Copyright (C) 2014-20xx CEA/DEN, EDF R&D - -// File: GeomAlgoAPI_PointBuilder.h -// Created: 02 Jun 2014 -// Author: Mikhail PONIKAROV +// Copyright (C) 2014-2019 CEA/DEN, EDF R&D +// +// This library is free software; you can redistribute it and/or +// modify it under the terms of the GNU Lesser General Public +// License as published by the Free Software Foundation; either +// version 2.1 of the License, or (at your option) any later version. +// +// This library is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +// Lesser General Public License for more details. +// +// You should have received a copy of the GNU Lesser General Public +// License along with this library; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA +// +// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com +// #ifndef GeomAlgoAPI_PointBuilder_H_ #define GeomAlgoAPI_PointBuilder_H_ @@ -10,19 +23,64 @@ #include #include -class GeomAPI_Shape; +class GeomAPI_Edge; +class GeomAPI_Face; class GeomAPI_Pnt; +class GeomAPI_Shape; +class GeomAPI_Vertex; -/**\class GeomAlgoAPI_PointBuilder - * \ingroup DataAlgo - * \brief Allows to create face-shapes by different parameters - */ - +/// \class GeomAlgoAPI_PointBuilder +/// \ingroup DataAlgo +/// \brief Allows to create vertex-shapes by different parameters class GEOMALGOAPI_EXPORT GeomAlgoAPI_PointBuilder { - public: - /// Creates linear edge by two points - static std::shared_ptr point(std::shared_ptr thePoint); +public: + /// Creates a vertex by point + static std::shared_ptr vertex(const std::shared_ptr thePoint); + + /// Creates a vertex by point coordinates + static std::shared_ptr vertex(const double theX, + const double theY, + const double theZ); + + /// \brief Creates vertex by edge and distance on it. + /// \param[in] theEdge edge. + /// \param[in] theValue distance value. + /// \param[in] theIsPercent if true theValue will be treated + /// as a percentage of theEdge total length. + /// \param[in] theIsReverse if true the distance will be measured from the edge end point. + /// \return created vertex. + static std::shared_ptr vertexOnEdge(const std::shared_ptr theEdge, + const double theValue, + const bool theIsPercent = false, + const bool theIsReverse = false); + + /// \brief Creates vertex by projection another vertex on edge. + /// \param[in] theVertex vertex to project. + /// \param[in] theEdge edge for projection. + /// \return created vertex. + static std::shared_ptr + vertexByProjection(const std::shared_ptr theVertex, + const std::shared_ptr theEdge); + + /// \brief Creates vertex by projection another vertex on plane. + /// \param[in] theVertex vertex to project. + /// \param[in] theFace face for projection. Should be planar. + /// \return created vertex. + static std::shared_ptr + vertexByProjection(const std::shared_ptr theVertex, + const std::shared_ptr theFace); + + /// \brief Creates vertex by intersection two coplanar lines. + /// \param[in] theEdge1 first linear edge. + /// \param[in] theEdge2 second linear edge. + /// \return created vertex. + static std::shared_ptr + vertexByIntersection(const std::shared_ptr theEdge1, + const std::shared_ptr theEdge2); + + /// Return point by shape vertex + static std::shared_ptr point(const std::shared_ptr theVertex); }; #endif