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 Contours</b> - the list of edges/wires to use for creation
  10 of the surface. You can select either several edges/wires or a
  11 compound of them. To prepare for the filling, each input wire
  12 is converted into a single BSpline curve by concatenating its edges.
  13 List of edges/wires must contain more than one edge.
  14 \n \b Minimum and <b>Maximum Degree</b> of equation of the resulting
  15 BSpline or Besier curves describing the surface.
  16 \n \b Tolerance for \b 2D and for \b 3D - minimum distance between the
  17 created surface and the input contours.
  18 \n <b>Number of 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 <ol>
  23 <li>Default - the standard behaviour.</li>
  24 <li>Use edges orientation - the edges orientation is used: if an edge is
  25 reversed, the curve from this edge is reversed before being used by the filling
  26 algorithm.</li>
  27 <li>Auto-correct edges orientation - curves orientation is changed to
  28 minimize the sum of distances between ends points of edges.</li>
  29 </ol>
  30
  31 <b>Approximation</b> - if checked, BSpline curves are generated in
  32 the process of surface construction (using
  33 GeomAPI_PointsToBSplineSurface functionality). By default the surface
  34 is created using Besier curves. The usage of <b>Approximation</b>
  35 slows the algorithm, but allows building the surface for complex cases.
  36
  37 \n The \b Result of the operation will be a GEOM_Object (face).
  38
  39 \n <b>TUI Command:</b> <em>geompy.MakeFilling(Contours, MinDegree, MaxDegree, Tol2D, Tol3D, NbIter)</em><br>
  40 <b>Arguments:</b> List/compound of edges/wires + 7 Parameters
  41 (Min. degree, Max. degree, 2D tolerance, 3D tolerance, Number of
  42 iterations, Method, Approximation).
  43 \n <b>Advanced options:</b> \ref preview_anchor "Preview"
  44
  45 \image html filling.png
  46
  47 \note This dialog supports navigation through the selectable objects (in OCC 3D viewer only):
  48 - Scroll mouse wheel with pressed \em Ctrl key or press \em "S", \em "P" keys when input focus is
  49 in the viewer to navigate between selectable objects.
  50 - Press left mouse button to select an appropriate object to the dialog box.
  51 .
  52 For more details, please refer to the \em "Functionality common for OCC and VTK viewers" chapter
  53 of the GUI module's documentation.
  54
  55 <b>Example:</b>
  56
  57 \image html filling_compoundsn.png "Initial edges"
  58
  59 \image html fillingsn.png "Resulting surface"
  60
  61 Sample <b>TUI Scripts</b> provide you with useful examples of creation of
  62 \ref tui_creation_filling "Complex Geometric Objects".
  63
  64 */