Description of method ShapesOnShape().

doc/salome/gui/GEOM/input/basic_operations.doc

@@ -5,6 +5,7 @@
 <ul>
 <li>\subpage partition_page</li>
 <li>\subpage archimede_page</li>
+<li>\subpage shapesonshape_page</li>
 </ul>
 
 */

doc/salome/gui/GEOM/input/creating_filling.doc

@@ -1,18 +1,27 @@
 /*!
 
-\page create_filling_page Filling Surface with Edges
+\page creaet_filling_page Filling Surface with Edges
 
 To generate a \b Filling in the <b>Main Menu</b> select <b>New Entity - > Generation  - > Filling</b>
 
-\n To create a curving face using several edges you need to define the
+To create a curving face using several edges you need to define the
-<b>Edges Compound</b>, \b Minimum and <b>Maximum Degree</b>, \b
+following parameters:
-Tolerance for \b 2D and for \b 3D , the <b>Number of Iterations</b>
+\n <b>Edges Compound</b> - the list of edges used for creation of the
-and <b>Approximation</b>.
+surface;
+\n \b Minimum and <b>Maximum Degree</b> of equation of the resulting BSpline or Besier curves describing the surface; 
+\n \b Tolerance for \b 2D and for \b 3D - minimum distance between the
+created surface and the reference edge; 
+\n <b>Number of
+Iterations</b> - defines the maximum number of iterations. The iterations are repeated until the required tolerance is reached. So, a greater number of iterations allows producing a better surface. 
+\n <b>Approximation</b> - if checked, BSpline curves are generated in the process of surface construction, By default the surface is created using Besier curves. The usage of <b>Approximation</b> makes the algorithm work slower, but allows building the
+surface for rather complex cases.
+
 \n The \b Result of the operation will be a GEOM_Object (face).
 
-\n <b>TUI Command:</b> <em>geompy.MakeFilling(Edges, MinDegree,
+\n <b>TUI Command:</b> <em>geompy.MakeFilling(Edges, MinDegree, MaxDegree, Tol2D, Tol3D, NbIter)</em>
-MaxDegree, Tol2D, Tol3D, NbIter, isApprox)</em>
+\n <b>Arguments:</b> Name + 1 List of edges + 6 Parameters
-\n <b>Arguments:</b> Name + 1 Compound of edges + 2 Values (min. and max degree of result BSpline surface) + 2 Values (2D and 3D precision to reach) + 1 Value (number of iterations of approximaion algorithm) + 1 Flag (to select one of algorithms).
+(Min. degree, Max. degree, Number of iterations, 2D tolerance, 3D
+tolerance, Number of iterations, Appro).
 
 \image html filling.png
 

doc/salome/gui/GEOM/input/index.doc

@@ -63,6 +63,7 @@
 <ul>
 <li>\ref partition_page</li>
 <li>\ref archimede_page</li>
+<li>\ref shapesonshape_page</li>
 </ul>
 <li>\ref boolean_operations_page</li>
 <ul>
@@ -106,6 +107,7 @@
 <li>\ref change_orientation_operation_page</li>
 <li>\ref remove_extra_edges_operation_page</li>
 </ul>
+<li>\subpage restore presentation parameters_page
 </ul>
 <li>\subpage using_measurement_tools_page</li>
 <li>\subpage geompy_page</li>

doc/salome/gui/GEOM/input/shapesonshape.doc

@@ -0,0 +1,30 @@
+/*!
+
+\page shapesonshape_page Get Shapes on Shape
+
+This operation is a special case of <b>Explode</b> operation. It produces a group of sub-shapes of the explosed shape, which are located in a definite way relatively another reference shape.
+
+To use this operation, select in the Main Menu <b>Operations -> Get Shapes on Shape.</b> The following dialog box will appear. 
+
+image html shapesonshape.png
+
+\n <b>Name</b> is the name of the resulting group of shapes;
+\n <b>Shape for exploding</b> is the shape that will be exploded;
+\n <b>Shape for checking</b> is the reference shape;
+\n <b>Reconstruction Limit</b> is the type of created sub-shapes: solid, shell, face, wire, edge, vertex;
+\n <b>State</b> is the position of the created sub-shapes relatively the reference shapes:
+	\n IN - the created sub-shapes are located inside the reference shape;
+	\n OUT - the created sub-shapes are located outside the reference shape;
+	\n ON - the created sub-shapes lie on the reference shape;
+	\n ONIN - the created sub-shapes lie on the reference shape or are located inside it;
+	\n ONOUT - the created sub-shapes lie on the reference shape or are located outside it;
+
+Example: 
+
+In the images below the box is the exploded shape and the cylinder is the reference shape. In the first image the edge IN the reference cylinder is highlighted in red, in the second the edges OUT of the reference cylinder are highlighted.
+
+image html shonshex1
+image html shonshex2
+
+ 
+*/