+
Box
===
+To create a Box in the active part:
+
+#. select in the Main Menu *Primitives - > Box* item or
+#. click **Box** button in the toolbar
-.. image:: images/Box1.png
- :align: center
+.. image:: images/Box_button.png
+ :align: center
.. centered::
- Create a box by dimensions
+ **Box** button
+There are 2 algorithms for creation of a Box:
+
+.. image:: images/Box_dimensions.png
+ :align: center
+
+.. centered::
+ **By dimensions**
-.. image:: images/Box2.png
- :align: center
+and
+.. image:: images/Box_2points.png
+ :align: center
+
.. centered::
- Create a box by two points
+ **By two points**
+
+
+The description of input fields for **By dimensions** tab is given below:
+
+- **DX**, **DY**, **DZ** specify box dimensions along the coordinate axes for box with corner coinciding with coordinate origin.
+
+The description of input fields for **By two points** tab is given below:
+
+- **Point 1** and **Point 2** define the opposite corners of the box.
+
+**Apply** button creates box with defined parameters.
+
+**Cancel** button cancels operation.
+
+The Result of operation will be a SOLID. The edges of the box will be parallel to the coordinate axes.
+
+Name is assigned automatically:
+
+* **Box_1**, **Box_2**, ... to Feature;
+* **Box_1_1**, **Box_2_1**, ... to Result.
+
+**See Also** a sample TUI Script of a :ref:`tui_create_box` operation.
--- /dev/null
+# -*- coding: utf-8 -*-
+
+from salome.shaper import model
+
+model.begin()
+partSet = model.moduleDocument()
+Part_1 = model.addPart(partSet)
+Part_1_doc = Part_1.document()
+Box_1 = model.addBox(Part_1_doc, 10, 10, 10)
+Point_2 = model.addPoint(Part_1_doc, 20, 30, 40)
+Point_3 = model.addPoint(Part_1_doc, 40, 40, 50)
+Box_2 = model.addBox(Part_1_doc, model.selection("VERTEX", "Point_1"), model.selection("VERTEX", "Point_2"))
+model.do()
+model.end()
