GEOMUtils.hxx

Go to the documentation of this file.

// Copyright (C) 2007-2016  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
//
// 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 bool CheckTriangulation (const TopoDS_Shape& theShape);
  
  Standard_EXPORT TopAbs_ShapeEnum GetTypeOfSimplePart (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 GetMinDistanceSingular(const TopoDS_Shape& aSh1,
                                     const TopoDS_Shape& aSh2,
                                     gp_Pnt& Ptmp1, gp_Pnt& Ptmp2);
  
  Standard_EXPORT Standard_Real GetMinDistance(const TopoDS_Shape& theShape1,
                                const TopoDS_Shape& theShape2,
                                gp_Pnt& thePnt1, gp_Pnt& thePnt2);
  
  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 );

  Standard_EXPORT bool CheckBOPArguments(const TopoDS_Shape &theShape);
  
  Standard_EXPORT bool FixShapeTolerance( TopoDS_Shape& shape,
                                          TopAbs_ShapeEnum type,
                                          Standard_Real tolerance = Precision::Confusion(),
                                          bool checkGeometry = false );

  Standard_EXPORT bool FixShapeTolerance( TopoDS_Shape& shape,
                                          Standard_Real tolerance = Precision::Confusion(),
                                          bool checkGeometry = false );

  Standard_EXPORT bool FixShapeTolerance( TopoDS_Shape& shape,
                                          bool checkGeometry );

  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 void MeshShape( const TopoDS_Shape shape,
                                  double deflection, bool forced = true );

  Standard_EXPORT double DefaultDeflection();

  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