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

57 lines
2.2 KiB
Plaintext

/*!
\page multi_rotation_operation_page Multi Rotation
\n To produce a <b>Multi Rotation</b> in the <b>Main Menu</b> select
<b>Operations - > Transformation - > Multi Rotation</b>
\n This operation creates several geometrical objects rotated in one
or two dimensions basing on the initial geometrical object.
\n The \b Result will be one or several \b GEOM_Objects (compound).
\n To produce a <b>Simple Multi Rotation</b> (in one dimension) you
need to define a \b Shape to be rotated, an \b Axis of rotation and a
<b>Number of Times</b> the shape must be rotated. <b>Rotation Angle</b> will
be 2*PI/NbTimes
\n <b>TUI Command:</b> <em>geompy.MultiRotate1D(Shape, Axis, NbTimes)</em>
\n <b>Arguments:</b> Name + 1 shape + 1 vector for direction + 1 value
(repetition).
\b <b>NB!</b> There is another way to execute a Multi-rotation
operation, which is currently accessible only via TUI commands:
<em>geompy.MakeMultiRotation1D(Shape, Dir, Point, NbTimes)</em> which works in
the same way, but the Axis is defined by direction and point.
\image html neo-mrot1.png
\image html multi_rotation1d1.png
\image html multi_rotation1d2.png
\n <b>Double Multi Rotation</b> (in two dimensions) rotates the given
\b Object around the given \b Axis on the given \b Angle a given
<b>Number of Times</b> and multi-translates each rotation
result. Translation direction passes through the center of gravity of
the rotated shape and its projection on the rotation axis.
\b Reverse checkbox allows to set the direction of rotation.
\n <b>TUI Command:</b> <em>geompy.MultiRotate2D(Shape, Axis, Angle, NbTimes1, Step, NbTimes2)</em>
\n <b>Arguments:</b> Name + 1 shape + 1 vector for direction + 1 angle
+ 1 value (repetition) + 1 step value + 1 value (repetition).
<b>NB!</b> There is another way to execute a Double Multi-rotation
operation, which is currently accessible only via TUI commands:
<em>geompy.MakeMultiRotation2D(Shape, Dir, Point, Angle, nbtimes1, Step,nbtimes2)</em>
which works in the same way,
but the Axis is defined by direction and point.
\image html neo-mrot2.png
\image html multi_rotation2d1.png
\image html multi_rotation2d2.png
Our <b>TUI Scripts</b> provide you with useful examples of the use of
\ref tui_multi_rotation "Transformation Operations".
*/