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

   1 /*!
   2
   3 \page scale_operation_page Scale Transform
   4
   5 \n To produce a <b>Scale Transform</b> in the <b>Main Menu</b> select
   6 <b>Operations - > Transformation - > Scale Transform</b>
   7
   8 \n This operation creates a scaled shape basing on the initial
   9 shape. For this, you need to define the \b Shape to be scaled, the
  10 <b>Central Point</b> of scale and the Scale Factor(s).
  11 \n The \b Result will be a \b GEOM_Object.
  12 \n <b>Advanced option:</b>
  13    \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
  14
  15 \image html transformation10.png
  16 \n <b>TUI Command:</b> <em>geompy.MakeScaleTransform(Shape, CenterOfScale, Factor)</em>
  17 \n <b>Arguments:</b> Name + 1 shape(s) + 1 vertex + 1 Scale Factor.
  18
  19 \image html transformation10a.png
  20 \n <b>TUI Command:</b> <em>geompy.MakeScaleAlongAxes(Shape, CenterOfScale, FactorX, FactorY, FactorZ)</em>
  21 \n <b>Arguments:</b> Name + 1 shape(s) + 1 vertex + 3 Scale Factors.
  22
  23 \note If the <b>Central Point</b> is not defined, the scaling will be
  24 performed relatively the origin of the global coordinate system.
  25
  26 \note Scaling by one factor is a simple transformation, it does not modify the
  27 geometry of the shape, while scaling by several different factors along axes
  28 is a general transformation, which can modify the geometry, for example, a
  29 circle can be transformed into an ellipse.
  30
  31 \n <b>Example of simple scaling:</b>
  32
  33 \image html scale_transformsn1.png
  34
  35 \image html scale_transformsn2.png
  36
  37 \n <b>Example of scaling by different factors along axes:</b>
  38
  39 \image html scale_transformsn3.png
  40
  41 \image html scale_transformsn4.png
  42
  43 Our <b>TUI Scripts</b> provide you with useful examples of the use of
  44 \ref tui_scale "Scale Transformation" and of \ref swig_scale "Scale Along Axes Transformation"
  45
  46 */