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 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.
  24
  25 **Apply** button creates faces.
  26
  27 **Cancel** button cancels the operation.
  28
  29 **TUI Command**:
  30
  31 .. py:function:: model.addFace(Part_doc, Shapes)
  32
  33     :param part: The current part object.
  34     :param list: A list of shapes.
  35     :return: Result object.
  36
  37 Result
  38 """"""
  39
  40 The result of the operation will be a set of faces created from the selected shapes:
  41
  42 .. figure:: images/CreateFace.png
  43   :align: center
  44
  45   Result of the operation.
  46
  47 **See Also** a sample TUI Script of :ref:`tui_create_face` operation.