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 .. figure:: images/Copy.png
  21    :align: center
  22
  23    **Copy operation**
  24
  25 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.
  26 Also it is possible to increase the number of resulting copies.
  27
  28 **Apply** button creates a copy.
  29
  30 **Cancel** button cancels the operation.
  31
  32 **TUI Command**:
  33
  34 .. py:function:: model.addCopy(Part_doc, objects, number_of_copies)
  35
  36     :param part: The current part object.
  37     :param objects: A list of objects.
  38     :param number_of_copies: A number of resulting copies.
  39     :return: Result feature Copy.
  40
  41 Result
  42 """"""
  43
  44 The Result of the operation will be one or several copies of the selected shapes located in the same place:
  45
  46 .. figure:: images/CreatedCopy.png
  47    :align: center
  48
  49    **Copy created**
  50
  51 **See Also** a sample TUI Script of :ref:`tui_create_copy` operation.