]> SALOME platform Git repositories - modules/shaper.git/blob - src/BuildPlugin/doc/faceFeature.rst
Salome HOME
Merge remote-tracking branch 'origin/master' into gni/documentation
[modules/shaper.git] / 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.