1 // Copyright (C) 2003 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
2 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
4 // This library is free software; you can redistribute it and/or
5 // modify it under the terms of the GNU Lesser General Public
6 // License as published by the Free Software Foundation; either
7 // version 2.1 of the License.
9 // This library is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 // Lesser General Public License for more details.
14 // You should have received a copy of the GNU Lesser General Public
15 // License along with this library; if not, write to the Free Software
16 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
22 // File : SMESH_Gen.idl
23 // Author : Paul RASCLE, EDF
26 #ifndef _SMESH_GEN_IDL_
27 #define _SMESH_GEN_IDL_
29 #include "SALOME_Exception.idl"
30 #include "SALOME_Component.idl"
31 #include "SALOMEDS.idl"
33 #include "GEOM_Gen.idl"
35 #include "SMESH_Mesh.idl"
36 #include "SMESH_Hypothesis.idl"
40 typedef sequence<GEOM::GEOM_Object> object_array;
41 typedef sequence<SMESH_Mesh> mesh_array;
43 interface FilterManager;
44 interface SMESH_Pattern;
47 * Hypothesis definintion error
51 Hypothesis_Status state;
56 typedef sequence<AlgoStateError> algo_error_array;
59 * Mesh computation error
64 COMPERR_BAD_INPUT_MESH, // wrong mesh on lower submesh
65 COMPERR_STD_EXCEPTION , // some std exception raised
66 COMPERR_OCC_EXCEPTION , // OCC exception raised
67 COMPERR_SLM_EXCEPTION , // SALOME exception raised
68 COMPERR_EXCEPTION , // other exception raised
69 COMPERR_MEMORY_PB , // memory allocation problem
70 COMPERR_ALGO_FAILED , // computation failed
71 COMPERR_BAD_SHAPE // bad geometry
75 short code; // ComputeErrorName or, if negative, algo specific code
76 string comment; // textual problem description
78 short subShapeID; // id of subshape of a shape to mesh
80 typedef sequence<ComputeError> compute_error_array;
83 interface SMESH_Gen : Engines::Component, SALOMEDS::Driver
86 //GEOM::GEOM_Gen SetGeomEngine( in string containerLoc );
87 void SetGeomEngine( in GEOM::GEOM_Gen geomcompo );
89 FilterManager CreateFilterManager();
91 SMESH_Pattern GetPattern();
96 void SetEmbeddedMode( in boolean theMode );
101 boolean IsEmbeddedMode();
104 Set the current study
106 void SetCurrentStudy( in SALOMEDS::Study theStudy );
109 Get the current study
111 SALOMEDS::Study GetCurrentStudy();
114 * Create a hypothesis that can be shared by differents parts of the mesh.
115 * An hypothesis is either:
116 * - a method used to generate or modify a part of the mesh (algorithm).
117 * - a parameter or a law used by an algorithm.
118 * Algorithms are 1D, 2D or 3D.
120 SMESH_Hypothesis CreateHypothesis( in string theHypName,
121 in string theLibName )
122 raises ( SALOME::SALOME_Exception );
125 * Return a hypothesis holding parameter values corresponding to the mesh
126 * existing on the given geometry.
127 * The returned hypothesis may be the one existing in a study and used
128 * to compute the mesh, or a temporary one created just to pass parameter
131 SMESH_Hypothesis GetHypothesisParameterValues( in string theHypName,
132 in string theLibName,
133 in SMESH_Mesh theMesh,
134 in GEOM::GEOM_Object theGeom)
135 raises ( SALOME::SALOME_Exception );
138 * Create a Mesh object, given a geometry shape.
139 * Mesh is created empty (no points, no elements).
140 * Shape is explored via GEOM_Client to create local copies.
141 * of TopoDS_Shapes and bind CORBA references of shape & subshapes
144 SMESH_Mesh CreateMesh( in GEOM::GEOM_Object theObject )
145 raises ( SALOME::SALOME_Exception );
148 * Create a empty mesh object
150 SMESH_Mesh CreateEmptyMesh()
151 raises ( SALOME::SALOME_Exception );
154 * Create Mesh object importing data from given UNV file
155 * (UNV supported version is I-DEAS 10)
157 SMESH_Mesh CreateMeshesFromUNV( in string theFileName )
158 raises ( SALOME::SALOME_Exception );
161 * Create Mesh object(s) importing data from given MED file
163 mesh_array CreateMeshesFromMED( in string theFileName,
164 out SMESH::DriverMED_ReadStatus theStatus )
165 raises ( SALOME::SALOME_Exception );
168 * Create Mesh object importing data from given STL file
170 SMESH_Mesh CreateMeshesFromSTL( in string theFileName )
171 raises ( SALOME::SALOME_Exception );
174 * Create a Mesh object, without a geometry shape reference
176 // SMESH_Mesh NewEmpty()
177 // raises ( SALOME::SALOME_Exception );
181 * First, verify list of hypothesis associated with the subShape,
182 * return NOK if hypothesis are not sufficient
184 boolean Compute( in SMESH_Mesh theMesh,
185 in GEOM::GEOM_Object theSubObject )
186 raises ( SALOME::SALOME_Exception );
189 * Return true if hypotheses are defined well
191 boolean IsReadyToCompute( in SMESH_Mesh theMesh,
192 in GEOM::GEOM_Object theSubObject )
193 raises ( SALOME::SALOME_Exception );
196 * Return errors of hypotheses definintion
197 * algo_error_array is empty if everything is OK
199 algo_error_array GetAlgoState( in SMESH_Mesh theMesh,
200 in GEOM::GEOM_Object theSubObject )
201 raises ( SALOME::SALOME_Exception );
204 * Return errors of mesh computation
205 * compute_error_array is empty if everything is OK
207 compute_error_array GetComputeErrors( in SMESH_Mesh theMesh,
208 in GEOM::GEOM_Object theSubObject )
209 raises ( SALOME::SALOME_Exception );
212 * Return indeces of faces, edges and vertices of given subshapes
213 * within theMainObject
215 long_array GetSubShapesId( in GEOM::GEOM_Object theMainObject,
216 in object_array theListOfSubObjects )
217 raises ( SALOME::SALOME_Exception );
220 * Return geometrical object the given element is built on.
221 * The returned geometrical object, if not nil, is either found in the
222 * study or is published by this method with the given name
224 GEOM::GEOM_Object GetGeometryByMeshElement( in SMESH_Mesh theMesh,
225 in long theElementID,
226 in string theGeomName)
227 raises ( SALOME::SALOME_Exception );
230 * Return geometrical object the given element is built on.
231 * The returned geometrical object not published in study by this method.
233 GEOM::GEOM_Object FindGeometryByMeshElement( in SMESH_Mesh theMesh,
234 in long theElementID)
235 raises ( SALOME::SALOME_Exception );
238 * Concatenate the given meshes into one mesh.
239 * Union groups with the same name and type if
240 * theUniteIdenticalGroups flag is true.
241 * Merge coincident nodes and elements if
242 * theMergeNodesAndElements flag is true.
244 SMESH_Mesh Concatenate(in mesh_array theMeshesArray,
245 in boolean theUniteIdenticalGroups,
246 in boolean theMergeNodesAndElements,
247 in double theMergeTolerance)
248 raises ( SALOME::SALOME_Exception );