X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FPrimitivesPlugin%2Fdoc%2FboxFeature.rst;h=307883cb94fb994a05c71baccbd4bdb9c4d8f325;hb=bcd96990e1fca77402d522bc8b095ebfa1091894;hp=7ae1d7253e826f9ece58170f215871a7597c33b8;hpb=b21742542af864243239ad11f3a9c9dd0d6de44b;p=modules%2Fshaper.git

diff --git a/src/PrimitivesPlugin/doc/boxFeature.rst b/src/PrimitivesPlugin/doc/boxFeature.rst
index 7ae1d7253..307883cb9 100644
--- a/src/PrimitivesPlugin/doc/boxFeature.rst
+++ b/src/PrimitivesPlugin/doc/boxFeature.rst
@@ -1,17 +1,83 @@
+.. _box_feature:
 
 Box
 ===
 
+Box feature creates a box solid.
 
-.. image:: images/Box1.png
-  :align: center
+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/box.png
+   :align: center
 
 .. centered::
-  Create a box by dimensions
+   **Box**  button 
 
+There are 2 algorithms for creation of a Box:
 
-.. image:: images/Box2.png
-  :align: center
+.. image:: images/box_2pt_32x32.png
+   :align: left
+**By dimensions** 
+
+.. image:: images/box_dxyz_32x32.png
+   :align: left
+**By two points** 
+
+
+By dimensions
+-------------
+
+Box is created by dimensions along X, Y, Z axis starting from the origin.
+
+.. image:: images/Box_dimensions.png
+   :align: center
+
+Input fields:
+
+- **DX**, **DY**, **DZ** define dimensions of the box along the corresponding coordinate axes. 
+
+**TUI Command**:  *model.addBox(Part_doc, DX, DY, DZ)*
+  
+**Arguments**:    Part + 3 real values (dimensions at origin).
+
+Result
+""""""
+
+A solid box based on the origin of coordinates and with edges parallel to the coordinate axes.
 
+.. image:: images/Box1.png
+	   :align: center
+
+**See Also** a sample TUI Script of a :ref:`tui_create_boxdim` operation.
+
+By two points
+-------------
+
+Box is created by two points of the box diagonal.
+
+.. image:: images/Box_2points.png
+	 :align: center
+
+Input fields:
+
+- **Point 1** and **Point 2**  define diagonal points of the box selected in 3D OCC viewer or object browser.
+  
+**TUI Command**:  *model.addBox(Part_doc, point1, point2)*
+
+**Arguments**:   Part + 2 selected points (opposite vertices of the box)
+
+Result
+""""""
+
+A solid box based on two points and with edges parallel to the coordinate axes.
+
+.. image:: images/Box2.png
+	   :align: center
+		   
 .. centered::
-  Create a box by two points
+   Created boxes
+
+**See Also** a sample TUI Script of :ref:`tui_create_boxpnt` operation.