src/FeaturesPlugin/doc/placementFeature.rst

   1 .. |placement_btn.icon|    image:: images/placement_btn.png
   2
   3 Placement
   4 =========
   5
   6 Placement defines position of an object relatively to another object. To make a placement:
   7
   8 #. select in the Main Menu *Part - > Placement* item  or
   9 #. click |placement_btn.icon| **Placement** button in the toolbar
  10
  11 The following property panel will be opened:
  12
  13 .. figure:: images/Placement.png
  14    :align: center
  15
  16    **Placement operation**
  17
  18 In this property panel, it is necessary to:
  19
  20 -  Select objects which will be moved;
  21
  22 -  Select a face, edge or vertex as a start for moving;
  23
  24 -  Select a face, edge or vertex as an end of moving;
  25
  26 -  Define state of **Reverse** and **Centering** check boxes.
  27
  28
  29 **Apply** button creates the placement.
  30
  31 **Cancel** button cancels the operation.
  32
  33 **TUI Command**:
  34
  35 .. py:function:: model.addPlacement(Part_doc, placeObjects, startShape, endShape, isReverse, isCentering)
  36
  37     :param part: The current part object.
  38     :param list: A list of objects to move.
  39     :param object: A start shape.
  40     :param object: A end shape.
  41     :param bool: Is reverse flag.
  42     :param bool: Is centering flag.
  43     :return: Created object.
  44
  45 Result
  46 """"""
  47
  48 The Result of the operation will be a new placement of selected objects:
  49
  50 .. figure:: images/CreatedPlacement.png
  51    :align: center
  52
  53    **Placement created**
  54
  55 **See Also** a sample TUI Script of :ref:`tui_create_placement` operation.