Salome HOME
Merge branch HELP_DOCUMENTATION_EDITING into master.
[modules/shaper.git] / src / PrimitivesPlugin / doc / torusFeature.rst
index 6b5be953a1b51324835e6ae4687b8db0eca9a6a2..9d3e02242fc125bd4abfde3eaf7762b176fbb0b5 100644 (file)
@@ -2,9 +2,49 @@
 Torus
 =====
 
+The feature Torus creates a torus solid.
+
+To create a Torus in the active part:
+
+#. select in the Main Menu *Primitives - > Torus* item  or
+#. click **Torus** button in the toolbar
+
+.. image:: images/Torus_button.png
+   :align: center
+
+.. centered::
+   **Torus** button 
+
+The following property panel appears.
 
 .. image:: images/Torus.png
   :align: center
 
 .. centered::
-  Create a torus
+   Torus
+
+Input fields:
+
+- **Point** defines center of the torus base selected in 3D OCC  viewer or object browser; 
+- **Vector** defines the axis of the torus selected in 3D OCC  viewer or object browser;
+- Dimensions:      
+   - **Radius**;
+   - **Ring radius**.
+  
+**TUI Command**: *model.addTorus(Part_doc, Point, Axis, Radius1, Radius2)*
+
+**Arguments**:  Part + 1 vertex + 1 vector + 2 real values (first and second radii).
+
+Result
+""""""
+
+Example is shown below.
+
+.. image:: images/Torus_res.png
+          :align: center
+                  
+.. centered::
+   Torus created  
+
+**See Also** a sample TUI Script of a :ref:`tui_create_torus` operation.
+