src/PrimitivesPlugin/doc/boxFeature.rst

   1 .. _box_feature:
   2
   3 Box
   4 ===
   5
   6 The feature Box creates a box solid.
   7
   8 To create a Box in the active part:
   9
  10 #. select in the Main Menu *Primitives - > Box* item  or
  11 #. click **Box** button in the toolbar:
  12
  13 .. image:: images/box.png
  14    :align: center
  15
  16 .. centered::
  17    **Box**  button
  18
  19 There are 2 algorithms for creation of a Box:
  20
  21 .. image:: images/box_2pt_32x32.png
  22    :align: left
  23 **By dimensions**
  24
  25 .. image:: images/box_dxyz_32x32.png
  26    :align: left
  27 **By two points**
  28
  29
  30 By dimensions
  31 """""""""""""
  32
  33 Box is created by dimensions along X, Y, Z axis starting from the origin.
  34
  35 .. image:: images/Box_dimensions.png
  36    :align: center
  37
  38 Input fields:
  39
  40 - **DX**, **DY**, **DZ** define sizes of the box along corresponding coordinate axes.
  41
  42 **TUI Command**:  *model.addBox(Part_doc, DX, DY, DZ)*
  43
  44 **Arguments**:    Part + 3 real values (dimensions at origin).
  45
  46
  47 By two points
  48 """""""""""""
  49
  50 Box is created by two points of the box diagonal.
  51
  52 .. image:: images/Box_2points.png
  53          :align: center
  54
  55 Input fields:
  56
  57 - **Point 1** and **Point 2**  define diagonal points of the box selected in 3D OCC  viewer or object browser.
  58
  59 **TUI Command**:  *model.addBox(Part_doc, point1, point2)*
  60
  61 **Arguments**:   Part + 2 selected points (opposite vertices of the box)
  62
  63 Result
  64 """"""
  65
  66 The edges of the created boxes are parallel to the coordinate axes.
  67
  68 .. image:: images/Boxes.png
  69            :align: center
  70
  71 .. centered::
  72    Boxes created
  73
  74 **See Also** a sample TUI Script of a :ref:`tui_create_box` operation.