Salome HOME
0022618: [CEA 1062] Define the transparency by default in the preferences
[modules/geom.git] / doc / salome / gui / GEOM / input / scale_operation.doc
index 65d8d9583b45cf4561f7df2003fbcb8580dd88a4..432d6d6b1b40780f1157e1131f4543e63ff0c7e9 100644 (file)
@@ -6,21 +6,53 @@
 <b>Operations - > Transformation - > Scale Transform</b>
 
 \n This operation creates a scaled shape basing on the initial
-shape. For this, you need to define the \b Shape to be scaled, the
-<b>Central Point</b> of scale and the Scale Factor.
-\n The \b Result will be a \b GEOM_Object.
+shape. 
+
+\n <b>Simple scale</b> scales the entire object (i.e. its dimensions change evenly in all three orthogonal directions). It does not modify the
+geometry of the shape.
+\image html transformation10.png
+
+The following parameters and options can be defined in this dialog:
+- <b>Result Name</b>;
+- One or several <b> Objects </b> to be scaled;
+- <b>Central Point</b> (optional) - relatively to which the object is scaled. If the <b>Central Point</b> is not defined, the scaling will be
+performed relatively the origin of the global coordinate system.
+- <b>Scale Factor</b> - the multiplier of axial dimensions. If <b>Scale Factor</b> is negative, the object is mirrored through the <b>Central Point</b>. 
+- \ref restore_presentation_parameters_page "Advanced options".
+
 \n <b>TUI Command:</b> <em>geompy.MakeScaleTransform(Shape, CenterOfScale, Factor)</em>
 \n <b>Arguments:</b> Name + 1 shape(s) + 1 vertex + 1 Scale Factor.
 
-\image html transformation10.png
+\n <b>Multiple scale</b> allows scaling by different factors along axes. This is a general transformation, which can modify the geometry, for example, a
+circle can be transformed into an ellipse. 
+
+\image html transformation10a.png
+
+The following parameters and options can be defined in this dialog:
+- <b>Result Name</b>;
+- One or several <b> Objects </b> to be scaled;
+- <b>Central Point</b> (optional) - relatively to which the object is scaled. 
+- <b>Scale Factor X/Y/Z</b> -  the multipliers of axial dimensions.  
+- \ref restore_presentation_parameters_page "Advanced options".
+
+\n <b>TUI Command:</b> <em>geompy.MakeScaleAlongAxes(Shape, CenterOfScale, FactorX, FactorY, FactorZ)</em>
+\n <b>Arguments:</b> Name + 1 shape(s) + 1 vertex + 3 Scale Factors.
+
+
+\n <b>Example of simple scaling:</b>
+
+\image html scale_transformsn1.png "The initial object"
+
+\image html scale_transformsn2.png "The resulting object (resized)"
 
-\n <b>Example:</b>
+\n <b>Example of scaling by different factors along axes:</b>
 
-\image html scale_transformsn1.png
+\image html scale_transformsn3.png "The initial object"
 
-\image html scale_transformsn2.png
+\image html scale_transformsn4.png "The resulting object (resized and distorted)"
 
 Our <b>TUI Scripts</b> provide you with useful examples of the use of
-\ref tui_scale "Transformation Operations".
+\ref tui_scale "Scale Transformation" and of \ref swig_scale "Scale Along Axes Transformation"
 
-*/
\ No newline at end of file
+*/