X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FFeaturesPlugin%2Fdoc%2FtransformationFeature.rst;h=6e859459258c6a9456f72157b1ab7157a6b6be27;hb=0fcd69345a4dfdb31e252574c68bc70e123999e8;hp=5e8f204d7a60055e80ee89bc1ff932bfde119d50;hpb=547a3952b37fe76f0d4e031a7d8a943ac6a45bb5;p=modules%2Fshaper.git

diff --git a/src/FeaturesPlugin/doc/transformationFeature.rst b/src/FeaturesPlugin/doc/transformationFeature.rst
index 5e8f204d7..6e8594592 100644
--- a/src/FeaturesPlugin/doc/transformationFeature.rst
+++ b/src/FeaturesPlugin/doc/transformationFeature.rst
@@ -1,17 +1,101 @@
+.. |scale.icon|    image:: images/scale.png
 
 Scale
 =====
 
+**Scale** feature makes a scaled shape basing on the initial shape.
+
+To create a Scale in the active part:
+
+#. select in the Main Menu *Features - > Scale* item  or
+#. click |scale.icon| **Scale** button in the toolbar
+
+Two Scale algorithms are:
+
+  .. image:: images/scale_factor_32x32.png    
+    :align: left
+  by one common factor 
+
+  .. image:: images/scale_dimensions_32x32.png    
+    :align: left
+  by different factors along axes
+
+Scale by one common factor
+--------------------------
+
+Scale by one common factor scales the entire object without modification the geometry of the shape: dimensions change evenly in all three orthogonal directions.
 
 .. image:: images/Scale1.png
   :align: center
 
 .. centered::
-  Scale: define by a one common factor
+  Scale by one common factor property panel
+
+Input fields:
+
+- **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser;
+- **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
+- **Scale factor** defines the multiplier of axial dimensions. If Scale Factor is negative, the object is mirrored through the Central Point. 
+
+**TUI Command**:
+
+.. py:function:: model.addScale(Part_doc, [shape], center, factor)
+ 
+    :param part: The current part object.
+    :param list: A list of shapes in format *model.selection(TYPE, shape)*.
+    :param object: A center point in format *model.selection(TYPE, shape)*.
+    :param real: Scale factor.
+    :return: Result object.
+
+Result
+""""""
+
+Result of operation is transformed initial shape shown in wireframe mode together  with initial shape in shading mode.
+
+.. image:: images/Scale_common_factor.png
+   :align: center
+
+.. centered::
+   Scale by one common factor
+
+**See Also** a sample TUI Script of :ref:`tui_Scale_common_factor` operation.  
+
+Scale by different factors along axes
+-------------------------------------
 
+Scale by different factors along axes is a general transformation, which can modify the geometry, for example, a sphere can be transformed into an ellipsoid.
 
 .. image:: images/Scale2.png
   :align: center
 
 .. centered::
-  Scale: define by different factors
+  Scale: define by different factors property panel
+
+Input fields:
+
+- **Main objects** panel contains shapes to be scaled. Shapes are selected in 3D OCC viewer or object browser;
+- **Center point** defines the point relatively to which the object is scaled. Point is selected in 3D OCC viewer or object browser;
+- **Scale factor in X**, **Scale factor in Y**, **Scale factor in Z** define the the multipliers of axial dimensions.  If Scale Factor is negative, the object is mirrored through the Central Point. 
+
+**TUI Command**:
+
+.. py:function:: model.addScale(Part_doc, [shape], center, factors)
+ 
+    :param part: The current part object.
+    :param list: A list of shapes in format *model.selection(TYPE, shape)*.
+    :param object: A center point in format *model.selection(TYPE, shape)*.
+    :param list: A list of three scale factor values along X. Y, Z axes.
+    :return: Result object.
+
+Result
+""""""
+
+Result of operation is transformed initial shape.
+
+.. image:: images/Scale_XYZ.png
+   :align: center
+
+.. centered::
+   Scale by different factors
+
+**See Also** a sample TUI Script of :ref:`tui_Scale_XYZ` operation.
\ No newline at end of file