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 \n To create a \b Face you need to select input shape(s). The list of
   9 input shapes can include shapes of any type; if the shapes are nor
  10 wires or edges, the algorithm extracts all edges from
  11 the input shapes and works on the obtaineed edges.
  12 \n The edges and wires do not necessarily have to be closed, the
  13 algorithm automatically builds a wire of maximum length from all
  14 given edges and wires. If it founds multiple closed wires, it can
  15 build a face with holes or some separate faces, depending on the
  16 placement of the wires. If some resulting wires remain open, they will
  17 be added in the resulting compound "as is".
  18 \n Check <b>Try to create a planar face</b> to create a planar
  19 face or nothing if it is impossible.
  20 \note Please note, that the resulting face can have a huge tolerance, if the initial wire has a big deviation from the plane. If the final tolerance exceeds 1e-06, a warning will be shown, but the face will be created and published in the study in a normal way. Using such faces can lead to failures or unpredictable results in most operations.
  21
  22 \n The \b Result will be a \b GEOM_Object (FACE).
  23
  24 \n <b>TUI Command:</b> <em>geompy.MakeFaceWires([list of Shapes], isPlanarWanted)</em>
  25 \n <b>Arguments:</b> Name + 1 wire.
  26
  27 \image html neo-obj4.png
  28
  29 \n <b>Example:</b>
  30
  31 \image html facesn1.png
  32
  33 \image html facesn2.png
  34
  35 \image html facesn3.png "Examples of faces"
  36
  37 Our <b>TUI Scripts</b> provide you with useful examples of creation of
  38 \ref tui_creation_face "Advanced Geometric Objects".
  39
  40 */