X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FGeomAlgoAPI%2FGeomAlgoAPI_ShapeTools.h;h=d361eb927b34cd9aaefcd4b38fb4b1ef044f9813;hb=4d6bb9de0e54f09a9bbacc94a058cb7cd437d535;hp=fa792b2d66f0d79b3ab80e21c42b153e05f51ed2;hpb=42dfdea5422ab72d81c36155b4c6f352c85c1110;p=modules%2Fshaper.git

diff --git a/src/GeomAlgoAPI/GeomAlgoAPI_ShapeTools.h b/src/GeomAlgoAPI/GeomAlgoAPI_ShapeTools.h
index fa792b2d6..d361eb927 100644
--- a/src/GeomAlgoAPI/GeomAlgoAPI_ShapeTools.h
+++ b/src/GeomAlgoAPI/GeomAlgoAPI_ShapeTools.h
@@ -15,33 +15,49 @@
 
 /** \class GeomAlgoAPI_ShapeTools
  *  \ingroup DataAlgo
- *  \brief
+ *  \brief Useful tools for working with shapes.
  */
 class GEOMALGOAPI_EXPORT GeomAlgoAPI_ShapeTools
 {
 public:
   /// \return the total volume of the solids of the current shape or 0.0 if it can be computed.
-  static double volume(std::shared_ptr<GeomAPI_Shape> theShape);
+  static double volume(const std::shared_ptr<GeomAPI_Shape> theShape);
 
   /// \return the centre of mass of the current face. The coordinates returned for the center of mass
   /// are expressed in the absolute Cartesian coordinate system. (This function works only for surfaces).
-  static std::shared_ptr<GeomAPI_Pnt> centreOfMass(std::shared_ptr<GeomAPI_Shape> theShape);
+  static std::shared_ptr<GeomAPI_Pnt> centreOfMass(const std::shared_ptr<GeomAPI_Shape> theShape);
 
   /** \brief Combines faces with common edges to shells, or solids to compsolids.
    *  \param[in] theCompound compound of shapes.
    *  \param[in] theType type of combine.
-   *  \param[out] theShells resulting shells.
-   *  \param[out] theFreeFaces faces that does not have common edges.
+   *  \param[out] theCombinedShapes resulting shapes.
+   *  \param[out] theFreeShapes shapes that does not have common subshapes.
    */
   static void combineShapes(const std::shared_ptr<GeomAPI_Shape> theCompound,
                             const GeomAPI_Shape::ShapeType theType,
                             ListOfShape& theCombinedShapes,
                             ListOfShape& theFreeShapes);
 
+  /** \brief Calculates bounding box for theShapes
+   *  \return list of eight points.
+   *  \param[in] theShapes list of shapes.
+   *  \param[in] theEnlarge enlarges bounding box size.
+   */
+  static std::list<std::shared_ptr<GeomAPI_Pnt> > getBoundingBox(const ListOfShape& theShapes, const double theEnlarge = 0.0);
+
   /**
-   * Returns infinite plane received from theFace plane
+   * Returns infinite plane received from theFace plane.
    */
-  static std::shared_ptr<GeomAPI_Shape> faceToInfinitePlane(const std::shared_ptr<GeomAPI_Shape>& theFace);
+  static std::shared_ptr<GeomAPI_Shape> faceToInfinitePlane(const std::shared_ptr<GeomAPI_Shape> theFace);
+
+  /** \brief Enlarges or reduces plane to fit bounding box.
+   *  \return plane that fits to bounding box.
+   *  \param[in] thePlane base plane.
+   *  \param[in] thePoints bounding box points (shoud be eight).
+   */
+  static std::shared_ptr<GeomAPI_Shape> fitPlaneToBox(const std::shared_ptr<GeomAPI_Shape> thePlane,
+                                                      const std::list<std::shared_ptr<GeomAPI_Pnt> >& thePoints);
+
 };
 
 #endif