src/BuildPlugin/doc/faceFeature.rst

   1 .. _buildFace:
   2 .. |feature_face.icon|    image:: images/feature_face.png
   3
   4 Face
   5 ====
   6
   7 Face feature creates one or several faces using shapes already existing in other objects.
   8
   9 To create a face in the active part:
  10
  11 #. select in the Main Menu *Build - > Face* item  or
  12 #. click |feature_face.icon| **Face** button in the toolbar
  13
  14 The following property panel will be opened:
  15
  16 .. figure:: images/Face.png
  17   :align: center
  18
  19   Create a face
  20
  21 Select one or several faces in viewer. Additionally, a face can be build by a closed wire or a set of edges composing a closed wire.
  22
  23 It is possible to build a non-planar face by selecting non-planar wire or set of edges composing a closed wire, which do not belong to only one plane.
  24
  25 It is also possible to select a whole sketch result from the object browser. In this case, the smallest closed contour of the sketch will be transformed to the planar face.
  26
  27 **Apply** button creates faces.
  28
  29 **Cancel** button cancels the operation.
  30
  31 **TUI Command**:
  32
  33 .. py:function:: model.addFace(Part_doc, Shapes)
  34
  35     :param part: The current part object.
  36     :param list: A list of shapes.
  37     :return: Result object.
  38
  39 Result
  40 """"""
  41
  42 The result of the operation will be a set of faces created from the selected shapes:
  43
  44 .. figure:: images/CreateFace.png
  45   :align: center
  46
  47   Result of the operation.
  48
  49 **See Also** a sample TUI Script of :ref:`tui_create_face` operation.