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, 2D tolerance, 3D tolerance, Number of iterations, Method, Approximation).
  40
  41 \image html filling.png
  42
  43 <b>Example:</b>
  44
  45 \image html filling_compoundsn.png "Initial edges"
  46
  47 \image html fillingsn.png "Resulting surface"
  48
  49 Our <b>TUI Scripts</b> provide you with useful examples of creation of
  50 \ref tui_creation_filling "Complex Geometric Objects".
  51
  52 */