1 // Copyright (C) 2007-2014 CEA/DEN, EDF R&D, OPEN CASCADE
3 // Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
6 // This library is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU Lesser General Public
8 // License as published by the Free Software Foundation; either
9 // version 2.1 of the License, or (at your option) any later version.
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 // Lesser General Public License for more details.
16 // You should have received a copy of the GNU Lesser General Public
17 // License along with this library; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
22 // File : SMESH_MeshAlgos.hxx
23 // Created : Tue Apr 30 18:00:36 2013
24 // Author : Edward AGAPOV (eap)
26 // This file holds some low level algorithms extracted from SMESH_MeshEditor
27 // to make them accessible from Controls package
30 #ifndef __SMESH_MeshAlgos_HXX__
31 #define __SMESH_MeshAlgos_HXX__
33 #include "SMESH_Utils.hxx"
35 #include "SMDSAbs_ElementType.hxx"
36 #include "SMDS_ElemIterator.hxx"
37 #include "SMESH_TypeDefs.hxx"
39 #include <TopAbs_State.hxx>
45 class SMDS_MeshElement;
48 //=======================================================================
50 * \brief Searcher for the node closest to a point
52 //=======================================================================
54 struct SMESHUtils_EXPORT SMESH_NodeSearcher
56 virtual const SMDS_MeshNode* FindClosestTo( const gp_Pnt& pnt ) = 0;
57 virtual void MoveNode( const SMDS_MeshNode* node, const gp_Pnt& toPnt ) = 0;
60 //=======================================================================
62 * \brief Searcher for elements
64 //=======================================================================
66 struct SMESHUtils_EXPORT SMESH_ElementSearcher
69 * \brief Find elements of given type where the given point is IN or ON.
70 * Returns nb of found elements and elements them-selves.
72 * 'ALL' type means elements of any type excluding nodes and 0D elements
74 virtual int FindElementsByPoint(const gp_Pnt& point,
75 SMDSAbs_ElementType type,
76 std::vector< const SMDS_MeshElement* >& foundElems) = 0;
78 * \brief Return an element most close to the given point
80 virtual const SMDS_MeshElement* FindClosestTo( const gp_Pnt& point,
81 SMDSAbs_ElementType type) = 0;
83 * \brief Return elements possibly intersecting the line
85 virtual void GetElementsNearLine( const gp_Ax1& line,
86 SMDSAbs_ElementType type,
87 std::vector< const SMDS_MeshElement* >& foundElems) = 0;
89 * \brief Find out if the given point is out of closed 2D mesh.
91 virtual TopAbs_State GetPointState(const gp_Pnt& point) = 0;
92 virtual ~SMESH_ElementSearcher();
95 namespace SMESH_MeshAlgos
98 * \brief Return true if the point is IN or ON of the element
101 bool IsOut( const SMDS_MeshElement* element, const gp_Pnt& point, double tol );
104 double GetDistance( const SMDS_MeshElement* elem, const gp_Pnt& point );
107 double GetDistance( const SMDS_MeshEdge* edge, const gp_Pnt& point );
110 double GetDistance( const SMDS_MeshFace* face, const gp_Pnt& point );
113 double GetDistance( const SMDS_MeshVolume* volume, const gp_Pnt& point );
116 void GetBarycentricCoords( const gp_XY& point,
117 const gp_XY& t0, const gp_XY& t1, const gp_XY& t2,
118 double & bc0, double & bc1);
121 * Return a face having linked nodes n1 and n2 and which is
123 * - in elemSet provided that !elemSet.empty()
124 * i1 and i2 optionally returns indices of n1 and n2
127 const SMDS_MeshElement* FindFaceInSet(const SMDS_MeshNode* n1,
128 const SMDS_MeshNode* n2,
129 const TIDSortedElemSet& elemSet,
130 const TIDSortedElemSet& avoidSet,
134 * \brief Calculate normal of a mesh face
137 bool FaceNormal(const SMDS_MeshElement* F, gp_XYZ& normal, bool normalized=true);
140 * \brief Return nodes common to two elements
143 std::vector< const SMDS_MeshNode*> GetCommonNodes(const SMDS_MeshElement* e1,
144 const SMDS_MeshElement* e2);
147 * \brief Return SMESH_NodeSearcher. The caller is responsible for deleteing it
150 SMESH_NodeSearcher* GetNodeSearcher( SMDS_Mesh& mesh );
153 * \brief Return SMESH_ElementSearcher. The caller is responsible for deleting it
156 SMESH_ElementSearcher* GetElementSearcher( SMDS_Mesh& mesh );
158 SMESH_ElementSearcher* GetElementSearcher( SMDS_Mesh& mesh,
159 SMDS_ElemIteratorPtr elemIt );