src/FeaturesPlugin/doc/linearCopyFeature.rst

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