Salome HOME
Doc : Add an Angle option in the cylinder primitive in order to build portion of...
[modules/geom.git] / doc / salome / gui / GEOM / input / creating_filling.doc
index 82d446f2c31c8812b6cc41190c4b47280dca4939..874cac94ba0ea87e58b854520993289afc7f02c9 100644 (file)
@@ -4,25 +4,51 @@
 
 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
-<b>Edges Compound</b>, \b Minimum and <b>Maximum Degree</b>, \b
-Tolerance for \b 2D and for \b 3D , the <b>Number of Iterations</b>
-and <b>Approximation</b>.
+To create a curvilinear face from several edges you need to define the
+following parameters:
+\n <b>Input Compound</b> - the list of edges/wires used for creation
+of the surface. To prepare for the filling each wire of the compound
+is converted to an edge created on a BSpline curve built using curves
+from all edges of the wire.
+\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>Method</b> - Kind of method to perform filling operation
+
+<ol>
+<li>Default - the standard behaviour.</li>
+<li>Use edges orientation - the edges orientation is used: if an edge is
+reversed, the curve from this edge is reversed before being used by the filling
+algorithm.</li>
+<li>Auto-correct edges orientation - curves orientation is changed to 
+minimize the sum of distances between ends points of edges.</li>
+</ol>
+
+\n <b>Approximation</b> - if checked, BSpline curves are generated in
+the process of surface construction (using
+GeomAPI_PointsToBSplineSurface functionality). By default the surface
+is created using Besier curves. The usage of <b>Approximation</b>
+slows the algorithm, but allows building the surface for 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,
-MaxDegree, Tol2D, Tol3D, NbIter, isApprox)</em>
-\n <b>Arguments:</b> Name + 1 List of edges + 6 Parameters
+\n <b>TUI Command:</b> <em>geompy.MakeFilling(Edges, MinDegree, MaxDegree, Tol2D, Tol3D, NbIter)</em>
+\n <b>Arguments:</b> Name + 1 List of edges + 7 Parameters
 (Min. degree, Max. degree, Number of iterations, 2D tolerance, 3D
-tolerance, Number of iterations, Approximation).
+tolerance, Number of iterations, Method, Approximation).
+\n <b>Advanced options</b> \ref preview_anchor "Preview"
 
 \image html filling.png
 
 <b>Example:</b>
 
-\image html filling_compoundsn.png
+\image html filling_compoundsn.png "Initial edges"
 
-\image html fillingsn.png
+\image html fillingsn.png "Resulting surface"
 
 Our <b>TUI Scripts</b> provide you with useful examples of creation of
 \ref tui_creation_filling "Complex Geometric Objects".