geom/doc/salome/gui/GEOM/input/scale_operation.doc

/*!

\page scale_operation_page Scale Transform

\n To produce a <b>Scale Transform</b> in the <b>Main Menu</b> select
<b>Operations - > Transformation - > Scale Transform</b>

\n This operation creates a scaled shape basing on the initial
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.

\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 of scaling by different factors along axes:</b>

\image html scale_transformsn3.png "The initial object"

\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 "Scale Transformation" and of \ref swig_scale "Scale Along Axes Transformation"

*/