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