src/FeaturesPlugin/doc/copyFeature.rst

   1 .. |copy_btn.icon|    image:: images/copy_btn.png
   2
   3 Copy
   4 =====
   5
   6 Copy feature makes duplicates of the selected features, results, sub-results and sub-shapes. For the whole feature selected
   7 all results of this feature are copied. The referenced arguments of this feature are not concealed. The history behavior of
   8 copy is specific: *Move to the End* of groups will move to all copy-results. For an example, if a face of a box was selected
   9 for a group and a copy of this box was done, the *Move to the End* of this group will cause two faces appeared in this Group:
  10 the original one and the copy.
  11
  12
  13 To create a Copy in the active part:
  14
  15 #. select in the Main Menu *Features - > Copy* item  or
  16 #. click |copy_btn.icon| **Copy** button in the toolbar
  17
  18 The following property panel will be opened:
  19
  20 .. image:: images/Copy.png
  21   :align: center
  22
  23 .. centered::
  24    **Copy operation**
  25
  26 Here it is necessary to select some objects. Only results and sub-results and their sub-shapes located in the folder **Results** can be selected and copied.
  27 Also it is possible to increase the number of resulting copies.
  28
  29 **Apply** button creates a copy.
  30
  31 **Cancel** button cancels the operation.
  32
  33 **TUI Command**:
  34
  35 .. py:function:: model.addCopy(Part_doc, objects, number_of_copies)
  36
  37     :param part: The current part object.
  38     :param objects: A list of objects.
  39     :param number_of_copies: A number of resulting copies.
  40     :return: Result feature Copy.
  41
  42 Result
  43 """"""
  44
  45 The Result of the operation will be one or several copies of the selected shapes located in the same place:
  46
  47 .. image:: images/CreatedCopy.png
  48            :align: center
  49
  50 .. centered::
  51    **Copy created**
  52
  53 **See Also** a sample TUI Script of :ref:`tui_create_copy` operation.