Salome HOME
Changes for 0020673 - Implementation of "Auto-correct edges orientation".
[modules/geom.git] / doc / salome / gui / GEOM / input / creating_filling.doc
1 /*!
2
3 \page create_filling_page Filling Surface with Edges
4
5 To generate a \b Filling in the <b>Main Menu</b> select <b>New Entity - > Generation  - > Filling</b>
6
7 To create a curving face using several edges you need to define the
8 following parameters:
9 \n <b>Input Compound</b> - the list of edges/wires used for creation
10 of the surface. Before perform filling algorithm each wire from
11 compound is converted to one edge created on BSpline curve built using
12 curves from all edges from wire.
13 \n \b Minimum and <b>Maximum Degree</b> of equation of the resulting
14 BSpline or Besier curves describing the surface; 
15 \n \b Tolerance for \b 2D and for \b 3D - minimum distance between the
16 created surface and the reference edge; 
17 \n <b>Number of
18 Iterations</b> - defines the maximum number of iterations. The
19 iterations are repeated until the required tolerance is reached. So, a
20 greater number of iterations allows producing a better surface. 
21 \n <b>Method</b> - Kind of method to perform filling operation
22 1. Default - standard behaviour
23 2. Use edges orientation - orientation of edges are used: if edge is
24 reversed curve from this edge is reversed before using in filling
25 algorithm.
26 3. Auto-correct edges orientation - change orientation of curves using
27 minimization of sum of distances between ends points of edges.
28 \n <b>Approximation</b> - if checked, BSpline curves are generated in
29 the process of surface construction (using
30 GeomAPI_PointsToBSplineSurface functionality). By default the surface
31 is created using Besier curves. The usage of <b>Approximation</b>
32 makes the algorithm work slower, but allows building the surface for
33 rather complex cases. 
34
35 \n The \b Result of the operation will be a GEOM_Object (face).
36
37 \n <b>TUI Command:</b> <em>geompy.MakeFilling(Edges, MinDegree, MaxDegree, Tol2D, Tol3D, NbIter)</em>
38 \n <b>Arguments:</b> Name + 1 List of edges + 7 Parameters
39 (Min. degree, Max. degree, Number of iterations, 2D tolerance, 3D
40 tolerance, Number of iterations, Method, Approximation).
41
42 \image html filling.png
43
44 <b>Example:</b>
45
46 \image html filling_compoundsn.png "Initial edges"
47
48 \image html fillingsn.png "Resulting surface"
49
50 Our <b>TUI Scripts</b> provide you with useful examples of creation of
51 \ref tui_creation_filling "Complex Geometric Objects".
52
53 */