idl/BLSURFPlugin_Algorithm.idl

   1 // Copyright (C) 2007-2015  CEA/DEN, EDF R&D
   2 //
   3 // This library is free software; you can redistribute it and/or
   4 // modify it under the terms of the GNU Lesser General Public
   5 // License as published by the Free Software Foundation; either
   6 // version 2.1 of the License, or (at your option) any later version.
   7 //
   8 // This library is distributed in the hope that it will be useful,
   9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11 // Lesser General Public License for more details.
  12 //
  13 // You should have received a copy of the GNU Lesser General Public
  14 // License along with this library; if not, write to the Free Software
  15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  16 //
  17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  18 //
  19
  20 // ---
  21 // File    : BLSURFPlugin_Algorithm.idl
  22 // Authors : Francis KLOSS (OCC) & Patrick LAUG (INRIA) & Lioka RAZAFINDRAZAKA (CEA)
  23 //           Size maps developement: Nicolas GEIMER (OCC) & Gilles DAVID (EURIWARE)
  24 // ---
  25 //
  26 #ifndef _SMESH_BLSURFALGORITHM_IDL_
  27 #define _SMESH_BLSURFALGORITHM_IDL_
  28
  29 #include "SMESH_Hypothesis.idl"
  30 #include "GEOM_Gen.idl"
  31 #include "SALOME_Exception.idl"
  32
  33 /*!
  34  * BLSURFPlugin: interfaces to BLSURF related hypotheses and algorithms
  35  */
  36 module BLSURFPlugin
  37 {
  38   typedef sequence<string> string_array;
  39
  40   // Enforced vertex name
  41   typedef string TEnfName;
  42   // Entry
  43   typedef string TEntry;
  44   typedef sequence<TEntry> TEntryList;
  45   // Group name
  46   typedef string TEnfGroupName;
  47
  48   // Coordinates of enforced vertex
  49   typedef sequence<double,3> TEnfVertexCoords;
  50   // List of coords
  51   typedef sequence<TEnfVertexCoords> TEnfVertexCoordsList;
  52
  53   // Enforced vertex
  54   struct TEnfVertex {
  55     TEnfName name;
  56     TEntry geomEntry;
  57     TEnfVertexCoords coords;
  58     TEnfGroupName grpName;
  59     TEntryList faceEntries;
  60   };
  61   // List of enforced vertices
  62   typedef sequence<TEnfVertex> TEnfVertexList;
  63
  64   // Map Face Entry / List of enforced vertices
  65   struct TFaceEntryEnfVertexListMapElement {
  66     TEntry faceEntry;
  67     TEnfVertexList enfVertexList;
  68   };
  69   typedef sequence<TFaceEntryEnfVertexListMapElement> TFaceEntryEnfVertexListMap;
  70
  71   // Map Face Entry / List of coords
  72   struct TFaceEntryCoordsListMapElement {
  73     TEntry faceEntry;
  74     TEnfVertexCoordsList coordsList;
  75   };
  76   typedef sequence<TFaceEntryCoordsListMapElement> TFaceEntryCoordsListMap;
  77
  78   // Map Face Entry / List of enf vertex entries
  79   struct TFaceEntryEnfVertexEntryListMapElement {
  80     TEntry faceEntry;
  81     TEntryList enfVertexEntryList;
  82   };
  83   typedef sequence<TFaceEntryEnfVertexEntryListMapElement> TFaceEntryEnfVertexEntryListMap;
  84
  85   // Map Coords / Enforced vertex
  86   struct TCoordsEnfVertexElement {
  87     TEnfVertexCoords coords;
  88     TEnfVertex enfVertex;
  89   };
  90   typedef sequence<TCoordsEnfVertexElement> TCoordsEnfVertexMap;
  91
  92   // Map Enf Vertex Entry / Enforced vertex
  93   struct TEnfVertexEntryEnfVertexElement {
  94     TEntry enfVertexEntry;
  95     TEnfVertex enfVertex;
  96   };
  97   typedef sequence<TEnfVertexEntryEnfVertexElement> TEnfVertexEntryEnfVertexMap;
  98
  99   // List of Face Entry with internal enforced vertices activated
 100   typedef sequence<TEntry> TFaceEntryInternalVerticesList;
 101
 102   // Attractors
 103   struct TAttractorParams {
 104     string faceEntry;
 105     string attEntry;
 106     double startSize;
 107     double endSize;
 108     double infDist;
 109     double constDist;
 110   };
 111   typedef sequence<TAttractorParams> TAttParamsMap;
 112
 113   // Periodicity
 114   struct TPreCadPeriodicity {
 115     TEntry shape1Entry;
 116     TEntry shape2Entry;
 117     TEntryList theSourceVerticesEntries;
 118     TEntryList theTargetVerticesEntries;
 119   };
 120
 121   typedef sequence<TPreCadPeriodicity> TPeriodicityList;
 122
 123   /*!
 124    * BLSURFPlugin_BLSURF: interface of BLSURF algorithm
 125    */
 126   interface BLSURFPlugin_BLSURF : SMESH::SMESH_2D_Algo
 127   {
 128   };
 129
 130   /*!
 131    * BLSURFPlugin_Hypothesis: interface of "BLSURF parameters" hypothesis
 132    */
 133   interface BLSURFPlugin_Hypothesis : SMESH::SMESH_Hypothesis
 134   {
 135
 136     /*!
 137      * Sets a way to define size of mesh elements to generate
 138      * 0 - size is defined automatically
 139      * 1 - size is set by SetPhySize() method
 140      * 2 - size is set by SetPhySize() method. A sizemap is defined.
 141      */
 142     void SetPhysicalMesh(in long isCustom);
 143     long GetPhysicalMesh();
 144
 145     /*!
 146      * Sets a way to define maximum angular deflection of mesh from CAD model
 147      * 0 - deflection is defined automatically
 148      * 1 - deflection is set by SetAngleMesh() method
 149      * 2 - deflection is set by SetAngleMesh() method. A sizemap is defined (TODO).
 150      */
 151     void SetGeometricMesh(in long isCustom);
 152     long GetGeometricMesh();
 153
 154     /*!
 155      * Sets size of mesh elements to generate
 156      */
 157     void SetPhySize(in double size);
 158     void SetPhySizeRel(in double size);
 159     double GetPhySize();
 160     boolean IsPhySizeRel();
 161
 162     /*!
 163      * Sets lower boundary of mesh element size
 164      */
 165     void SetMinSize(in double theMinSize);
 166     void SetMinSizeRel(in double theMinSize);
 167     double GetMinSize();
 168     boolean IsMinSizeRel();
 169
 170     /*!
 171      * Sets upper boundary of mesh element size
 172      */
 173     void SetMaxSize(in double theMaxSize);
 174     void SetMaxSizeRel(in double theMaxSize);
 175     double GetMaxSize();
 176     boolean IsMaxSizeRel();
 177
 178     /*!
 179      * Sets maximal allowed ratio between the lengths of two adjacent edges
 180      */
 181     void SetGradation(in double ratio);
 182     double GetGradation();
 183
 184     /*!
 185      * Sets to create quadrilateral elements or not
 186      */
 187     void SetQuadAllowed(in boolean allowed);
 188     boolean GetQuadAllowed();
 189
 190     /*!
 191      * Sets angular deflection (in degrees) of a mesh face and edge from CAD surface
 192      */
 193     void SetAngleMesh(in double angle);
 194     double GetAngleMesh();
 195
 196     /*!
 197      * Sets the maximum desired distance between a triangle and its supporting CAD surface
 198      */
 199     void SetChordalError(in double distance);
 200     double GetChordalError();
 201
 202     /*!
 203      * Determines whether the generated mesh will be isotropic or anisotropic
 204      */
 205     void SetAnisotropic(in boolean anisotropic);
 206     boolean GetAnisotropic();
 207
 208     /*!
 209      * Defines the maximum anisotropic ratio of the metric governing the anisotropic process.
 210      * The default value of 0 means that the metric (and thus the generated elements)
 211      * can be arbitrarily stretched.
 212      */
 213     void SetAnisotropicRatio(in double ratio);
 214     double GetAnisotropicRatio();
 215
 216     /*!
 217      * This patch-independent correction option can be activated to remove the tiny
 218      * (nano) edges from the generated mesh, without taking into account the tags
 219      * (attributes) specifications.
 220      */
 221     void SetRemoveTinyEdges(in boolean remove);
 222     boolean GetRemoveTinyEdges();
 223
 224     /*!
 225      * Defines the minimal length under which an edge is considered to be a tiny one
 226      */
 227     void SetTinyEdgeLength(in double length);
 228     double GetTinyEdgeLength();
 229
 230     /*!
 231      * This patch independent correction option can be activated to remove the bad
 232      * elements (often called slivers) from the generated mesh, without taking into account
 233      * the tags (attributes) specification.
 234      */
 235     void SetBadElementRemoval(in boolean remove);
 236     boolean GetBadElementRemoval();
 237
 238     /*!
 239      * This parameter defines the aspect ratio triggering the "bad element"
 240      * classification for the force bad surface element removal option.
 241      */
 242     void SetBadElementAspectRatio(in double ratio);
 243     double GetBadElementAspectRatio();
 244
 245     /*!
 246      * If this option is activated, MeshGems-CADSurf will optimize the mesh in order to
 247      * get better shaped elements, during a process which respects the patch independent options.
 248      * This optimisation cannot be fully performed when correct_surface_intersections = 1.
 249      */
 250     void SetOptimizeMesh(in boolean optimize);
 251     boolean GetOptimizeMesh();
 252
 253     /*!
 254      * Determines the order of mesh elements to be generated (linear or quadratic)
 255      */
 256     void SetQuadraticMesh(in boolean quadratic);
 257     boolean GetQuadraticMesh();
 258
 259     /*!
 260      * Sets topology usage way defining how mesh conformity is assured
 261      * value=0 - mesh conformity is assured by conformity of a shape
 262      * value=1,2 - mesh conformity is assured by pre-processing a CAD model (OBSOLETE)
 263      * value=3 - mesh conformity is assured by pre-processing a CAD model with Pre-CAD
 264      */
 265     void SetTopology(in long way);
 266     long GetTopology();
 267
 268     /*!
 269      * Sets verbosity level in the range 0 to 100.
 270      */
 271     void SetVerbosity(in short theVal) raises (SALOME::SALOME_Exception);
 272     short GetVerbosity();
 273
 274     /*!
 275      * To merges edges.
 276      */
 277     void SetPreCADMergeEdges(in boolean toMergeEdges);
 278     boolean GetPreCADMergeEdges();
 279
 280     /*!
 281      * To process 3D topology.
 282      */
 283     void SetPreCADProcess3DTopology(in boolean toProcess);
 284     boolean GetPreCADProcess3DTopology();
 285
 286
 287     /*!
 288      * To compute topology from scratch
 289      */
 290     void SetPreCADDiscardInput(in boolean toDiscardInput);
 291     boolean GetPreCADDiscardInput();
 292
 293     /*!
 294      * Sets advanced option value
 295      */
 296     void SetOptionValue(in string optionName,
 297                         in string optionValue) raises (SALOME::SALOME_Exception);
 298     void SetPreCADOptionValue(in string optionName,
 299                         in string optionValue) raises (SALOME::SALOME_Exception);
 300     string GetOptionValue(in string optionName) raises (SALOME::SALOME_Exception);
 301     string GetPreCADOptionValue(in string optionName) raises (SALOME::SALOME_Exception);
 302     /*!
 303      * Unsets advanced option
 304      */
 305     void UnsetOption(in string optionName);
 306     void UnsetPreCADOption(in string optionName);
 307
 308     /*!
 309      * Return array of strings each of which is option name concatenated
 310      * with option value devided by semicolon - "option_name:option_value".
 311      * Option value is empty if an option is not set.
 312      * Note: the method is mostly for interaction with GUI.
 313      */
 314     string_array GetOptionValues();
 315     string_array GetPreCADOptionValues();
 316
 317     /*!
 318      * Set option values each in the form "option_name[:option_value]".
 319      * Note: the method is mostly for interaction with GUI.
 320      */
 321     void SetOptionValues(in string_array options) raises (SALOME::SALOME_Exception);
 322     void SetPreCADOptionValues(in string_array options) raises (SALOME::SALOME_Exception);
 323
 324     /*!
 325      * SizeMap
 326      */
 327     void SetSizeMapEntries(in string_array sizeMaps) raises (SALOME::SALOME_Exception);
 328     void ClearSizeMaps();
 329
 330     void UnsetEntry(in string entry);
 331
 332     /*!
 333      * Set/unset a SizeMap on geom object
 334      */
 335     void         SetSizeMap(in GEOM::GEOM_Object GeomObj, in string sizeMap) raises (SALOME::SALOME_Exception);
 336     void         SetConstantSizeMap(in GEOM::GEOM_Object GeomObj, in double sizeMap);
 337     void         UnsetSizeMap(in GEOM::GEOM_Object GeomObj);
 338
 339     /*!
 340      * Set a SizeMap on geom object given by entry
 341      */
 342     void         SetSizeMapEntry(in string entry, in string sizeMap) raises (SALOME::SALOME_Exception);
 343     void         SetConstantSizeMapEntry(in string entry, in GEOM::shape_type shapeType, in double sizeMap) raises (SALOME::SALOME_Exception);
 344     string       GetSizeMapEntry(in string entry) raises (SALOME::SALOME_Exception);
 345     string_array GetSizeMapEntries();
 346
 347     /*!
 348      * Set/unset an attractor on geom object
 349      */
 350     void         SetAttractor(in GEOM::GEOM_Object GeomObj, in string attractor);
 351     void         UnsetAttractor(in GEOM::GEOM_Object GeomObj);
 352
 353     /*!
 354      * Set an attractor on geom object given by entry
 355      */
 356     void         SetAttractorEntry(in string entry, in string attractor) raises (SALOME::SALOME_Exception);
 357     string       GetAttractorEntry(in string entry) raises (SALOME::SALOME_Exception);
 358     string_array GetAttractorEntries();
 359
 360     /*!
 361      * Set/unset an attractor given as geom object on another geom object
 362      */
 363     void         SetAttractorGeom(in GEOM::GEOM_Object GeomObj, in GEOM::GEOM_Object AttractorShape, in double StartSize, in double EndSize, in double ActionRadius, in double ConstantRadius);
 364     void         UnsetAttractorGeom(in GEOM::GEOM_Object GeomObj, in GEOM::GEOM_Object AttractorShape);
 365     void         UnsetAttractorEntry(in string entry, in string attractor);
 366
 367     /*!
 368      * Set an attractor given by entry on a geom object given by entry
 369      */
 370     void         SetClassAttractorEntry(in string entry, in string att_entry, in double StartSize, in double EndSize, in double ActionRadius, in double ConstantRadius ) raises (SALOME::SALOME_Exception);
 371     BLSURFPlugin::TAttParamsMap GetAttractorParams();
 372
 373 /*
 374     void         SetCustomSizeMapEntry(in string entry, in string sizeMap);
 375     string       GetCustomSizeMapEntry(in string entry);
 376     void         SetCustomSizeMap(in GEOM::GEOM_Object GeomObj, in string sizeMap);
 377     void         UnsetCustomSizeMap(in GEOM::GEOM_Object GeomObj);
 378     string_array GetCustomSizeMapEntries();
 379 */
 380     ///////////////////////
 381     // ENFORCED VERTEXES //
 382     ///////////////////////
 383
 384     TFaceEntryEnfVertexListMap      GetAllEnforcedVerticesByFace();
 385     TEnfVertexList                  GetAllEnforcedVertices();
 386
 387     TFaceEntryCoordsListMap         GetAllCoordsByFace();
 388     TCoordsEnfVertexMap             GetAllEnforcedVerticesByCoords();
 389
 390     TFaceEntryEnfVertexEntryListMap GetAllEnfVertexEntriesByFace();
 391     TEnfVertexEntryEnfVertexMap     GetAllEnforcedVerticesByEnfVertexEntry();
 392
 393     void                            ClearAllEnforcedVertices();
 394
 395    /*!
 396     * Set/get/unset an enforced vertex on geom face
 397     */
 398     boolean SetEnforcedVertex(in GEOM::GEOM_Object theFace, in double x, in double y, in double z) raises (SALOME::SALOME_Exception);
 399     boolean SetEnforcedVertexNamed(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfName theVertexName) raises (SALOME::SALOME_Exception);
 400     boolean SetEnforcedVertexGeom(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex) raises (SALOME::SALOME_Exception);
 401     boolean SetEnforcedVertexWithGroup(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 402     boolean SetEnforcedVertexNamedWithGroup(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfName theVertexName, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 403     boolean SetEnforcedVertexGeomWithGroup(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 404
 405
 406     TEnfVertexList GetEnforcedVertices(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
 407
 408     boolean UnsetEnforcedVertex(in GEOM::GEOM_Object theFace, in double x, in double y, in double z) raises (SALOME::SALOME_Exception);
 409     boolean UnsetEnforcedVertexGeom(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex) raises (SALOME::SALOME_Exception);
 410     boolean UnsetEnforcedVertices(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
 411
 412    /*!
 413     * Set/get/unset an enforced vertex on geom face given by entry
 414     */
 415     boolean SetEnforcedVertexEntry(in TEntry theFaceEntry, in double x, in double y, in double z,
 416                                    in TEnfName theVertexName, in TEntry theVertexEntry, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 417
 418     TEnfVertexList GetEnforcedVerticesEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
 419     boolean UnsetEnforcedVertexEntry(in TEntry theFaceEntry, in double x, in double y, in double z, in TEntry theVertexEntry) raises (SALOME::SALOME_Exception);
 420 //    boolean UnsetEnforcedVertexEntryGeom(in TEntry theFaceEntry, in TEntry theVertexEntry) raises (SALOME::SALOME_Exception);
 421     boolean UnsetEnforcedVerticesEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
 422
 423     /*!
 424      * To get/set internal vertices as enforced vertices
 425      */
 426     void          SetInternalEnforcedVertexAllFaces(in boolean toEnforceInternalVertices);
 427     boolean       GetInternalEnforcedVertexAllFaces();
 428     void          SetInternalEnforcedVertexAllFacesGroup(in TEnfGroupName groupName);
 429     TEnfGroupName GetInternalEnforcedVertexAllFacesGroup();
 430
 431 //  Enable internal enforced vertices on specific face if requested by user
 432 //    void          SetInternalEnforcedVertex(in GEOM::GEOM_Object theFace,in boolean toEnforceInternalVertices) raises (SALOME::SALOME_Exception);
 433 //    void          SetInternalEnforcedVertexWithGroup(in GEOM::GEOM_Object theFace, in boolean toEnforceInternalVertices, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 434 //    void          SetInternalEnforcedVertexEntry(in TEntry theFaceEntry, in boolean toEnforceInternalVertices, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
 435 //    boolean       GetInternalEnforcedVertex(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
 436 //    boolean       GetInternalEnforcedVertexEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
 437 //    TFaceEntryInternalVerticesList GetAllInternalEnforcedVerticesFaces();
 438     ///////////////////////
 439
 440
 441     ///////////////////////
 442     // PERIODICITY       //
 443     ///////////////////////
 444
 445     void ClearPreCadPeriodicityVectors();
 446     void AddPreCadFacesPeriodicity(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theFace2) raises (SALOME::SALOME_Exception);
 447     void AddPreCadFacesPeriodicityWithVertices(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theFace2, in GEOM::ListOfGO theSourceVertices, in GEOM::ListOfGO theTargetVertices) raises (SALOME::SALOME_Exception);
 448     void AddPreCadFacesPeriodicityEntry(in TEntry theFace1, in TEntry theFace2, in TEntryList theSourceVertices, in TEntryList theTargetVertices)  raises (SALOME::SALOME_Exception);
 449     void AddPreCadEdgesPeriodicity(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theEdge2) raises (SALOME::SALOME_Exception);
 450     void AddPreCadEdgesPeriodicityWithVertices(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theEdge2, in GEOM::ListOfGO theSourceVertices, in GEOM::ListOfGO theTargetVertices) raises (SALOME::SALOME_Exception);
 451     void AddPreCadEdgesPeriodicityEntry(in TEntry theEdge1, in TEntry theEdge2, in TEntryList theSourceVertices, in TEntryList theTargetVertices)  raises (SALOME::SALOME_Exception);
 452     void AddFacePeriodicity(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theFace2) raises (SALOME::SALOME_Exception);
 453     void AddEdgePeriodicity(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theFace2, in GEOM::GEOM_Object theEdge2, in long edge_orientation) raises (SALOME::SALOME_Exception);
 454     void AddEdgePeriodicityWithoutFaces(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theEdge2, in long edge_orientation) raises (SALOME::SALOME_Exception);
 455     void AddVertexPeriodicity(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theVertex1, in GEOM::GEOM_Object theEdge2, in GEOM::GEOM_Object theVertex2) raises (SALOME::SALOME_Exception);
 456     TPeriodicityList GetPreCadFacesPeriodicityVector();
 457     TPeriodicityList GetPreCadEdgesPeriodicityVector();
 458     ///////////////////////
 459
 460     /*!
 461      * Sets the file for export resulting mesh in GMF format
 462      */
 463 //     void SetGMFFile(in string theFileName, in boolean isBinary);
 464     void SetGMFFile(in string theFileName);
 465     string GetGMFFile();
 466 //     boolean GetGMFFileMode();
 467
 468     //
 469     // Obsolete methods - To be removed in V7
 470     //
 471     void SetPhyMin(in double theMinSize);
 472     double GetPhyMin();
 473     void SetPhyMax(in double theMaxSize);
 474     double GetPhyMax();
 475     void SetGeoMin(in double theMinSize);
 476     double GetGeoMin();
 477     void SetGeoMax(in double theMaxSize);
 478     double GetGeoMax();
 479     void SetAngleMeshS(in double angle);
 480     double GetAngleMeshS();
 481     void SetAngleMeshC(in double angle);
 482     double GetAngleMeshC();
 483     void SetDecimesh(in boolean toIgnoreEdges);
 484     boolean GetDecimesh();
 485     void SetPreCADRemoveNanoEdges(in boolean toRemoveNanoEdges);
 486     boolean GetPreCADRemoveNanoEdges();
 487     void SetPreCADEpsNano(in double epsNano);
 488     double GetPreCADEpsNano();
 489   };
 490 };
 491
 492 #endif