mirror of
https://git.salome-platform.org/gitpub/modules/geom.git
synced 2024-11-12 00:29:18 +05:00
62 lines
2.7 KiB
Plaintext
62 lines
2.7 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 * \a PI / \a NbTimes. Number of shapes in the resulting compound will be equal
|
|
to \a NbTimes (if \a NbTimes = 1, the result will contain only the initial
|
|
non-transformed shape).
|
|
\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 "The initial object"
|
|
|
|
\image html multi_rotation1d2.png "The result of a simple multi-rotation"
|
|
|
|
\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. Number of
|
|
shapes in the resulting compound will be equal to \a NbTimes1 x \a NbTimes2 (if
|
|
both \a NbTimes1 and \a NbTimes2 are equal to 1, the result will contain
|
|
only the initial non-transformed shape).
|
|
\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 "The initial object"
|
|
|
|
\image html multi_rotation2d2.png "The result of a double multi-rotation"
|
|
|
|
Our <b>TUI Scripts</b> provide you with useful examples of the use of
|
|
\ref tui_multi_rotation "Transformation Operations".
|
|
|
|
*/
|