Salome HOME
Task #3016: 3.2 To add a mode «through all» for features RevolutionCut and RevolutionFuse
[modules/shaper.git] / src / FeaturesPlugin / doc / pipeFeature.rst
index 383eca0bb7778c3366424a07545f60ff3031f524..40611a394ad9115ad7ab896e3609fb44defbb9c2 100644 (file)
@@ -1,19 +1,14 @@
+.. |pipe.icon|    image:: images/pipe.png
 
 Pipe
 ====
 
-The feature **Pipe** makes an extruded Pipe shape.
+**Pipe** feature makes an extruded Pipe shape.
 
-To create Pipe in the active part:
+To create Pipe in the active part:
 
 #. select in the Main Menu *Features - > Pipe* item  or
-#. click **Pipe** button in the toolbar
-
-.. image:: images/pipe.png        
-   :align: center
-
-.. centered::
-   **Pipe** button 
+#. click |pipe.icon| **Pipe** button in the toolbar
 
 Pipe can be created in three different ways:
 
@@ -43,16 +38,21 @@ Base Objects are extruded along the Path Object so that the angle between the no
 Input fields:
 
 - **Base objects** panel contains shapes to be extruded. Several Base Objects generate several pipes. Shapes (edges, faces, shells) are selected in 3D OCC viewer or object browser;
-- **Path object**  defines path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
+- **Path object**  defines the path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
 
-**TUI Command**:  *model.addPipe(Part_doc, [shape], path)*
+**TUI Command**:
+
+.. py:function:: model.addPipe(Part_doc, [shape], path)
  
-**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + path in format *model.selection(TYPE, shape)*.
+    :param part: The current part object.
+    :param list: A list of shapes in format *model.selection(TYPE, shape)*.
+    :param object: A path in format *model.selection(TYPE, shape)*.
+    :return: Created object.
 
 Result
 """"""
 
-Result of extrusion of arc along another arc.
+Result of extrusion of an arc along another arc.
 
 .. image:: images/simplePipe.png
    :align: center
@@ -60,7 +60,7 @@ Result of extrusion of arc along another arc.
 .. centered::
    Pipe by object and path
 
-**See Also** a sample TUI Script of a :ref:`tui_simple_pipe` operation.
+**See Also** a sample TUI Script of ref:`tui_simple_pipe` operation.
 
 Pipe by object, path and Bi-normal
 ----------------------------------
@@ -76,30 +76,36 @@ The pipe is generated to preserve the constant angle between the normal vector t
 Input fields:
 
 - **Base objects** panel contains shapes to be extruded. Several Base Objects generate several pipes. Shapes (edges, faces, shells) are selected in 3D OCC viewer or object browser;
-- **Path object**  defines path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
+- **Path object**  defines the path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
 - **Bi-Normal** defines the BiNormal Vector. **Bi-Normal** (edge or wire) is selected in 3D OCC viewer or object browser.
 
-**TUI Command**:  *model.addPipe(Part_doc, [shape], path, binormal)*
+**TUI Command**:
+
+.. py:function:: model.addPipe(Part_doc, [shape], path, binormal)
  
-**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + path in format *model.selection(TYPE, shape)* + binormal in format *model.selection(TYPE, shape)*.
+    :param part: The current part object.
+    :param list: A list of shapes in format *model.selection(TYPE, shape)*.
+    :param object: A path in format *model.selection(TYPE, shape)*.
+    :param object: A binormal in format *model.selection(TYPE, shape)*.
+    :return: Created object.
 
 Result
 """"""
 
-Result of extrusion of rectangular face along  arc.
+Result of extrusion of rectangular face along  arc.
 
 .. image:: images/binormalPipe.png
    :align: center
 
 .. centered::
-   Pipe by object and path
+   Pipe by object, path and Bi-normal
 
-**See Also** a sample TUI Script of :ref:`tui_binormal_pipe` operation.
+**See Also** a sample TUI Script of :ref:`tui_binormal_pipe` operation.
 
 Pipe by object, path and locations
 ----------------------------------
 
-The pipe is generated to preserve selected profiles at the specified locations along path.
+The pipe is generated to preserve selected profiles at the specified locations along the path.
 
 .. image:: images/Pipe3.png
   :align: center
@@ -110,12 +116,18 @@ The pipe is generated to preserve selected profiles at the specified locations a
 Input fields:
 
 - **Base objects** panel contains shapes to be extruded.  Shapes (edges, faces, shells) are selected in 3D OCC viewer or object browser;
-- **Path object**  defines path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
-- **Locations** define list of vertices that specify the locations of extruded Base Objects on the resulting Path Object. The number of Base Objects should be equal to the number of Locations.
+- **Path object**  defines the path along which the Base Object will be extruded.  **Path object** (edge or wire) is selected in 3D OCC viewer or object browser;
+- **Locations** define the list of vertices that specify the locations of extruded Base Objects on the resulting Path Object. The number of Base Objects should be equal to the number of Locations.
+
+**TUI Command**:
 
-**TUI Command**:  *model.addPipe(Part_doc, [shape], path, locations)*
+.. py:function:: model.addPipe(Part_doc, [shape], path, locations)
  
-**Arguments**: part + list of shapes in format *model.selection(TYPE, shape)* + path in format *model.selection(TYPE, shape)* + list of locations in format *model.selection(TYPE, shape)*.
+    :param part: The current part object.
+    :param list: A list of shapes in format *model.selection(TYPE, shape)*.
+    :param object: A path in format *model.selection(TYPE, shape)*.
+    :param list: A list of locations in format *model.selection(TYPE, shape)*.
+    :return: Created object.
 
 Result
 """"""
@@ -128,4 +140,4 @@ Result of extrusion of 3 circles along arc with specified locations.
 .. centered::
    Pipe by object, path and locations
 
-**See Also** a sample TUI Script of :ref:`tui_locations_pipe` operation.
\ No newline at end of file
+**See Also** a sample TUI Script of :ref:`tui_locations_pipe` operation.
\ No newline at end of file