1 // Copyright (C) 2007-2021 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
23 // SMESH SMESH_I : idl implementation based on 'SMESH' unit's classes
24 // File : SMESH_MeshEditor_i.hxx
25 // Author : Nicolas REJNERI
28 #ifndef _SMESH_MESHEDITOR_I_HXX_
29 #define _SMESH_MESHEDIOTR_I_HXX_
33 #include <SALOMEconfig.h>
34 #include CORBA_SERVER_HEADER(SMESH_MeshEditor)
36 #include "SMESH_Mesh.hxx"
37 #include "SMESH_PythonDump.hxx"
38 #include "SMESH_MeshEditor.hxx"
44 namespace MeshEditor_I {
46 struct ExtrusionParams;
49 class SMESH_I_EXPORT SMESH_MeshEditor_i: public POA_SMESH::SMESH_MeshEditor
52 SMESH_MeshEditor_i(SMESH_Mesh_i * theMesh, bool isPreview);
54 virtual ~ SMESH_MeshEditor_i();
56 * \brief Return edited mesh ID
57 * \retval int - mesh ID
59 int GetMeshId() const { return myMesh->GetId(); }
61 SMESH::SMESH_Mesh_ptr GetMesh();
66 * Return data of mesh edition preview
68 SMESH::MeshPreviewStruct* GetPreviewData();
70 * If during last operation of MeshEditor some nodes were
71 * created this method returns list of their IDs, if new nodes
72 * not created - returns an empty list
74 SMESH::smIdType_array* GetLastCreatedNodes();
76 * If during last operation of MeshEditor some elements were
77 * created this method returns list of their IDs, if new elements
78 * not created - returns an empty list
80 SMESH::smIdType_array* GetLastCreatedElems();
82 * \brief Clears sequences of last created elements and nodes
84 void ClearLastCreated();
86 * \brief Returns description of an error/warning occurred during the last operation
88 SMESH::ComputeError* GetLastError();
91 * \brief Wrap a sequence of ids in a SMESH_IDSource
93 SMESH::SMESH_IDSource_ptr MakeIDSource(const SMESH::smIdType_array& IDsOfElements,
94 SMESH::ElementType type);
95 static bool IsTemporaryIDSource( SMESH::SMESH_IDSource_ptr& idSource );
96 static SMESH::smIdType* GetTemporaryIDs( SMESH::SMESH_IDSource_ptr& idSource, smIdType& nbIds );
99 * \brief Generates the unique group name
101 std::string GenerateGroupName(const std::string& thePrefix);
103 CORBA::Boolean RemoveElements(const SMESH::smIdType_array & IDsOfElements);
104 CORBA::Boolean RemoveNodes (const SMESH::smIdType_array & IDsOfNodes);
105 SMESH::smIdType RemoveOrphanNodes();
108 * Methods for creation new elements.
109 * Returns ID of created element or 0 if element not created
111 SMESH::smIdType AddNode(CORBA::Double x, CORBA::Double y, CORBA::Double z);
112 SMESH::smIdType Add0DElement(SMESH::smIdType IDOfNode, CORBA::Boolean DuplicateElements);
113 SMESH::smIdType AddBall(SMESH::smIdType IDOfNodem, CORBA::Double diameter);
114 SMESH::smIdType AddEdge(const SMESH::smIdType_array & IDsOfNodes);
115 SMESH::smIdType AddFace(const SMESH::smIdType_array & IDsOfNodes);
116 SMESH::smIdType AddPolygonalFace(const SMESH::smIdType_array & IDsOfNodes);
117 SMESH::smIdType AddQuadPolygonalFace(const SMESH::smIdType_array & IDsOfNodes);
118 SMESH::smIdType AddVolume(const SMESH::smIdType_array & IDsOfNodes);
119 SMESH::smIdType AddPolyhedralVolume(const SMESH::smIdType_array & IDsOfNodes,
120 const SMESH::long_array & Quantities);
121 SMESH::smIdType AddPolyhedralVolumeByFaces(const SMESH::smIdType_array & IdsOfFaces);
124 * \brief Create 0D elements on all nodes of the given object except those
125 * nodes on which a 0D element already exists.
126 * \param theObject object on whose nodes 0D elements will be created.
127 * \param theGroupName optional name of a group to add 0D elements created
128 * and/or found on nodes of \a theObject.
129 * \param theDuplicateElements to add one more 0D element to a node or not
130 * \return an object (a new group or a temporary SMESH_IDSource) holding
131 * ids of new and/or found 0D elements.
133 SMESH::SMESH_IDSource_ptr Create0DElementsOnAllNodes(SMESH::SMESH_IDSource_ptr theObject,
134 const char* theGroupName,
135 CORBA::Boolean theDuplicateElements);
138 * \brief Bind a node to a vertex
139 * \param NodeID - node ID
140 * \param VertexID - vertex ID available through GEOM_Object.GetSubShapeIndices()[0]
142 void SetNodeOnVertex(SMESH::smIdType NodeID, CORBA::Long VertexID);
144 * \brief Store node position on an edge
145 * \param NodeID - node ID
146 * \param EdgeID - edge ID available through GEOM_Object.GetSubShapeIndices()[0]
147 * \param paramOnEdge - parameter on edge where the node is located
149 void SetNodeOnEdge(SMESH::smIdType NodeID, CORBA::Long EdgeID,
150 CORBA::Double paramOnEdge);
152 * \brief Store node position on a face
153 * \param NodeID - node ID
154 * \param FaceID - face ID available through GEOM_Object.GetSubShapeIndices()[0]
155 * \param u - U parameter on face where the node is located
156 * \param v - V parameter on face where the node is located
158 void SetNodeOnFace(SMESH::smIdType NodeID, CORBA::Long FaceID,
159 CORBA::Double u, CORBA::Double v);
161 * \brief Bind a node to a solid
162 * \param NodeID - node ID
163 * \param SolidID - vertex ID available through GEOM_Object.GetSubShapeIndices()[0]
165 void SetNodeInVolume(SMESH::smIdType NodeID, CORBA::Long SolidID);
167 * \brief Bind an element to a shape
168 * \param ElementID - element ID
169 * \param ShapeID - shape ID available through GEOM_Object.GetSubShapeIndices()[0]
171 void SetMeshElementOnShape(SMESH::smIdType ElementID, CORBA::Long ShapeID);
174 CORBA::Boolean MoveNode(SMESH::smIdType NodeID,
175 CORBA::Double x, CORBA::Double y, CORBA::Double z);
177 CORBA::Boolean InverseDiag(SMESH::smIdType NodeID1, SMESH::smIdType NodeID2);
178 CORBA::Boolean DeleteDiag(SMESH::smIdType NodeID1, SMESH::smIdType NodeID2);
179 CORBA::Boolean Reorient(const SMESH::smIdType_array & IDsOfElements);
180 CORBA::Boolean ReorientObject(SMESH::SMESH_IDSource_ptr theObject);
183 * \brief Reorient faces contained in \a the2Dgroup.
184 * \param the2Dgroup - the mesh or its part to reorient
185 * \param theDirection - desired direction of normal of \a theFace
186 * \param theFace - ID of face whose orientation is checked.
187 * It can be < 1 then \a thePoint is used to find a face.
188 * \param thePoint - is used to find a face if \a theFace < 1.
189 * \return number of reoriented elements.
191 CORBA::Long Reorient2D(SMESH::SMESH_IDSource_ptr the2Dgroup,
192 const SMESH::DirStruct& theDirection,
194 const SMESH::PointStruct& thePoint);
196 * \brief Reorient faces basing on orientation of adjacent volumes.
197 * \param faces - a list of objects containing face to reorient
198 * \param volumes - an object containing volumes.
199 * \param outsideNormal - to orient faces to have their normal
200 * pointing either \a outside or \a inside the adjacent volumes.
201 * \return number of reoriented faces.
203 CORBA::Long Reorient2DBy3D(const SMESH::ListOfIDSources & faces,
204 SMESH::SMESH_IDSource_ptr volumes,
205 CORBA::Boolean outsideNormal);
208 CORBA::Boolean TriToQuad (const SMESH::smIdType_array & IDsOfElements,
209 SMESH::NumericalFunctor_ptr Criterion,
210 CORBA::Double MaxAngle);
211 CORBA::Boolean TriToQuadObject (SMESH::SMESH_IDSource_ptr theObject,
212 SMESH::NumericalFunctor_ptr Criterion,
213 CORBA::Double MaxAngle);
214 CORBA::Boolean QuadToTri (const SMESH::smIdType_array & IDsOfElements,
215 SMESH::NumericalFunctor_ptr Criterion);
216 CORBA::Boolean QuadToTriObject (SMESH::SMESH_IDSource_ptr theObject,
217 SMESH::NumericalFunctor_ptr Criterion);
218 void QuadTo4Tri (SMESH::SMESH_IDSource_ptr theObject);
219 CORBA::Boolean SplitQuad (const SMESH::smIdType_array & IDsOfElements,
220 CORBA::Boolean Diag13);
221 CORBA::Boolean SplitQuadObject (SMESH::SMESH_IDSource_ptr theObject,
222 CORBA::Boolean Diag13);
223 CORBA::Long BestSplit (CORBA::Long IDOfQuad,
224 SMESH::NumericalFunctor_ptr Criterion);
225 void SplitVolumesIntoTetra(SMESH::SMESH_IDSource_ptr elems,
226 CORBA::Short methodFlags);
227 void SplitHexahedraIntoPrisms(SMESH::SMESH_IDSource_ptr elems,
228 const SMESH::PointStruct & startHexPoint,
229 const SMESH::DirStruct& facetToSplitNormal,
230 CORBA::Short methodFlags,
231 CORBA::Boolean allDomains);
232 void SplitBiQuadraticIntoLinear(const SMESH::ListOfIDSources& elems);
234 CORBA::Boolean Smooth(const SMESH::smIdType_array & IDsOfElements,
235 const SMESH::smIdType_array & IDsOfFixedNodes,
236 CORBA::Short MaxNbOfIterations,
237 CORBA::Double MaxAspectRatio,
238 SMESH::SMESH_MeshEditor::Smooth_Method Method);
239 CORBA::Boolean SmoothObject(SMESH::SMESH_IDSource_ptr theObject,
240 const SMESH::smIdType_array & IDsOfFixedNodes,
241 CORBA::Short MaxNbOfIterations,
242 CORBA::Double MaxAspectRatio,
243 SMESH::SMESH_MeshEditor::Smooth_Method Method);
244 CORBA::Boolean SmoothParametric(const SMESH::smIdType_array & IDsOfElements,
245 const SMESH::smIdType_array & IDsOfFixedNodes,
246 CORBA::Short MaxNbOfIterations,
247 CORBA::Double MaxAspectRatio,
248 SMESH::SMESH_MeshEditor::Smooth_Method Method) ;
249 CORBA::Boolean SmoothParametricObject(SMESH::SMESH_IDSource_ptr theObject,
250 const SMESH::smIdType_array & IDsOfFixedNodes,
251 CORBA::Short MaxNbOfIterations,
252 CORBA::Double MaxAspectRatio,
253 SMESH::SMESH_MeshEditor::Smooth_Method Method);
254 CORBA::Boolean smooth(const SMESH::smIdType_array & IDsOfElements,
255 const SMESH::smIdType_array & IDsOfFixedNodes,
256 CORBA::Short MaxNbOfIterations,
257 CORBA::Double MaxAspectRatio,
258 SMESH::SMESH_MeshEditor::Smooth_Method Method,
260 CORBA::Boolean smoothObject(SMESH::SMESH_IDSource_ptr theObject,
261 const SMESH::smIdType_array & IDsOfFixedNodes,
262 CORBA::Short MaxNbOfIterations,
263 CORBA::Double MaxAspectRatio,
264 SMESH::SMESH_MeshEditor::Smooth_Method Method,
267 CORBA::Boolean ConvertFromQuadratic();
268 void ConvertFromQuadraticObject(SMESH::SMESH_IDSource_ptr theObject);
269 void ConvertToQuadratic(CORBA::Boolean Force3d);
270 void ConvertToQuadraticObject(CORBA::Boolean theForce3d,
271 SMESH::SMESH_IDSource_ptr theObject);
272 void ConvertToBiQuadratic(CORBA::Boolean theForce3d,
273 SMESH::SMESH_IDSource_ptr theObject);
275 void RenumberNodes();
276 void RenumberElements();
278 SMESH::ListOfGroups* RotationSweepObjects(const SMESH::ListOfIDSources & Nodes,
279 const SMESH::ListOfIDSources & Edges,
280 const SMESH::ListOfIDSources & Faces,
281 const SMESH::AxisStruct & Axis,
282 CORBA::Double AngleInRadians,
283 CORBA::Long NbOfSteps,
284 CORBA::Double Tolerance,
285 CORBA::Boolean ToMakeGroups);
287 SMESH::ListOfGroups* ExtrusionSweepObjects(const SMESH::ListOfIDSources & Nodes,
288 const SMESH::ListOfIDSources & Edges,
289 const SMESH::ListOfIDSources & Faces,
290 const SMESH::DirStruct & StepVector,
291 CORBA::Long NbOfSteps,
292 CORBA::Boolean ToMakeGroups,
293 const SMESH::double_array & ScaleFactors,
294 CORBA::Boolean ScalesVariation,
295 const SMESH::double_array & BasePoint,
296 const SMESH::double_array & Angles,
297 CORBA::Boolean AnglesVariation);
299 SMESH::ListOfGroups* ExtrusionByNormal(const SMESH::ListOfIDSources& objects,
300 CORBA::Double stepSize,
301 CORBA::Long nbOfSteps,
302 CORBA::Boolean byAverageNormal,
303 CORBA::Boolean useInputElemsOnly,
304 CORBA::Boolean makeGroups,
306 SMESH::ListOfGroups* AdvancedExtrusion(const SMESH::smIdType_array & theIDsOfElements,
307 const SMESH::DirStruct & theStepVector,
308 CORBA::Long theNbOfSteps,
309 CORBA::Long theExtrFlags,
310 CORBA::Double theSewTolerance,
311 CORBA::Boolean theMakeGroups);
314 ExtrusionAlongPathObjects(const SMESH::ListOfIDSources & Nodes,
315 const SMESH::ListOfIDSources & Edges,
316 const SMESH::ListOfIDSources & Faces,
317 SMESH::SMESH_IDSource_ptr PathMesh,
318 GEOM::GEOM_Object_ptr PathShape,
319 SMESH::smIdType NodeStart,
320 CORBA::Boolean HasAngles,
321 const SMESH::double_array & Angles,
322 CORBA::Boolean AnglesVariation,
323 CORBA::Boolean HasRefPoint,
324 const SMESH::PointStruct & RefPoint,
326 const SMESH::double_array & ScaleFactors,
327 CORBA::Boolean ScalesVariation,
328 SMESH::SMESH_MeshEditor::Extrusion_Error& Error);
330 SMESH::double_array* LinearAnglesVariation(SMESH::SMESH_Mesh_ptr PathMesh,
331 GEOM::GEOM_Object_ptr PathShape,
332 const SMESH::double_array & Angles);
334 void Mirror(const SMESH::smIdType_array & IDsOfElements,
335 const SMESH::AxisStruct & Axis,
336 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
337 CORBA::Boolean Copy);
338 void MirrorObject(SMESH::SMESH_IDSource_ptr theObject,
339 const SMESH::AxisStruct & Axis,
340 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
341 CORBA::Boolean Copy);
342 void Translate(const SMESH::smIdType_array & IDsOfElements,
343 const SMESH::DirStruct & Vector,
344 CORBA::Boolean Copy);
345 void TranslateObject(SMESH::SMESH_IDSource_ptr theObject,
346 const SMESH::DirStruct & Vector,
347 CORBA::Boolean Copy);
348 void Rotate(const SMESH::smIdType_array & IDsOfElements,
349 const SMESH::AxisStruct & Axis,
351 CORBA::Boolean Copy);
352 void RotateObject(SMESH::SMESH_IDSource_ptr theObject,
353 const SMESH::AxisStruct & Axis,
355 CORBA::Boolean Copy);
357 SMESH::ListOfGroups* MirrorMakeGroups(const SMESH::smIdType_array& IDsOfElements,
358 const SMESH::AxisStruct& Mirror,
359 SMESH::SMESH_MeshEditor::MirrorType MirrorType);
360 SMESH::ListOfGroups* MirrorObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
361 const SMESH::AxisStruct& Mirror,
362 SMESH::SMESH_MeshEditor::MirrorType MirrorType);
363 SMESH::ListOfGroups* TranslateMakeGroups(const SMESH::smIdType_array& IDsOfElements,
364 const SMESH::DirStruct& Vector);
365 SMESH::ListOfGroups* TranslateObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
366 const SMESH::DirStruct& Vector);
367 SMESH::ListOfGroups* RotateMakeGroups(const SMESH::smIdType_array& IDsOfElements,
368 const SMESH::AxisStruct& Axis,
369 CORBA::Double AngleInRadians);
370 SMESH::ListOfGroups* RotateObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
371 const SMESH::AxisStruct& Axis,
372 CORBA::Double AngleInRadians);
374 SMESH::SMESH_Mesh_ptr MirrorMakeMesh(const SMESH::smIdType_array& IDsOfElements,
375 const SMESH::AxisStruct& Mirror,
376 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
377 CORBA::Boolean CopyGroups,
378 const char* MeshName);
379 SMESH::SMESH_Mesh_ptr MirrorObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
380 const SMESH::AxisStruct& Mirror,
381 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
382 CORBA::Boolean CopyGroups,
383 const char* MeshName);
384 SMESH::SMESH_Mesh_ptr TranslateMakeMesh(const SMESH::smIdType_array& IDsOfElements,
385 const SMESH::DirStruct& Vector,
386 CORBA::Boolean CopyGroups,
387 const char* MeshName);
388 SMESH::SMESH_Mesh_ptr TranslateObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
389 const SMESH::DirStruct& Vector,
390 CORBA::Boolean CopyGroups,
391 const char* MeshName);
392 SMESH::SMESH_Mesh_ptr RotateMakeMesh(const SMESH::smIdType_array& IDsOfElements,
393 const SMESH::AxisStruct& Axis,
394 CORBA::Double AngleInRadians,
395 CORBA::Boolean CopyGroups,
396 const char* MeshName);
397 SMESH::SMESH_Mesh_ptr RotateObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
398 const SMESH::AxisStruct& Axis,
399 CORBA::Double AngleInRadians,
400 CORBA::Boolean CopyGroups,
401 const char* MeshName);
403 void Scale(SMESH::SMESH_IDSource_ptr theObject,
404 const SMESH::PointStruct& thePoint,
405 const SMESH::double_array& theScaleFact,
406 CORBA::Boolean theCopy);
408 SMESH::ListOfGroups* ScaleMakeGroups(SMESH::SMESH_IDSource_ptr theObject,
409 const SMESH::PointStruct& thePoint,
410 const SMESH::double_array& theScaleFact);
412 SMESH::SMESH_Mesh_ptr ScaleMakeMesh(SMESH::SMESH_IDSource_ptr Object,
413 const SMESH::PointStruct& Point,
414 const SMESH::double_array& theScaleFact,
415 CORBA::Boolean CopyGroups,
416 const char* MeshName);
418 SMESH::SMESH_Mesh_ptr Offset( SMESH::SMESH_IDSource_ptr theObject,
420 CORBA::Boolean CopyGroups,
421 CORBA::Boolean CopyElements,
422 const char* MeshName,
423 SMESH::ListOfGroups_out Groups);
425 void FindCoincidentNodes (CORBA::Double Tolerance,
426 SMESH::array_of_long_array_out GroupsOfNodes,
427 CORBA::Boolean SeparateCornersAndMedium);
428 void FindCoincidentNodesOnPart(SMESH::SMESH_IDSource_ptr Object,
429 CORBA::Double Tolerance,
430 SMESH::array_of_long_array_out GroupsOfNodes,
431 CORBA::Boolean SeparateCornersAndMedium);
432 void FindCoincidentNodesOnPartBut(const SMESH::ListOfIDSources& Objects,
433 CORBA::Double Tolerance,
434 SMESH::array_of_long_array_out GroupsOfNodes,
435 const SMESH::ListOfIDSources& ExceptSubMeshOrGroups,
436 CORBA::Boolean SeparateCornersAndMedium);
437 void MergeNodes (const SMESH::array_of_long_array& GroupsOfNodes,
438 const SMESH::ListOfIDSources& NodesToKeep,
439 CORBA::Boolean AvoidMakingHoles );
440 void FindEqualElements(const SMESH::ListOfIDSources& Objects,
441 const SMESH::ListOfIDSources& ExceptSubMeshOrGroups,
442 SMESH::array_of_long_array_out GroupsOfElementsID);
443 void MergeElements(const SMESH::array_of_long_array& GroupsOfElementsID,
444 const SMESH::ListOfIDSources& ElementsToKeep);
445 void MergeEqualElements();
446 SMESH::smIdType MoveClosestNodeToPoint(CORBA::Double x,
449 SMESH::smIdType nodeID);
451 * \brief Return ID of node closest to a given point
453 SMESH::smIdType FindNodeClosestTo(CORBA::Double x,
457 * Return elements of given type where the given point is IN or ON.
458 * 'ALL' type means elements of any type excluding nodes
460 SMESH::smIdType_array* FindElementsByPoint(CORBA::Double x,
463 SMESH::ElementType type);
465 * Searching among the given elements, return elements of given type
466 * where the given point is IN or ON.
467 * 'ALL' type means elements of any type excluding nodes
469 SMESH::smIdType_array* FindAmongElementsByPoint(SMESH::SMESH_IDSource_ptr elements,
473 SMESH::ElementType type);
476 * Project a point to a mesh object.
477 * Return ID of an element of given type where the given point is projected
478 * and coordinates of the projection point.
479 * In the case if nothing found, return -1 and []
481 SMESH::smIdType ProjectPoint(CORBA::Double x,
484 SMESH::ElementType type,
485 SMESH::SMESH_IDSource_ptr meshObject,
486 SMESH::double_array_out projecton);
489 * Return point state in a closed 2D mesh in terms of TopAbs_State enumeration.
490 * TopAbs_UNKNOWN state means that either mesh is wrong or the analysis fails.
492 CORBA::Short GetPointState(CORBA::Double x, CORBA::Double y, CORBA::Double z);
495 * Check if a 2D mesh is manifold
497 CORBA::Boolean IsManifold();
500 * Check if orientation of 2D elements is coherent
502 CORBA::Boolean IsCoherentOrientation2D();
505 * Partition given 1D elements into groups of contiguous edges.
506 * A node where number of meeting edges != 2 is a group end.
507 * An optional startNode is used to orient groups it belongs to.
508 * \return a list of edge groups and a list of corresponding node groups.
509 * If a group is closed, the first and last nodes of the group are same.
511 SMESH::array_of_long_array* Get1DBranches( SMESH::SMESH_IDSource_ptr edges,
512 SMESH::smIdType startNode,
513 SMESH::array_of_long_array_out nodeGroups);
516 * Return sharp edges of faces and non-manifold ones. Optionally adds existing edges.
518 SMESH::ListOfEdges* FindSharpEdges(CORBA::Double angle, CORBA::Boolean addExisting);
521 * Returns all or only closed FreeBorder's.
523 SMESH::ListOfFreeBorders* FindFreeBorders(CORBA::Boolean closedOnly);
526 * Fill with 2D elements a hole defined by a FreeBorder.
527 * Optionally add new faces to a given group, which is returned
529 SMESH::SMESH_Group_ptr FillHole(const SMESH::FreeBorder& hole,
530 const char* groupName);
532 SMESH::CoincidentFreeBorders* FindCoincidentFreeBorders(CORBA::Double tolerance);
533 CORBA::Short SewCoincidentFreeBorders(const SMESH::CoincidentFreeBorders& freeBorders,
534 CORBA::Boolean createPolygons,
535 CORBA::Boolean createPolyedrs);
537 SMESH::SMESH_MeshEditor::Sew_Error
538 SewFreeBorders(SMESH::smIdType FirstNodeID1,
539 SMESH::smIdType SecondNodeID1,
540 SMESH::smIdType LastNodeID1,
541 SMESH::smIdType FirstNodeID2,
542 SMESH::smIdType SecondNodeID2,
543 SMESH::smIdType LastNodeID2,
544 CORBA::Boolean CreatePolygons,
545 CORBA::Boolean CreatePolyedrs);
546 SMESH::SMESH_MeshEditor::Sew_Error
547 SewConformFreeBorders(SMESH::smIdType FirstNodeID1,
548 SMESH::smIdType SecondNodeID1,
549 SMESH::smIdType LastNodeID1,
550 SMESH::smIdType FirstNodeID2,
551 SMESH::smIdType SecondNodeID2);
552 SMESH::SMESH_MeshEditor::Sew_Error
553 SewBorderToSide(SMESH::smIdType FirstNodeIDOnFreeBorder,
554 SMESH::smIdType SecondNodeIDOnFreeBorder,
555 SMESH::smIdType LastNodeIDOnFreeBorder,
556 SMESH::smIdType FirstNodeIDOnSide,
557 SMESH::smIdType LastNodeIDOnSide,
558 CORBA::Boolean CreatePolygons,
559 CORBA::Boolean CreatePolyedrs);
560 SMESH::SMESH_MeshEditor::Sew_Error
561 SewSideElements(const SMESH::smIdType_array& IDsOfSide1Elements,
562 const SMESH::smIdType_array& IDsOfSide2Elements,
563 SMESH::smIdType NodeID1OfSide1ToMerge,
564 SMESH::smIdType NodeID1OfSide2ToMerge,
565 SMESH::smIdType NodeID2OfSide1ToMerge,
566 SMESH::smIdType NodeID2OfSide2ToMerge);
569 * Set new nodes for given element.
570 * If number of nodes is not corresponded to type of
571 * element - returns false
573 CORBA::Boolean ChangeElemNodes(SMESH::smIdType ide, const SMESH::smIdType_array& newIDs);
575 SMESH::SMESH_Group_ptr DoubleElements(SMESH::SMESH_IDSource_ptr theElements,
576 const char* theGroupName);
578 CORBA::Boolean DoubleNodes( const SMESH::smIdType_array& theNodes,
579 const SMESH::smIdType_array& theModifiedElems );
581 CORBA::Boolean DoubleNode( SMESH::smIdType theNodeId,
582 const SMESH::smIdType_array& theModifiedElems );
584 CORBA::Boolean DoubleNodeGroup( SMESH::SMESH_GroupBase_ptr theNodes,
585 SMESH::SMESH_GroupBase_ptr theModifiedElems );
588 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements.
589 * Works as DoubleNodeGroup(), but returns a new group with newly created nodes.
590 * \param theNodes - group of nodes to be doubled.
591 * \param theModifiedElems - group of elements to be updated.
592 * \return a new group with newly created nodes
593 * \sa DoubleNodeGroup()
595 SMESH::SMESH_Group_ptr DoubleNodeGroupNew( SMESH::SMESH_GroupBase_ptr theNodes,
596 SMESH::SMESH_GroupBase_ptr theModifiedElems );
598 CORBA::Boolean DoubleNodeGroups( const SMESH::ListOfGroups& theNodes,
599 const SMESH::ListOfGroups& theModifiedElems );
601 SMESH::SMESH_Group_ptr DoubleNodeGroupsNew( const SMESH::ListOfGroups& theNodes,
602 const SMESH::ListOfGroups& theModifiedElems );
605 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
606 * \param theElems - the list of elements (edges or faces) to be replicated
607 * The nodes for duplication could be found from these elements
608 * \param theNodesNot - list of nodes to NOT replicate
609 * \param theAffectedElems - the list of elements (cells and edges) to which the
610 * replicated nodes should be associated to.
611 * \return TRUE if operation has been completed successfully, FALSE otherwise
612 * \sa DoubleNodeGroup(), DoubleNodeGroups()
614 CORBA::Boolean DoubleNodeElem( const SMESH::smIdType_array& theElems,
615 const SMESH::smIdType_array& theNodesNot,
616 const SMESH::smIdType_array& theAffectedElems );
619 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
620 * \param theElems - the list of elements (edges or faces) to be replicated
621 * The nodes for duplication could be found from these elements
622 * \param theNodesNot - list of nodes to NOT replicate
623 * \param theShape - shape to detect affected elements (element which geometric center
624 * located on or inside shape).
625 * The replicated nodes should be associated to affected elements.
626 * \return TRUE if operation has been completed successfully, FALSE otherwise
627 * \sa DoubleNodeGroupInRegion(), DoubleNodeGroupsInRegion()
629 CORBA::Boolean DoubleNodeElemInRegion( const SMESH::smIdType_array& theElems,
630 const SMESH::smIdType_array& theNodesNot,
631 GEOM::GEOM_Object_ptr theShape );
634 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
635 * \param theElems - group of of elements (edges or faces) to be replicated
636 * \param theNodesNot - group of nodes not to replicated
637 * \param theAffectedElems - group of elements to which the replicated nodes
638 * should be associated to.
639 * \return TRUE if operation has been completed successfully, FALSE otherwise
640 * \sa DoubleNodes(), DoubleNodeGroups(), DoubleNodeElemGroupNew()
642 CORBA::Boolean DoubleNodeElemGroup( SMESH::SMESH_GroupBase_ptr theElems,
643 SMESH::SMESH_GroupBase_ptr theNodesNot,
644 SMESH::SMESH_GroupBase_ptr theAffectedElems );
647 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
648 * Works as DoubleNodeElemGroup(), but returns a new group with newly created elements.
649 * \param theElems - group of of elements (edges or faces) to be replicated
650 * \param theNodesNot - group of nodes not to replicated
651 * \param theAffectedElems - group of elements to which the replicated nodes
652 * should be associated to.
653 * \return a new group with newly created elements
654 * \sa DoubleNodeElemGroup()
656 SMESH::SMESH_Group_ptr DoubleNodeElemGroupNew( SMESH::SMESH_GroupBase_ptr theElems,
657 SMESH::SMESH_GroupBase_ptr theNodesNot,
658 SMESH::SMESH_GroupBase_ptr theAffectedElems );
660 SMESH::ListOfGroups* DoubleNodeElemGroup2New(SMESH::SMESH_GroupBase_ptr theElems,
661 SMESH::SMESH_GroupBase_ptr theNodesNot,
662 SMESH::SMESH_GroupBase_ptr theAffectedElems,
663 CORBA::Boolean theElemGroupNeeded,
664 CORBA::Boolean theNodeGroupNeeded);
667 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
668 * \param theElems - group of of elements (edges or faces) to be replicated
669 * \param theNodesNot - group of nodes not to replicated
670 * \param theShape - shape to detect affected elements (element which geometric center
671 * located on or inside shape).
672 * The replicated nodes should be associated to affected elements.
673 * \return TRUE if operation has been completed successfully, FALSE otherwise
674 * \sa DoubleNodesInRegion(), DoubleNodeGroupsInRegion()
676 CORBA::Boolean DoubleNodeElemGroupInRegion( SMESH::SMESH_GroupBase_ptr theElems,
677 SMESH::SMESH_GroupBase_ptr theNodesNot,
678 GEOM::GEOM_Object_ptr theShape );
681 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
682 * This method provided for convenience works as DoubleNodes() described above.
683 * \param theElems - list of groups of elements (edges or faces) to be replicated
684 * \param theNodesNot - list of groups of nodes not to replicated
685 * \param theAffectedElems - group of elements to which the replicated nodes
686 * should be associated to.
687 * \return TRUE if operation has been completed successfully, FALSE otherwise
688 * \sa DoubleNodeGroup(), DoubleNodes(), DoubleNodeElemGroupsNew()
690 CORBA::Boolean DoubleNodeElemGroups( const SMESH::ListOfGroups& theElems,
691 const SMESH::ListOfGroups& theNodesNot,
692 const SMESH::ListOfGroups& theAffectedElems );
695 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
696 * Works as DoubleNodeElemGroups(), but returns a new group with newly created elements.
697 * \param theElems - list of groups of elements (edges or faces) to be replicated
698 * \param theNodesNot - list of groups of nodes not to replicated
699 * \param theAffectedElems - group of elements to which the replicated nodes
700 * should be associated to.
701 * \return a new group with newly created elements
702 * \sa DoubleNodeElemGroups()
704 SMESH::SMESH_Group_ptr DoubleNodeElemGroupsNew( const SMESH::ListOfGroups& theElems,
705 const SMESH::ListOfGroups& theNodesNot,
706 const SMESH::ListOfGroups& theAffectedElems );
708 SMESH::ListOfGroups* DoubleNodeElemGroups2New(const SMESH::ListOfGroups& theElems,
709 const SMESH::ListOfGroups& theNodesNot,
710 const SMESH::ListOfGroups& theAffectedElems,
711 CORBA::Boolean theElemGroupNeeded,
712 CORBA::Boolean theNodeGroupNeeded);
715 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
716 * This method provided for convenience works as DoubleNodes() described above.
717 * \param theElems - list of groups of elements (edges or faces) to be replicated
718 * \param theNodesNot - list of groups of nodes not to replicated
719 * \param theShape - shape to detect affected elements (element which geometric center
720 * located on or inside shape).
721 * The replicated nodes should be associated to affected elements.
722 * \return TRUE if operation has been completed successfully, FALSE otherwise
723 * \sa DoubleNodeGroupInRegion(), DoubleNodesInRegion()
725 CORBA::Boolean DoubleNodeElemGroupsInRegion( const SMESH::ListOfGroups& theElems,
726 const SMESH::ListOfGroups& theNodesNot,
727 GEOM::GEOM_Object_ptr theShape );
730 * \brief Identify the elements that will be affected by node duplication (actual duplication is not performed.
731 * This method is the first step of DoubleNodeElemGroupsInRegion.
732 * \param theElems - list of groups of elements (edges or faces) to be replicated
733 * \param theNodesNot - list of groups of nodes not to replicated
734 * \param theShape - shape to detect affected elements (element which geometric center
735 * located on or inside shape).
736 * The replicated nodes should be associated to affected elements.
737 * \return groups of affected elements
738 * \sa DoubleNodeElemGroupsInRegion()
740 SMESH::ListOfGroups* AffectedElemGroupsInRegion( const SMESH::ListOfGroups& theElems,
741 const SMESH::ListOfGroups& theNodesNot,
742 GEOM::GEOM_Object_ptr theShape );
745 * \brief Double nodes on shared faces between groups of volumes and create flat elements on demand.
746 * The list of groups must describe a partition of the mesh volumes.
747 * The nodes of the internal faces at the boundaries of the groups are doubled.
748 * In option, the internal faces are replaced by flat elements.
749 * Triangles are transformed in prisms, and quadrangles in hexahedrons.
750 * \param theDomains - list of groups of volumes
751 * \param createJointElems - if TRUE, create the elements
752 * \param onAllBoundaries - if TRUE, the nodes and elements are also create on
753 * the boundary between \a theDomains and the rest mesh
754 * \return TRUE if operation has been completed successfully, FALSE otherwise
756 CORBA::Boolean DoubleNodesOnGroupBoundaries( const SMESH::ListOfGroups& theDomains,
757 CORBA::Boolean createJointElems,
758 CORBA::Boolean onAllBoundaries );
760 * \brief Double nodes on some external faces and create flat elements.
761 * Flat elements are mainly used by some types of mechanic calculations.
763 * Each group of the list must be constituted of faces.
764 * Triangles are transformed in prisms, and quadrangles in hexahedrons.
765 * @param theGroupsOfFaces - list of groups of faces
766 * @return TRUE if operation has been completed successfully, FALSE otherwise
768 CORBA::Boolean CreateFlatElementsOnFacesGroups( const SMESH::ListOfGroups& theGroupsOfFaces );
771 * \brief identify all the elements around a geom shape, get the faces delimiting the hole
772 * Build groups of volume to remove, groups of faces to replace on the skin of the object,
773 * groups of faces to remove insidethe object, (idem edges).
774 * Build ordered list of nodes at the border of each group of faces to replace (to be used to build a geom subshape)
776 void CreateHoleSkin(CORBA::Double radius,
777 GEOM::GEOM_Object_ptr theShape,
778 const char* groupName,
779 const SMESH::double_array& theNodesCoords,
780 SMESH::array_of_long_array_out GroupsOfNodes);
783 * \brief Generated skin mesh (containing 2D cells) from 3D mesh
784 * The created 2D mesh elements based on nodes of free faces of boundary volumes
785 * \return TRUE if operation has been completed successfully, FALSE otherwise
787 CORBA::Boolean Make2DMeshFrom3D();
789 SMESH::SMESH_Mesh_ptr MakeBoundaryMesh(SMESH::SMESH_IDSource_ptr elements,
790 SMESH::Bnd_Dimension dimension,
791 const char* groupName,
792 const char* meshName,
793 CORBA::Boolean toCopyElements,
794 CORBA::Boolean toCopyMissingBondary,
795 SMESH::SMESH_Group_out group);
797 CORBA::Long MakeBoundaryElements(SMESH::Bnd_Dimension dimension,
798 const char* groupName,
799 const char* meshName,
800 CORBA::Boolean toCopyAll,
801 const SMESH::ListOfIDSources& groups,
802 SMESH::SMESH_Mesh_out mesh,
803 SMESH::SMESH_Group_out group);
806 * \brief Create a polyline consisting of 1D mesh elements each lying on a 2D element of
807 * the initial mesh. Positions of new nodes are found by cutting the mesh by the
808 * plane passing through pairs of points specified by each PolySegment structure.
809 * If there are several paths connecting a pair of points, the shortest path is
810 * selected by the module. Position of the cutting plane is defined by the two
811 * points and an optional vector lying on the plane specified by a PolySegment.
812 * By default the vector is defined by Mesh module as following. A middle point
813 * of the two given points is computed. The middle point is projected to the mesh.
814 * The vector goes from the middle point to the projection point. In case of planar
815 * mesh, the vector is normal to the mesh.
816 * \param [inout] segments - PolySegment's defining positions of cutting planes.
817 * Return the used vector and position of the middle point.
818 * \param [in] groupName - optional name of a group where created mesh segments will
821 void MakePolyLine(SMESH::ListOfPolySegments& segments,
822 const char* groupName);
825 * \brief Create a slot of given width around given 1D elements lying on a triangle mesh.
826 * The slot is constructed by cutting faces by cylindrical surfaces made
827 * around each segment. Segments are expected to be created by MakePolyLine().
828 * \return Edges located at the slot boundary
830 SMESH::ListOfEdges* MakeSlot(SMESH::SMESH_GroupBase_ptr segments,
831 CORBA::Double width);
834 private: //!< private methods
836 ::SMESH_MeshEditor& getEditor();
838 SMESHDS_Mesh * getMeshDS() { return myMesh->GetMeshDS(); }
840 MeshEditor_I::TPreviewMesh * getPreviewMesh( SMDSAbs_ElementType previewType = SMDSAbs_All );
842 void declareMeshModified( bool isReComputeSafe );
845 * \brief Clear myLastCreated* or myPreviewData
847 void initData(bool deleteSearchers=true);
850 * \brief Return groups by their IDs
852 SMESH::ListOfGroups* getGroups(const std::list<int>* groupIDs);
854 SMESH::ListOfGroups* mirror(TIDSortedElemSet & IDsOfElements,
855 const SMESH::AxisStruct & Axis,
856 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
859 ::SMESH_Mesh* TargetMesh=0);
860 SMESH::ListOfGroups* translate(TIDSortedElemSet & IDsOfElements,
861 const SMESH::DirStruct & Vector,
864 ::SMESH_Mesh* TargetMesh=0);
865 SMESH::ListOfGroups* rotate(TIDSortedElemSet & IDsOfElements,
866 const SMESH::AxisStruct & Axis,
870 ::SMESH_Mesh* TargetMesh=0);
872 SMESH::ListOfGroups* scale(SMESH::SMESH_IDSource_ptr theObject,
873 const SMESH::PointStruct& thePoint,
874 const SMESH::double_array& theScaleFact,
875 CORBA::Boolean theCopy,
877 ::SMESH_Mesh* theTargetMesh=0);
879 void convertToQuadratic(CORBA::Boolean theForce3d,
880 CORBA::Boolean theToBiQuad,
881 SMESH::SMESH_IDSource_ptr theObject = SMESH::SMESH_IDSource::_nil());
883 SMESH::SMESH_Mesh_ptr makeMesh(const char* theMeshName);
885 void dumpGroupsList(SMESH::TPythonDump & theDumpPython,
886 const SMESH::ListOfGroups * theGroupList);
888 void prepareIdSource(SMESH::SMESH_IDSource_ptr theObject);
891 enum IDSource_Error { IDSource_OK, IDSource_INVALID, IDSource_EMPTY };
893 bool idSourceToSet(SMESH::SMESH_IDSource_ptr theIDSource,
894 const SMESHDS_Mesh* theMeshDS,
895 TIDSortedElemSet& theElemSet,
896 const SMDSAbs_ElementType theType,
897 const bool emptyIfIsMesh = false,
898 IDSource_Error* error = 0);
900 void findCoincidentNodes( TIDSortedNodeSet & Nodes,
901 CORBA::Double Tolerance,
902 SMESH::array_of_long_array_out GroupsOfNodes,
903 CORBA::Boolean SeparateCornersAndMedium);
909 SMESH_Mesh_i* myMesh_i;
911 ::SMESH_MeshEditor myEditor;
913 bool myIsPreviewMode;
914 MeshEditor_I::TPreviewMesh * myPreviewMesh;
915 ::SMESH_MeshEditor * myPreviewEditor;
916 SMESH::MeshPreviewStruct_var myPreviewData;
918 // temporary IDSources