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 curvilinear face from 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. To prepare for the filling each wire of the compound
  11 is converted to an edge created on a BSpline curve built using curves
  12 from all edges of the 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 Iterations</b> - defines the maximum number of iterations. The
  18 iterations are repeated until the required tolerance is reached. So, a
  19 greater number of iterations allows producing a better surface.
  20 \n <b>Method</b> - Kind of method to perform filling operation
  21 1. Default - the standard behaviour.
  22 2. Use edges orientation - the edges orientation is used: if an edge is
  23 reversed, the curve from this edge is reversed before being used by the filling
  24 algorithm.
  25 3. Auto-correct edges orientation - curves orientation is changed to
  26 minimize the sum of distances between ends points of edges.
  27 \n <b>Approximation</b> - if checked, BSpline curves are generated in
  28 the process of surface construction (using
  29 GeomAPI_PointsToBSplineSurface functionality). By default the surface
  30 is created using Besier curves. The usage of <b>Approximation</b>
  31 slows the algorithm, but allows building the surface for complex cases.
  32
  33 \n The \b Result of the operation will be a GEOM_Object (face).
  34
  35 \n <b>TUI Command:</b> <em>geompy.MakeFilling(Edges, MinDegree, MaxDegree, Tol2D, Tol3D, NbIter)</em>
  36 \n <b>Arguments:</b> Name + 1 List of edges + 7 Parameters
  37 (Min. degree, Max. degree, Number of iterations, 2D tolerance, 3D
  38 tolerance, Number of iterations, Method, Approximation).
  39 \n <b>Advanced options</b> \ref preview_anchor "Preview"
  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 */