src/GeomAlgoAPI/GeomAlgoAPI_Placement.h

   1 // Copyright (C) 2014-2017  CEA/DEN, EDF R&D
   2 //
   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.
   7 //
   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.
  12 //
  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
  16 //
  17 // See http://www.salome-platform.org/ or
  18 // email : webmaster.salome@opencascade.com<mailto:webmaster.salome@opencascade.com>
  19 //
  20
  21 #ifndef GeomAlgoAPI_Placement_H_
  22 #define GeomAlgoAPI_Placement_H_
  23
  24 #include <GeomAlgoAPI.h>
  25 #include <GeomAlgoAPI_MakeShape.h>
  26
  27 #include <GeomAPI_Shape.h>
  28 #include <GeomAPI_Trsf.h>
  29
  30 /// \class GeomAlgoAPI_Placement
  31 /// \ingroup DataAlgo
  32 /// \brief Creates the copied object which sub-element is placed on the given element
  33 class GeomAlgoAPI_Placement : public GeomAlgoAPI_MakeShape
  34 {
  35 public:
  36   /// \brief Creates an object which is obtained from current object by transformation calculated
  37   ///        as a movement of the source object to be coincident with the destination object
  38   /// \param[in] theSourceSolid  a shape to be moved
  39   /// \param[in] theDestSolid    invariant shape
  40   /// \param[in] theSourceShape  a shape on the solid to be made coincident with destination object
  41   /// \param[in] theDestShape    destination object
  42   /// \param[in] theIsReverse    indicates that the solid materials should be on the same side
  43   ///                            against the destination plane
  44   /// \param[in] theIsCentering  indicates the planes should be centered
  45   /// \param[in] theSimpleTransform makes just transformation of shape
  46   ///                               without changing of topology or geometry
  47   GEOMALGOAPI_EXPORT GeomAlgoAPI_Placement(const std::shared_ptr<GeomAPI_Shape> theSourceSolid,
  48                                            const std::shared_ptr<GeomAPI_Shape> theDestSolid,
  49                                            const std::shared_ptr<GeomAPI_Shape> theSourceShape,
  50                                            const std::shared_ptr<GeomAPI_Shape> theDestShape,
  51                                            const bool theIsReverse = false,
  52                                            const bool theIsCentering = false,
  53                                            const bool theSimpleTransform = false);
  54
  55   /// Returns the simple transformation
  56   GEOMALGOAPI_EXPORT std::shared_ptr<GeomAPI_Trsf> transformation() const;
  57
  58 private:
  59   /// builds resulting shape
  60   void build(const std::shared_ptr<GeomAPI_Shape>& theSourceSolid,
  61              const std::shared_ptr<GeomAPI_Shape>& theDestSolid,
  62              const std::shared_ptr<GeomAPI_Shape>& theSourceShape,
  63              const std::shared_ptr<GeomAPI_Shape>& theDestShape,
  64              const bool theIsReverse,
  65              const bool theIsCentering,
  66              const bool theSimpleTransform);
  67
  68 private:
  69   std::shared_ptr<GeomAPI_Trsf> myTrsf; ///< transformation of the shape in case theSimpleTransform
  70 };
  71
  72 #endif