Salome HOME
Porting Salome to OCCT 7.7.0
[modules/shaper.git] / src / GeomAlgoAPI / GeomAlgoAPI_Prism.h
index a795e90e7b7f51553a67dcc32029d8e172be72ed..08f64d27cdf7c7f9572625694451e5daba91cf2d 100644 (file)
@@ -1,75 +1,86 @@
-// Copyright (C) 2014-20xx CEA/DEN, EDF R&D
-
-// File:        GeomAlgoAPI_Prism.h
-// Created:     5 May 2015
-// Author:      Dmitry Bobylev
+// Copyright (C) 2014-2022  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_Prism_H_
 #define GeomAlgoAPI_Prism_H_
 
-#include <GeomAlgoAPI.h>
+#include "GeomAlgoAPI_MakeSweep.h"
+
 #include <GeomAPI_Shape.h>
-#include <GeomAlgoAPI_MakeShape.h>
-#include <GeomAPI_DataMapOfShapeShape.h>
+
 #include <memory>
 
-/**\class GeomAlgoAPI_Prism
- * \ingroup DataAlgo
- * \brief Allows to create the prism based on a given face and bounding planes
- */
+class GeomAPI_Dir;
+class GeomAPI_Pln;
 
-class GeomAlgoAPI_Prism : public GeomAPI_Interface
+/// \class GeomAlgoAPI_Prism
+/// \ingroup DataAlgo
+/// \brief Allows to create the prism based on a given face and bounding planes.
+/// \n Note that only planar faces are allowed as bounding faces and resulting
+/// extrusion will be bounded by the infinite planes taken from the faces.
+class GeomAlgoAPI_Prism : public GeomAlgoAPI_MakeSweep
 {
 public:
-  /* \brief Creates extrusion for the given shape along the normal for this shape
-   * \param[in] theBasis face or wire to be extruded
-   * \param[in] theFromShape bottom bounding shape
-   * \param[in] theToShape top bounding shape
-   * \return a solid or a face/shell which is obtained from specified one
-   */
-  /// Constructor
-  GEOMALGOAPI_EXPORT GeomAlgoAPI_Prism(std::shared_ptr<GeomAPI_Shape> theBasis,
-                                       std::shared_ptr<GeomAPI_Shape> theFromShape,
-                                       std::shared_ptr<GeomAPI_Shape> theToShape);
-
-  /// Returns True if algorithm succeed
-  GEOMALGOAPI_EXPORT const bool isDone() const;
-
-  ///  Returns True if resulting shape is valid
-  GEOMALGOAPI_EXPORT const bool isValid() const;
+  /// \brief Creates extrusion for the given shape along the normal for this shape.
+  /// \param[in] theBaseShape planar face or wire to be extruded.
+  /// \param[in] theDirection direction of extrusion.
+  ///                         Can be empty if theBaseShape is planar wire or face.
+  /// \param[in] theToShape top bounding shape. Can be empty.
+  ///                       In this case offset will be applied to the basis.
+  /// \param[in] theToSize offset for "to" plane.
+  /// \param[in] theFromShape bottom bounding shape. Can be empty.
+  ///                         In this case offset will be applied to the basis.
+  /// \param[in] theFromSize offset for "from" plane.
+  GEOMALGOAPI_EXPORT GeomAlgoAPI_Prism(const GeomShapePtr                 theBaseShape,
+                                       const std::shared_ptr<GeomAPI_Dir> theDirection,
+                                       const GeomShapePtr                 theToShape,
+                                       const double                       theToSize,
+                                       const GeomShapePtr                 theFromShape,
+                                       const double                       theFromSize);
 
-  /// Returns True if resulting shape has volume
-  GEOMALGOAPI_EXPORT const bool hasVolume() const;
-
-  /// Returns result of the Prism algorithm which may be a Solid or a Face
-  GEOMALGOAPI_EXPORT const std::shared_ptr<GeomAPI_Shape>& shape() const;
-
-  /// Returns the first shape 
-  GEOMALGOAPI_EXPORT const std::shared_ptr<GeomAPI_Shape>& firstShape();
-
-  /// returns last shape
-  GEOMALGOAPI_EXPORT const std::shared_ptr<GeomAPI_Shape>& lastShape();
-  /// Returns map of sub-shapes of the result. To be used for History keeping
-  GEOMALGOAPI_EXPORT void  mapOfShapes(GeomAPI_DataMapOfShapeShape& theMap) const;
+private:
+  /// Build extrusion by distances from the base shape.
+  void buildBySizes(const GeomShapePtr                 theBaseShape,
+                    const std::shared_ptr<GeomAPI_Dir> theDirection,
+                    const double                       theToSize,
+                    const double                       theFromSize,
+                    const GeomAPI_Shape::ShapeType     theTypeToExp);
 
-  /// Return interface for for History processing
-  GEOMALGOAPI_EXPORT GeomAlgoAPI_MakeShape* makeShape() const;
+  /// Build extrusion from plane to plane.
+  void buildByPlanes(const GeomShapePtr                 theBaseShape,
+                     const std::shared_ptr<GeomAPI_Dir> theDirection,
+                     const std::shared_ptr<GeomAPI_Pln> theToPlane,
+                     const double                       theToSize,
+                     const std::shared_ptr<GeomAPI_Pln> theFromPlane,
+                     const double                       theFromSize,
+                     const GeomAPI_Shape::ShapeType     theTypeToExp);
 
-  /// Destructor
-  GEOMALGOAPI_EXPORT  ~GeomAlgoAPI_Prism();
-private:
-  /// builds resulting shape
-  void build(const std::shared_ptr<GeomAPI_Shape>& theBasis);
-  /// fields
-  std::shared_ptr<GeomAPI_Shape> myFromShape;
-  std::shared_ptr<GeomAPI_Shape> myToShape;
-  bool myDone;
-  std::shared_ptr<GeomAPI_Shape> myShape;
-  std::shared_ptr<GeomAPI_Shape> myFirst;
-  std::shared_ptr<GeomAPI_Shape> myLast;
-  GeomAPI_DataMapOfShapeShape myMap;
-  GeomAlgoAPI_MakeShape* myMkShape;
+  /// Build extrusion from face to face.
+  void buildByFaces(const GeomShapePtr                 theBaseShape,
+                    const std::shared_ptr<GeomAPI_Dir> theDirection,
+                    const GeomShapePtr                 theToShape,
+                    const double                       theToSize,
+                    const bool                         theToIsPlanar,
+                    const GeomShapePtr                 theFromShape,
+                    const double                       theFromSize,
+                    const bool                         theFromIsPlanar,
+                    const GeomAPI_Shape::ShapeType     theTypeToExp);
 };
 
 #endif