Salome HOME
Synchronize adm files
[modules/geom.git] / src / GEOMUtils / GEOMUtils.hxx
old mode 100644 (file)
new mode 100755 (executable)
index 64c34bd..b35495b
@@ -1,4 +1,4 @@
-// Copyright (C) 2007-2013  CEA/DEN, EDF R&D, OPEN CASCADE
+// Copyright (C) 2007-2014  CEA/DEN, EDF R&D, OPEN CASCADE
 //
 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
@@ -6,7 +6,7 @@
 // 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.
+// 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
@@ -23,6 +23,7 @@
 #ifndef _GEOMUtils_HXX_
 #define _GEOMUtils_HXX_
 
+#include <Standard_Macro.hxx>
 #include <TopoDS_Shape.hxx>
 #include <TopoDS_Vertex.hxx>
 
 #include <gp_Ax3.hxx>
 #include <gp_Vec.hxx>
 
+#include <V3d_View.hxx>
+
 #include <NCollection_DataMap.hxx>
 
 #include <functional>
 
+#include <map>
+#include <vector>
+#include <string>
+#include <utility>
+
+class Bnd_Box;
+
 inline Standard_Boolean IsEqual (const TopoDS_Shape& S1, const TopoDS_Shape& S2)
 {
   return S1.IsSame(S2);
 }
 
-class GEOMUtils {
+namespace GEOMUtils {
+
+  typedef std::vector<std::string> NodeLinks;
+  typedef std::map<std::string, NodeLinks> LevelInfo;
+  typedef std::vector<LevelInfo> LevelsList;
+  typedef std::map<std::string,std::pair<LevelsList,LevelsList> > TreeModel;
 
- public:
   /*!
    * \brief Get Local Coordinate System, corresponding to the given shape.
    *
@@ -52,7 +66,7 @@ class GEOMUtils {
    * Axes of the LCS are obtained from shape's location or,
    * if the shape is a planar face, from position of its plane.
    */
-  Standard_EXPORT static gp_Ax3 GetPosition (const TopoDS_Shape& theShape);
+  Standard_EXPORT gp_Ax3 GetPosition (const TopoDS_Shape& theShape);
 
   /*!
    * \brief Get vector, defined by the given edge.
@@ -62,7 +76,7 @@ class GEOMUtils {
    *       the same edge can have different orientation depending on the way it was
    *       extracted from a shape.
    */
-  Standard_EXPORT static gp_Vec GetVector (const TopoDS_Shape& theShape,
+  Standard_EXPORT gp_Vec GetVector (const TopoDS_Shape& theShape,
                                            Standard_Boolean doConsiderOrientation);
 
   /*!
@@ -84,7 +98,7 @@ class GEOMUtils {
   /*!
    * \brief Sort shapes by their centers of mass, using formula X*999 + Y*99 + Z*0.9
    */
-  Standard_EXPORT static void SortShapes (TopTools_ListOfShape& SL,
+  Standard_EXPORT void SortShapes (TopTools_ListOfShape& SL,
                                           const Standard_Boolean isOldSorting = Standard_True);
 
   /*!
@@ -95,7 +109,7 @@ class GEOMUtils {
    * \param theCompsolid The compsolid to be converted.
    * \retval TopoDS_Shape Returns the resulting compound.
    */
-  Standard_EXPORT static TopoDS_Shape CompsolidToCompound (const TopoDS_Shape& theCompsolid);
+  Standard_EXPORT TopoDS_Shape CompsolidToCompound (const TopoDS_Shape& theCompsolid);
 
   /*!
    * \brief Recursively extract all shapes from compounds and compsolids of the given shape into theList.
@@ -105,7 +119,7 @@ class GEOMUtils {
    * \param theShape The shape to be exploded.
    * \param theList Output parameter.
    */
-  Standard_EXPORT static void AddSimpleShapes (const TopoDS_Shape& theShape,
+  Standard_EXPORT void AddSimpleShapes (const TopoDS_Shape& theShape,
                                                TopTools_ListOfShape& theList);
 
   /*!
@@ -113,14 +127,14 @@ class GEOMUtils {
    * \param theShape The shape to check/build triangulation on.
    * \retval bool Returns false if the shape has no faces, i.e. impossible to build triangulation.
    */
-  Standard_EXPORT static bool CheckTriangulation (const TopoDS_Shape& theShape);
+  Standard_EXPORT bool CheckTriangulation (const TopoDS_Shape& theShape);
 
   /*!
    * \brief Return type of shape for explode. In case of compound it will be a type of its first sub shape.
    * \param theShape The shape to get type of.
    * \retval TopAbs_ShapeEnum Return type of shape for explode.
    */
-  Standard_EXPORT static TopAbs_ShapeEnum GetTypeOfSimplePart (const TopoDS_Shape& theShape);
+  Standard_EXPORT TopAbs_ShapeEnum GetTypeOfSimplePart (const TopoDS_Shape& theShape);
 
   /*!
    * \brief Find an edge of theShape, closest to thePoint.
@@ -129,9 +143,64 @@ class GEOMUtils {
    * \param thePoint The point near the required edge.
    * \retval TopoDS_Shape Returns the found edge or an empty shape if multiple edges found.
    */
-  Standard_EXPORT static TopoDS_Shape GetEdgeNearPoint (const TopoDS_Shape&  theShape,
+  Standard_EXPORT TopoDS_Shape GetEdgeNearPoint (const TopoDS_Shape&  theShape,
                                                         const TopoDS_Vertex& thePoint);
 
+  /*!
+   * \brief Compute precise bounding box of the shape based on the rough bounding box.
+   *
+   * \param theShape the shape.
+   * \param theBox rough bounding box on input; precise bounding box on output.
+   * \retval Standard_True in case of success; Standard_False otherwise.
+   */
+  Standard_EXPORT Standard_Boolean PreciseBoundingBox
+                          (const TopoDS_Shape &theShape, Bnd_Box &theBox);
+
+  /*!
+   * \brief Computes minumal distance between two shapes for singular cases
+   *        (workaround for bugs 19899, 19908 and 19910 from Mantis).
+   *
+   * \param aSh1 the first shape
+   * \param aSh2 the second shape
+   * \param Ptmp1 the output result point on the first shape
+   * \param Ptmp2 the output result point on the second shape
+   * \retval negative value if it is not a singular case; actual distance for singular case.
+   */
+  Standard_EXPORT Standard_Real GetMinDistanceSingular
+                               (const TopoDS_Shape& aSh1,
+                                const TopoDS_Shape& aSh2,
+                                gp_Pnt& Ptmp1, gp_Pnt& Ptmp2);
+
+  /*!
+   * \brief Computes minumal distance between two shapes.
+   *
+   * \param theShape1 the first shape
+   * \param theShape2 the second shape
+   * \param thePnt1 the output result point on the first shape
+   * \param thePnt2 the output result point on the second shape
+   * \retval negative value in case of failure; otherwise the real distance.
+   */
+  Standard_EXPORT Standard_Real GetMinDistance
+                               (const TopoDS_Shape& theShape1,
+                                const TopoDS_Shape& theShape2,
+                                gp_Pnt& thePnt1, gp_Pnt& thePnt2);
+
+  /*!
+   * \brief Returns the point clicked in 3D view.
+   *
+   * \param x The X coordinate in the view.
+   * \param y The Y coordinate in the view.
+   * \param theView View where the given point takes place.
+   * \retval gp_Pnt Returns the point clicked in 3D view
+   */
+  Standard_EXPORT gp_Pnt ConvertClickToPoint( int x, int y, Handle(V3d_View) theView );
+
+  Standard_EXPORT void ConvertTreeToString( const TreeModel &theTree,
+                                           std::string &DependencyStr );
+
+  Standard_EXPORT void ConvertStringToTree( const std::string &theDependencyStr,
+                                           TreeModel &tree );
+
 };
 
 #endif