Salome HOME
Issue #19114: complete documentation of boolean operations
[modules/shaper.git] / src / FeaturesPlugin / doc / partitionFeature.rst
1 .. |partition_btn.icon|    image:: images/partition_btn.png
2
3 .. _featurePartition:
4
5 Partition
6 =========
7
8 Partition feature implements a boolean operation for partitioning of a set of selected objects.
9
10 To perform a Partition in the active part:
11
12 #. select in the Main Menu *Features - > Partition* item  or
13 #. click |partition_btn.icon| **Partition** button in the toolbar
14
15 The following property panel will be opened:
16
17 .. figure:: images/Partition.png
18    :align: center
19
20    **Partition operation**
21
22 **Base Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be partitioned. Constuction planes are allowed too if at least one non-construction entity is selected.
23
24 **TUI Command**:
25
26 .. py:function:: model.addPartition(Part_doc, objects)
27
28     :param part: The current part object.
29     :param object: A list of objects.
30     :return: Created object.
31
32 Result
33 """"""
34
35 The Result of the operation will be a shape which is a partition of selected objects:
36
37 .. figure:: images/CreatedPartition.png
38    :align: center
39
40    **Partition created**
41
42 **See Also** a sample TUI Script of :ref:`tui_create_partition` operation.