doc/salome/gui/GEOM/input/creating_face.doc

   1 /*!
   2
   3 \page create_face_page Face
   4
   5 To create a \b Face in the <b>Main Menu</b> select <b>New Entity - >
   6 Build - > Face</b>
   7
   8 There are three algorithms to create a \b Face. In all cases the \b Result
   9 of the operation will be a GEOM_Object (FACE).
  10
  11 \n Firstly, to create a \b Face you need to select input shape(s). The list of
  12 input shapes can include shapes of any type except vertices; if the shapes are
  13 neither wires nor edges, the algorithm extracts all edges from
  14 the input shapes and works on the obtaineed edges.
  15 \n The edges and wires do not necessarily have to be closed, the
  16 algorithm automatically builds a wire of maximum length from all
  17 given edges and wires. If several closed wires are detected the algorithm tries
  18 to create a face with holes. It is possible only if there is only one wire
  19 that can be interpreted as an outer one; other wires can be considered as
  20 inner ones.
  21 \n Check <b>Try to create a planar face</b> to create a planar
  22 face or nothing if it is impossible.
  23 \note Please note, that the resulting face can have a huge tolerance, if
  24 the initial wire has a big deviation from the plane. If the final tolerance
  25 exceeds 1e-06, a warning will be shown, but the face will be created
  26 and published in the study in a normal way. Using such faces can lead to failures
  27 or unpredictable results in most operations.
  28
  29 \n The \b Result will be a \b GEOM_Object (FACE).
  30
  31 \n <b>TUI Command:</b> <em>geompy.MakeFaceWires([list of Shapes], isPlanarWanted)</em>
  32 \n <b>Arguments:</b> Name + 1 wire.
  33
  34 \image html neo-obj4.png "Create face by input shape(s)"
  35
  36 \n Secondly, it is possible to create a face based on another face's surface and bounded by a wire.
  37
  38 \n The \b Result will be a \b GEOM_Object (FACE).
  39
  40 \n <b>TUI Command:</b> <em>geompy.MakeFaceFromSurface(theFace, theWire)</em>
  41 \n <b>Arguments:</b> Name + 1 face + 1 wire.
  42
  43 \image html neo-obj4_2.png "Create face by another face's surface"
  44
  45 Thirdly, it is possible to create a \b Face by specifying a set of edges forming a closed wire
  46 and constraints:
  47 - Specify an input wire by selecting it in the object browser or in the viewer.
  48   The input wire will be exploded on edges which will be shown in the \b Constraints list box.
  49 - Specify constraints by associating faces with the edges.
  50
  51 \note Please note, that the constraint face must be connected to a reference edge.
  52
  53 \n The \b Result will be a \b GEOM_Object (FACE).
  54
  55 \n <b>TUI Command:</b> <em>geompy.MakeFaceWithConstraints([List of constraints])</em>
  56 \n <b>Arguments:</b> Name + List of input edges and constraint faces. If a constraint
  57 face is missing for some edge, this means that there is no constraint associated to this edge.
  58 \note Set of edges should form a closed wire.
  59
  60 \image html neo-obj4_3.png "Create face by a wire and its constraints"
  61
  62 \n <b>Example:</b>
  63
  64 \image html facesn1.png
  65
  66 \image html facesn2.png
  67
  68 \image html facesn3.png "Examples of faces"
  69
  70 Our <b>TUI Scripts</b> provide you with useful examples of creation of
  71 \ref tui_creation_face "Advanced Geometric Objects".
  72
  73 */