1 // Copyright (C) 2007-2011 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.
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
23 // File : StdMeshers_FaceSide.hxx
24 // Created : Wed Jan 31 18:41:25 2007
25 // Author : Edward AGAPOV (eap)
28 #ifndef StdMeshers_FaceSide_HeaderFile
29 #define StdMeshers_FaceSide_HeaderFile
31 #include "SMESH_StdMeshers.hxx"
33 #include <Geom2d_Curve.hxx>
34 #include <GeomAdaptor_Curve.hxx>
35 #include <TopoDS_Edge.hxx>
36 #include <TopoDS_Vertex.hxx>
37 #include <gp_Pnt2d.hxx>
41 #include <boost/shared_ptr.hpp>
45 class Adaptor2d_Curve2d;
46 class Adaptor3d_Curve;
47 class BRepAdaptor_CompCurve;
49 struct SMESH_ComputeError;
51 typedef struct uvPtStruct
56 double u; // original 2d parameter
58 double x; // 2d parameter, normalized [0,1]
60 const SMDS_MeshNode * node;
63 class StdMeshers_FaceSide;
64 typedef boost::shared_ptr< StdMeshers_FaceSide > StdMeshers_FaceSidePtr;
65 typedef std::vector< StdMeshers_FaceSidePtr > TSideVector;
66 typedef boost::shared_ptr< SMESH_ComputeError > TError;
68 //================================================================================
70 * \brief Represents a side of a quasi quadrilateral face.
71 * It can be composed of several edges. Gives access to geometry and 1D mesh of a side.
73 //================================================================================
75 class STDMESHERS_EXPORT StdMeshers_FaceSide
79 * \brief Wrap one edge
81 StdMeshers_FaceSide(const TopoDS_Face& theFace,
82 const TopoDS_Edge& theEdge,
84 const bool theIsForward,
85 const bool theIgnoreMediumNodes);
87 * \brief Wrap several edges. Edges must be properly ordered and oriented.
89 StdMeshers_FaceSide(const TopoDS_Face& theFace,
90 std::list<TopoDS_Edge>& theEdges,
92 const bool theIsForward,
93 const bool theIgnoreMediumNodes);
95 * \brief Simulate a side from a vertex using data from other FaceSide
97 StdMeshers_FaceSide(const SMDS_MeshNode* theNode,
98 const gp_Pnt2d thePnt2d,
99 const StdMeshers_FaceSide* theSide);
101 * \brief Return wires of a face as StdMeshers_FaceSide's
103 static TSideVector GetFaceWires(const TopoDS_Face& theFace,
104 SMESH_Mesh & theMesh,
105 const bool theIgnoreMediumNodes,
109 * \brief Change orientation of side geometry
113 * \brief Return nb nodes on edges and vertices (+1 to be == GetUVPtStruct().size() )
115 int NbPoints() const { return myNbPonits; }
117 * \brief Return nb edges
119 int NbSegments() const { return myNbSegments; }
123 SMESH_Mesh* GetMesh() const { return myMesh; }
125 * \brief Return true if there are vertices without nodes
127 bool MissVertexNode() const { return myMissingVertexNodes; }
129 * \brief Return detailed data on nodes
130 * \param isXConst - true if normalized parameter X is constant
131 * \param constValue - constant parameter value
133 * Missing nodes are allowed only on internal vertices.
134 * For a closed side, the 1st point repeats at end
136 const std::vector<UVPtStruct>& GetUVPtStruct(bool isXConst =0, double constValue =0) const;
138 * \brief Simulates detailed data on nodes
139 * \param isXConst - true if normalized parameter X is constant
140 * \param constValue - constant parameter value
142 const std::vector<UVPtStruct>& SimulateUVPtStruct(int nbSeg,
144 double constValue = 0) const;
146 * \brief Return nodes in the order they encounter while walking along the side.
147 * For a closed side, the 1st point repeats at end
149 std::vector<const SMDS_MeshNode*> GetOrderedNodes() const;
151 * \brief Return edge and parameter on edge by normalized parameter
153 inline double Parameter(double U, TopoDS_Edge & edge) const;
155 * \brief Return UV by normalized parameter
157 gp_Pnt2d Value2d(double U) const;
159 * \brief Creates a Adaptor2d_Curve2d to be used in SMESH_Block
161 Adaptor2d_Curve2d* GetCurve2d() const;
163 * \brief Creates a fully functional Adaptor_Curve
165 BRepAdaptor_CompCurve* GetCurve3d() const;
167 * \brief Return nb of wrapped edges
169 int NbEdges() const { return myEdge.size(); }
171 * \brief Return i-th wrapped edge (count starts from zero)
173 const TopoDS_Edge& Edge(int i) const { return myEdge[i]; }
175 * \brief Return all edges
177 const std::vector<TopoDS_Edge>& Edges() const { return myEdge; }
179 * \brief Return 1st vertex of the i-the edge (count starts from zero)
181 TopoDS_Vertex FirstVertex(int i=0) const;
183 * \brief Return last vertex of the i-the edge (count starts from zero)
185 TopoDS_Vertex LastVertex(int i=-1) const;
187 * \brief Return first normalized parameter of the i-the edge (count starts from zero)
189 inline double FirstParameter(int i) const;
191 * \brief Return ast normalized parameter of the i-the edge (count starts from zero)
193 inline double LastParameter(int i) const;
195 * \brief Return side length
197 double Length() const { return myLength; }
199 * \brief Return edge index corresponding to normalized parameter
201 inline int EdgeIndex( double U ) const;
203 //virtual gp_Pnt Value(double U) const;
205 void dump(const char* msg=0) const;
210 // DON't FORGET to update Reverse() when adding one more vector!
211 std::vector<uvPtStruct> myPoints, myFalsePoints;
212 std::vector<TopoDS_Edge> myEdge;
213 std::vector<int> myEdgeID;
214 std::vector<Handle(Geom2d_Curve)> myC2d;
215 std::vector<GeomAdaptor_Curve> myC3dAdaptor;
216 std::vector<double> myFirst, myLast;
217 std::vector<double> myNormPar;
218 std::vector<double> myEdgeLength;
219 std::vector<double> myIsUniform;
221 int myNbPonits, myNbSegments;
223 bool myMissingVertexNodes, myIgnoreMediumNodes;
224 gp_Pnt2d myDefaultPnt2d;
228 //================================================================================
230 * \brief Return edge index corresponding to normalized parameter
231 * \param U - the parameter
232 * \retval int - index
234 //================================================================================
236 inline int StdMeshers_FaceSide::EdgeIndex( double U ) const
238 int i = myNormPar.size() - 1;
239 while ( i > 0 && U < myNormPar[ i-1 ] ) --i;
243 //================================================================================
245 * \brief Return edge and parameter on edge by normalized parameter
246 * \param U - the parameter
247 * \retval double - pameter on a curve
249 //================================================================================
251 inline double StdMeshers_FaceSide::Parameter(double U, TopoDS_Edge & edge) const
253 int i = EdgeIndex( U );
255 double prevU = i ? myNormPar[ i-1 ] : 0;
256 double r = ( U - prevU )/ ( myNormPar[ i ] - prevU );
257 return myFirst[i] * ( 1 - r ) + myLast[i] * r;
260 //================================================================================
262 * \brief Return first normalized parameter of the i-the edge
264 //================================================================================
266 inline double StdMeshers_FaceSide::FirstParameter(int i) const
268 return i==0 ? 0. : i<myNormPar.size() ? myNormPar[i-1] : 1.;
271 //================================================================================
273 * \brief Return ast normalized parameter of the i-the edge
275 //================================================================================
277 inline double StdMeshers_FaceSide::LastParameter(int i) const
279 return i<myNormPar.size() ? myNormPar[i] : 1;