GEOMUtils.hxx

Go to the documentation of this file.

// Copyright (C) 2007-2026  CEA, EDF, OPEN CASCADE
//
// Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
//
// 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 _GEOMUtils_HXX_
#define _GEOMUtils_HXX_
 
#include <Standard_Macro.hxx>
#include <TopoDS_Shape.hxx>
#include <TopoDS_Vertex.hxx>
 
#include <TopTools_ListOfShape.hxx>
 
#include <TopAbs.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);
}
 
namespace GEOMUtils
{
 
  enum ComparisonCondition {
    CC_GT, 
    CC_GE, 
    CC_LT, 
    CC_LE  
  };
 
  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;
 
  Standard_EXPORT std::pair<double, double> ShapeToDouble (const TopoDS_Shape& theShape,
                                                           bool isOldSorting = false);
 
  Standard_EXPORT gp_Ax3 GetPosition (const TopoDS_Shape& theShape);
 
  Standard_EXPORT gp_Vec GetVector (const TopoDS_Shape& theShape,
                        Standard_Boolean doConsiderOrientation);
 
  struct CompareShapes //: public std::binary_function<TopoDS_Shape, TopoDS_Shape, bool>
  {
    CompareShapes (bool isOldSorting)
      : myIsOldSorting(isOldSorting) {}
 
    bool operator() (const TopoDS_Shape& lhs, const TopoDS_Shape& rhs);
 
    typedef NCollection_DataMap<TopoDS_Shape, std::pair<double, double> > GEOMUtils_DataMapOfShapeDouble;
    GEOMUtils_DataMapOfShapeDouble myMap;
    bool myIsOldSorting;
  };
 
  Standard_EXPORT void SortShapes (TopTools_ListOfShape& SL,
                       const Standard_Boolean isOldSorting = Standard_True);
 
  Standard_EXPORT TopoDS_Shape CompsolidToCompound (const TopoDS_Shape& theCompsolid);
 
  Standard_EXPORT void AddSimpleShapes (const TopoDS_Shape& theShape,
                         TopTools_ListOfShape& theList);
 
  Standard_EXPORT TopAbs_ShapeEnum GetTypeOfSimplePart (const TopoDS_Shape& theShape);
 
  Standard_EXPORT TopAbs_ShapeEnum GetCommonShapeType (const TopoDS_Shape& theShape);
 
  Standard_EXPORT TopoDS_Shape GetEdgeNearPoint (const TopoDS_Shape&  theShape,
                               const TopoDS_Vertex& thePoint);
 
  Standard_EXPORT Standard_Boolean PreciseBoundingBox(const TopoDS_Shape &theShape, Bnd_Box &theBox);
 
  Standard_EXPORT Standard_Real GetMinDistance(const TopoDS_Shape& theShape1,
                                const TopoDS_Shape& theShape2,
                                gp_Pnt& thePnt1, gp_Pnt& thePnt2);
 
  Standard_EXPORT gp_Pnt ProjectPointOnFace(const gp_Pnt& thePoint,
                                            const TopoDS_Shape& theFace,
                                            double& theU, double& theV,
                                            const double theTol = 1e-04);
 
  Standard_EXPORT Standard_Real DistanceToProjectionOnFace(const gp_Pnt& thePoint,
                                                           const TopoDS_Shape& theFace,
                                                           const double theTol = 1e-04);
 
  Standard_EXPORT gp_Pnt ConvertClickToPoint( int x, int y, Handle(V3d_View) theView );
 
  Standard_EXPORT void ConvertTreeToString( const TreeModel& tree,
                             std::string& dependencyStr );
 
  Standard_EXPORT void ConvertStringToTree( const std::string& dependencyStr,
                             TreeModel& tree );
 
  Standard_EXPORT bool CheckShape( TopoDS_Shape& shape,
                                   bool checkGeometry = false,
                                   bool isExact = false );
 
  Standard_EXPORT bool CheckBOPArguments(const TopoDS_Shape &theShape);
 
  Standard_EXPORT bool FixShapeTolerance( TopoDS_Shape& shape,
                                          TopAbs_ShapeEnum type = TopAbs_SHAPE,
                                          Standard_Real tolerance = Precision::Confusion(),
                                          bool checkGeometry = false,
                                          bool isExactAdjust = false );
 
  Standard_EXPORT bool FixShapeCurves( TopoDS_Shape& shape );
 
  Standard_EXPORT bool Write( const TopoDS_Shape& shape,
                              const char* fileName );
 
  Standard_EXPORT TopoDS_Shape ReduceCompound( const TopoDS_Shape& shape );
 
  Standard_EXPORT double DefaultDeflection();
 
  Standard_EXPORT bool MeshShape( const TopoDS_Shape theShape,
                                  const double theDeflection = DefaultDeflection(),
                                  const bool theForced = true,
                                  const double theAngleDeflection = 0.5,
                                  const bool isRelative = true,
                                  const bool doPostCheck = false);
 
  Standard_EXPORT bool CheckTriangulation (const TopoDS_Shape& theShape);
 
  Standard_EXPORT bool IsOpenPath(const TopoDS_Shape &theShape);
 
  Standard_EXPORT int CompareToleranceValues(const double theTolShape,
                                             const double theTolRef);
 
  Standard_EXPORT bool IsFitCondition(const ComparisonCondition theCondition,
                                      const double              theTolShape,
                                      const double              theTolRef);
 
}
 
#endif