0021308: Remove hard-coded dependency of the external mesh plugins from the SMESH...

  More docs

diff --git a/src/SMESH_SWIG/StdMeshersDC.py b/src/SMESH_SWIG/StdMeshersDC.py
index 2b6dff9433996106181b7cb4118f0a64bc6e260a..e0fc8915b1e6e61d0c9178e9ec3f4357665abb6f 100644 (file)
--- a/src/SMESH_SWIG/StdMeshersDC.py
+++ b/src/SMESH_SWIG/StdMeshersDC.py
@@ -46,7 +46,9 @@ for e in StdMeshers.QuadType._items: exec('%s = StdMeshers.%s'%(e,e))
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Segment(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Segment"
+    ## Name of algorithm type
     algoType   = REGULAR
     isDefault  = True
 
@@ -320,7 +322,9 @@ class StdMeshersDC_Segment(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_CompositeSegment(StdMeshersDC_Segment):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Segment"
+    ## Name of algorithm type
     algoType   = COMPOSITE
     isDefault  = False
 
@@ -338,7 +342,9 @@ class StdMeshersDC_CompositeSegment(StdMeshersDC_Segment):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Segment_Python(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Segment"
+    ## Name of algorithm type
     algoType   = PYTHON
 
     ## Private constructor.
@@ -369,7 +375,9 @@ class StdMeshersDC_Segment_Python(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Triangle_MEFISTO(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Triangle"
+    ## Name of algorithm type
     algoType   = MEFISTO
     isDefault  = True
 
@@ -408,7 +416,9 @@ class StdMeshersDC_Triangle_MEFISTO(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Quadrangle(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Quadrangle"
+    ## Name of algorithm type
     algoType   = QUADRANGLE
     isDefault  = True
 
@@ -514,7 +524,9 @@ class StdMeshersDC_Quadrangle(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Hexahedron(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Hexahedron"
+    ## Name of algorithm type
     algoType   = Hexa
     isDefault  = True
 
@@ -533,7 +545,9 @@ class StdMeshersDC_Hexahedron(Mesh_Algorithm):
 #
 class StdMeshersDC_Projection1D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Projection1D"
+    ## Name of algorithm type
     algoType   = "Projection_1D"
     isDefault  = True
 
@@ -577,7 +591,9 @@ class StdMeshersDC_Projection1D(Mesh_Algorithm):
 #
 class StdMeshersDC_Projection2D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Projection2D"
+    ## Name of algorithm type
     algoType   = "Projection_2D"
     isDefault  = True
 
@@ -627,7 +643,9 @@ class StdMeshersDC_Projection2D(Mesh_Algorithm):
 
 class StdMeshersDC_Projection1D2D(StdMeshersDC_Projection2D):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Projection1D2D"
+    ## Name of algorithm type
     algoType   = "Projection_1D2D"
 
     ## Private constructor.
@@ -644,7 +662,9 @@ class StdMeshersDC_Projection1D2D(StdMeshersDC_Projection2D):
 #
 class StdMeshersDC_Projection3D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Projection3D"
+    ## Name of algorithm type
     algoType   = "Projection_3D"
 
     ## Private constructor.
@@ -697,7 +717,9 @@ class StdMeshersDC_Projection3D(Mesh_Algorithm):
 #
 class StdMeshersDC_Prism3D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Prism"
+    ## Name of algorithm type
     algoType   = "Prism_3D"
 
     ## Private constructor.
@@ -834,7 +856,9 @@ class StdMeshersDC_Prism3D(Mesh_Algorithm):
 #  @ingroup l2_algos_radialq
 class StdMeshersDC_RadialQuadrangle1D2D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "Quadrangle"
+    ## Name of algorithm type
     algoType   = RADIAL_QUAD
 
     ## Private constructor.
@@ -938,7 +962,9 @@ class StdMeshersDC_RadialQuadrangle1D2D(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_UseExistingElements_1D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "UseExisting1DElements"
+    ## Name of algorithm type
     algoType   = "Import_1D"
     isDefault  = True
 
@@ -972,7 +998,9 @@ class StdMeshersDC_UseExistingElements_1D(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_UseExistingElements_1D2D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "UseExisting2DElements"
+    ## Name of algorithm type
     algoType   = "Import_1D2D"
     isDefault  = True
 
@@ -1007,7 +1035,9 @@ class StdMeshersDC_UseExistingElements_1D2D(Mesh_Algorithm):
 #  @ingroup l3_algos_basic
 class StdMeshersDC_Cartesian_3D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "BodyFitted"
+    ## Name of algorithm type
     algoType   = "Cartesian_3D"
     isDefault  = True
 
@@ -1067,7 +1097,9 @@ class StdMeshersDC_Cartesian_3D(Mesh_Algorithm):
 
 class StdMeshersDC_UseExisting_1D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "UseExistingSegments"
+    ## Name of algorithm type
     algoType   = "UseExisting_1D"
 
     def __init__(self, mesh, geom=0):
@@ -1084,7 +1116,9 @@ class StdMeshersDC_UseExisting_1D(Mesh_Algorithm):
 
 class StdMeshersDC_UseExisting_2D(Mesh_Algorithm):
 
+    ## Name of method of class Mesh creating an instance of this class
     meshMethod = "UseExistingFaces"
+    ## Name of algorithm type
     algoType   = "UseExisting_2D"
 
     def __init__(self, mesh, geom=0):

diff --git a/src/SMESH_SWIG/smeshDC.py b/src/SMESH_SWIG/smeshDC.py
index ef3e72d069539678d7406f74fec09d00ba69cb91..578e0970d1c33a92e240427949fa4714a426b239 100644 (file)
--- a/src/SMESH_SWIG/smeshDC.py
+++ b/src/SMESH_SWIG/smeshDC.py
@@ -3994,7 +3994,17 @@ class Mesh:
 
 ## The mother class to define algorithm, it is not recommended to use it directly.
 #
-#  More details.
+#  For each meshing algorithm, a python class inheriting from class Mesh_Algorithm
+#  should be defined. This descendant class sould have two attributes defining the way
+# it is created by class Mesh (see e.g. class StdMeshersDC_Segment in StdMeshersDC.py).
+# - meshMethod attribute defines name of method of class Mesh by calling which the
+#   python class of algorithm is created. E.g. if in class MyPlugin_Algorithm
+#   meshMethod = "MyAlgorithm", then an instance of MyPlugin_Algorithm is created
+#   by the following code: my_algo = mesh.MyAlgorithm()
+# - algoType defines name of algorithm type and is used mostly to discriminate
+#   algorithms that are created by the same method of class Mesh. E.g. if
+#   MyPlugin_Algorithm.algoType = "MyPLUGIN" then it's creation code can be:
+#   my_algo = mesh.MyAlgorithm(algo="MyPLUGIN")
 #  @ingroup l2_algorithms
 class Mesh_Algorithm:
     #  @class Mesh_Algorithm