src/FeaturesPlugin/doc/linearCopyFeature.rst

   1 .. |multitranslation.icon|    image:: images/multitranslation.png
   2
   3 Linear copy
   4 ===========
   5
   6 **Linear copy** feature makes several translations of a selected shape in one or two directions.
   7
   8 To create a Linear copy in the active part:
   9
  10 #. select in the Main Menu *Part - > Linear copy* item  or
  11 #. click |multitranslation.icon| **Linear copy** button in the toolbar
  12
  13 The following property panel appears.
  14
  15 .. image:: images/LinearCopy.png
  16   :align: center
  17
  18 .. centered::
  19   Linear copy property panel
  20
  21 Input fields:
  22
  23 - **Main objects** panel contains shapes to be translated. Shapes are selected in 3D OCC viewer or object browser;
  24 - **First direction** defines translation in the first direction:
  25
  26   - **Vector of translation**  defines vector along which the object will be translated. Vector is edge, axis selected in 3D OCC viewer or object browser;
  27   - **Step** defines the distance between the shape copies;
  28   - **Nb. Copies** is the number of shape copies;
  29
  30 - **Second direction** check-box turns on/off translation in the second direction:
  31
  32   - **Vector of translation**  defines vector along which the object will be translated. Vector is edge, axis selected in 3D OCC viewer or object browser;
  33   - **Step** defines the distance between the shape copies;
  34   - **Nb. Copies** defines the number of shape copies.
  35
  36 **TUI Command**:
  37
  38 .. py:function:: model.addMultiTranslation(Part_doc, [shape], axis1, step1, Nb1, axis2, step2, Nb2)
  39
  40     :param part: The current part object.
  41     :param list: A list of shapes in format *model.selection(TYPE, shape)*.
  42     :param object: A first axis in format *model.selection(TYPE, shape)*.
  43     :param real: The first step value.
  44     :param integer: The first number of copies.
  45     :param object: A second axis in format *model.selection(TYPE, shape)*.
  46     :param real: The second step value.
  47     :param integer: The second number of copies.
  48     :return: Created object.
  49
  50 Result
  51 """"""
  52 Result of operation is a compound.
  53
  54 .. image:: images/linearcopyres.png
  55    :align: center
  56
  57 .. centered::
  58    Linear copy
  59
  60 **See Also** a sample TUI Script of :ref:`tui_create_linearcopy` operation.