]> SALOME platform Git repositories - modules/smesh.git/blob - idl/SMESH_Gen.idl
Salome HOME
protect GetSubShapeByNode() from SIGSEGV at NULL node
[modules/smesh.git] / idl / SMESH_Gen.idl
1 // Copyright (C) 2007-2012  CEA/DEN, EDF R&D, OPEN CASCADE
2 //
3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
5 //
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.
10 //
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.
15 //
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
19 //
20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21 //
22 //  File   : SMESH_Gen.idl
23 //  Author : Paul RASCLE, EDF
24
25 #ifndef _SMESH_GEN_IDL_
26 #define _SMESH_GEN_IDL_
27
28 #include "SALOME_Exception.idl"
29 #include "SALOME_Component.idl"
30 #include "SALOMEDS.idl"
31
32 #include "GEOM_Gen.idl"
33
34 #include "SMESH_Mesh.idl"
35 #include "SMESH_Hypothesis.idl"
36
37 module SMESH
38 {
39   typedef sequence<GEOM::GEOM_Object> object_array;
40   typedef sequence<SMESH_Mesh>        mesh_array;
41
42   interface FilterManager;
43   interface SMESH_Pattern;
44   interface Measurements;
45
46   /*!
47    * Tags definition
48    */
49   // Top level
50   const long Tag_HypothesisRoot = 1; // hypotheses root
51   const long Tag_AlgorithmsRoot = 2; // algorithms root
52   const long Tag_FirstMeshRoot  = 3; // first mesh root
53   // Mesh/Submesh
54   const long Tag_RefOnShape             = 1; // references to shape
55   const long Tag_RefOnAppliedHypothesis = 2; // applied hypotheses root
56   const long Tag_RefOnAppliedAlgorithms = 3; // applied algorithms root
57   // Mesh only: sub-meshes roots by type
58   const long Tag_FirstSubMesh           =  4;
59   const long Tag_SubMeshOnVertex        =  4;
60   const long Tag_SubMeshOnEdge          =  5;
61   const long Tag_SubMeshOnWire          =  6;
62   const long Tag_SubMeshOnFace          =  7;
63   const long Tag_SubMeshOnShell         =  8;
64   const long Tag_SubMeshOnSolid         =  9;
65   const long Tag_SubMeshOnCompound      = 10;
66   const long Tag_LastSubMesh            = 10;
67   // Mesh only: group roots by type
68   const long Tag_FirstGroup             = 11;
69   const long Tag_NodeGroups             = 11;
70   const long Tag_EdgeGroups             = 12;
71   const long Tag_FaceGroups             = 13;
72   const long Tag_VolumeGroups           = 14;
73   const long Tag_0DElementsGroups       = 15;
74   const long Tag_BallElementsGroups     = 16;
75   const long Tag_LastGroup              = 16;
76
77   /*!
78    * Hypothesis definintion error
79    */
80   struct AlgoStateError
81   {
82     Hypothesis_Status  state;
83     string             algoName;
84     long               algoDim;
85     boolean            isGlobalAlgo;
86   };
87   typedef sequence<AlgoStateError> algo_error_array;
88
89   /*!
90    * Mesh computation error
91    */
92   enum ComputeErrorName
93   {
94     COMPERR_OK            ,
95     COMPERR_BAD_INPUT_MESH,  // wrong mesh on lower submesh
96     COMPERR_STD_EXCEPTION ,  // some std exception raised
97     COMPERR_OCC_EXCEPTION ,  // OCC exception raised
98     COMPERR_SLM_EXCEPTION ,  // SALOME exception raised
99     COMPERR_EXCEPTION     ,  // other exception raised
100     COMPERR_MEMORY_PB     ,  // memory allocation problem
101     COMPERR_ALGO_FAILED   ,  // computation failed
102     COMPERR_BAD_SHAPE     ,  // bad geometry
103     COMPERR_WARNING       ,  // algo reports error but sub-mesh is computed anyway
104     COMPERR_CANCELED      ,  // compute canceled
105     COMPERR_NO_MESH_ON_SHAPE // no mesh elements assigned to sub-mesh
106   };
107   struct ComputeError
108   {
109     short   code;       // ComputeErrorName or, if negative, algo specific code
110     string  comment;    // textual problem description
111     string  algoName;
112     short   subShapeID; // id of sub-shape of a shape to mesh
113     boolean hasBadMesh; // there are elements preventing computation available for visualization
114   };
115   typedef sequence<ComputeError> compute_error_array;
116
117
118   interface SMESH_Gen : Engines::EngineComponent, SALOMEDS::Driver
119   {
120     //GEOM::GEOM_Gen SetGeomEngine( in string containerLoc );
121     void SetGeomEngine( in GEOM::GEOM_Gen geomcompo );
122
123     FilterManager CreateFilterManager();
124
125     SMESH_Pattern GetPattern();
126
127     Measurements  CreateMeasurements();
128
129     /*!
130       Set the current mode
131      */
132     void SetEmbeddedMode( in boolean theMode );
133
134     /*!
135       Get the current mode
136      */
137     boolean IsEmbeddedMode();
138
139     /*!
140       Set the current study
141      */
142     void SetCurrentStudy( in SALOMEDS::Study theStudy );
143
144     /*!
145       Get the current study
146      */
147     SALOMEDS::Study GetCurrentStudy();
148
149     /*!
150      * Create a hypothesis that can be shared by differents parts of the mesh.
151      * An hypothesis is either:
152      * - a method used to generate or modify a part of the mesh (algorithm).
153      * - a parameter or a law used by an algorithm.
154      * Algorithms are 1D, 2D or 3D.
155      */
156     SMESH_Hypothesis CreateHypothesis( in string theHypName,
157                                        in string theLibName )
158       raises ( SALOME::SALOME_Exception );
159
160     /*!
161      * Return a hypothesis holding parameter values corresponding either to the mesh
162      * existing on the given geometry or to size of the geometry.
163      * The returned hypothesis may be the one existing in a study and used
164      * to compute the mesh, or a temporary one created just to pass parameter
165      * values.
166      */
167     SMESH_Hypothesis GetHypothesisParameterValues( in string            theHypName,
168                                                    in string            theLibName,
169                                                    in SMESH_Mesh        theMesh,
170                                                    in GEOM::GEOM_Object theGeom,
171                                                    in boolean           byMesh)
172       raises ( SALOME::SALOME_Exception );
173
174     /*!
175      * Sets number of segments per diagonal of boundary box of geometry by which
176      * default segment length of appropriate 1D hypotheses is defined
177      */
178     void SetBoundaryBoxSegmentation( in long theNbSegments ) raises ( SALOME::SALOME_Exception );
179     /*!
180      * \brief Sets default number of segments per edge
181      */
182     void SetDefaultNbSegments( in long theNbSegments) raises ( SALOME::SALOME_Exception );
183
184     /*!
185      * Set the object name
186      */
187     void SetName( in string theObjectIOR,
188                   in string theObjectName )
189       raises ( SALOME::SALOME_Exception );
190
191     /*!
192      * Create a Mesh object, given a geometry shape.
193      * Mesh is created empty (no points, no elements).
194      * Shape is explored via GEOM_Client to create local copies.
195      * of TopoDS_Shapes and bind CORBA references of shape & subshapes
196      * with TopoDS_Shapes
197      */
198     SMESH_Mesh CreateMesh( in GEOM::GEOM_Object theObject )
199       raises ( SALOME::SALOME_Exception );
200
201     /*!
202      * Create an empty mesh object
203      */
204     SMESH_Mesh CreateEmptyMesh()
205       raises ( SALOME::SALOME_Exception );
206
207     /*!
208      * Create Mesh object importing data from given UNV file
209      * (UNV supported version is I-DEAS 10)
210      */
211     SMESH_Mesh CreateMeshesFromUNV( in string theFileName )
212       raises ( SALOME::SALOME_Exception );
213
214     /*!
215      * Create Mesh object(s) importing data from given MED file
216      */
217      mesh_array CreateMeshesFromMED( in string theFileName,
218                                      out SMESH::DriverMED_ReadStatus theStatus )
219        raises ( SALOME::SALOME_Exception );
220
221     /*!
222      * Create Mesh object(s) importing data from given MED file
223      */
224      mesh_array CreateMeshesFromSAUV( in string theFileName,
225                                       out SMESH::DriverMED_ReadStatus theStatus )
226        raises ( SALOME::SALOME_Exception );
227
228     /*!
229      * Create Mesh object importing data from given STL file
230      */
231     SMESH_Mesh CreateMeshesFromSTL( in string theFileName )
232       raises ( SALOME::SALOME_Exception );
233
234     /*!
235      * Create Mesh object(s) importing data from given CGNS file
236      */
237     mesh_array CreateMeshesFromCGNS( in string theFileName,
238                                      out SMESH::DriverMED_ReadStatus theStatus )
239       raises ( SALOME::SALOME_Exception );
240
241     /*!
242      * Create Mesh object importing data from given GMF file
243      */
244     SMESH_Mesh CreateMeshesFromGMF( in string               theFileName,
245                                     out SMESH::ComputeError theError)
246       raises ( SALOME::SALOME_Exception );
247
248     /*!
249      * Create a mesh by copying a part of another mesh
250      *  \param meshPart - a part of mesh to copy
251      *  \param meshName - a name of the new mesh
252      *  \param toCopyGroups - to create in the new mesh groups
253      *                        the copied elements belongs to
254      *  \param toKeepIDs - to preserve IDs of the copied elements or not
255      */
256     SMESH_Mesh CopyMesh(in SMESH_IDSource meshPart,
257                         in string         meshName,
258                         in boolean        toCopyGroups,
259                         in boolean        toKeepIDs)
260       raises ( SALOME::SALOME_Exception );
261
262     /*!
263      * Concatenate the given meshes into one mesh.
264      * Union groups with the same name and type if
265      * theUniteIdenticalGroups flag is true.
266      * Merge coincident nodes and elements if
267      * theMergeNodesAndElements flag is true.
268      */
269     SMESH_Mesh Concatenate(in mesh_array theMeshesArray,
270                            in boolean    theUniteIdenticalGroups,
271                            in boolean    theMergeNodesAndElements,
272                            in double     theMergeTolerance)
273       raises ( SALOME::SALOME_Exception );
274
275     /*!
276      * Concatenate the given meshes into one mesh.
277      * Union groups with the same name and type if
278      * theUniteIdenticalGroups flag is true.
279      * Merge coincident nodes and elements if
280      * theMergeNodesAndElements flag is true.
281      * Create the groups of all elements from initial meshes.
282      */
283     SMESH_Mesh ConcatenateWithGroups(in mesh_array theMeshesArray,
284                                      in boolean    theUniteIdenticalGroups,
285                                      in boolean    theMergeNodesAndElements,
286                                      in double     theMergeTolerance)
287       raises ( SALOME::SALOME_Exception );
288
289     /*!
290      * Mesh a subShape.
291      * First, verify list of hypothesis associated with the Sub-shape,
292      * return NOK if hypothesis are not sufficient
293      */
294     boolean Compute( in SMESH_Mesh        theMesh,
295                      in GEOM::GEOM_Object theSubObject )
296       raises ( SALOME::SALOME_Exception );
297
298     /*!
299      * Cancel a computation.
300      */
301     void CancelCompute( in SMESH_Mesh        theMesh,
302                         in GEOM::GEOM_Object theSubObject );
303
304     /*!
305      * Return true if hypotheses are defined well
306      */
307     boolean IsReadyToCompute( in SMESH_Mesh        theMesh,
308                               in GEOM::GEOM_Object theSubObject )
309       raises ( SALOME::SALOME_Exception );
310
311     /*!
312      * Evaluates size of prospective mesh on a shape
313      */
314     long_array  Evaluate(in SMESH_Mesh        theMesh,
315                          in GEOM::GEOM_Object theSubObject)
316       raises ( SALOME::SALOME_Exception );
317
318     /*!
319      * Calculate Mesh as preview till indicated dimension
320      * First, verify list of hypothesis associated with the Sub-shape.
321      * Return mesh preview structure
322      */
323     MeshPreviewStruct Precompute( in SMESH_Mesh        theMesh,
324                                   in GEOM::GEOM_Object theSubObject,
325                                   in Dimension         theDimension,
326                                   inout long_array    theShapesId )
327       raises ( SALOME::SALOME_Exception );
328
329     /*!
330      * Return errors of hypotheses definintion
331      * algo_error_array is empty if everything is OK
332      */
333     algo_error_array GetAlgoState( in SMESH_Mesh        theMesh,
334                                    in GEOM::GEOM_Object theSubObject )
335       raises ( SALOME::SALOME_Exception );
336
337     /*!
338      * Return errors of mesh computation
339      * compute_error_array is empty if everything is OK
340      */
341     compute_error_array GetComputeErrors( in SMESH_Mesh        theMesh,
342                                           in GEOM::GEOM_Object theSubObject )
343       raises ( SALOME::SALOME_Exception );
344
345     /*!
346      * Return mesh elements preventing computation of a sub-shape
347      */
348     MeshPreviewStruct GetBadInputElements( in SMESH_Mesh theMesh,
349                                            in short      theSubShapeID )
350       raises ( SALOME::SALOME_Exception );
351
352     /*!
353      * Return indeces of faces, edges and vertices of given sub-shapes
354      * within theMainObject
355      */
356     long_array GetSubShapesId( in GEOM::GEOM_Object theMainObject,
357                                in object_array      theListOfSubObjects )
358        raises ( SALOME::SALOME_Exception );
359
360     /*!
361      * Return geometrical object the given element is built on.
362      * The returned geometrical object, if not nil, is either found in the
363      * study or is published by this method with the given name
364      */
365     GEOM::GEOM_Object GetGeometryByMeshElement( in SMESH_Mesh  theMesh,
366                                                 in long        theElementID,
367                                                 in string      theGeomName)
368       raises ( SALOME::SALOME_Exception );
369
370     /*!
371      * Return geometrical object the given element is built on.
372      * The returned geometrical object not published in study by this method.
373      */
374     GEOM::GEOM_Object FindGeometryByMeshElement( in SMESH_Mesh  theMesh,
375                                                  in long        theElementID)
376       raises ( SALOME::SALOME_Exception );
377
378     /*!
379      * \brief Return id of object, registered in current study context
380      *
381      * Can be used to check if the object was created in the same container, as this engine.
382      */
383     long GetObjectId(in Object theObject);
384
385     /*!
386      * \brief Get MED version of the file by its name.
387      */
388     boolean GetMEDVersion(in string theFileName, out MED_VERSION theVersion);
389
390     /*!
391      * \brief Get names of meshes defined in file with the specified name.
392      */
393     string_array GetMeshNames(in string theFileName);
394   };
395
396 };
397
398 #endif