mirror of
https://git.salome-platform.org/gitpub/modules/geom.git
synced 2024-12-26 17:30:35 +05:00
83 lines
3.5 KiB
Plaintext
83 lines
3.5 KiB
Plaintext
/*!
|
|
|
|
\page multi_translation_operation_page Multi Translation
|
|
|
|
\n To produce a <b>Multi Translation</b> in the <b>Main Menu</b>
|
|
select <b>Operations - > Transformation - > Multi Translation</b>
|
|
|
|
\n This operation makes several translations of a shape in \b one or \b
|
|
two directions.
|
|
\n The \b Result will be one \b GEOM_Object (compound). The total
|
|
number of shape copies in the resulting compound will be equal to:
|
|
- in case of \ref single_multi_translation "Simple multi translation":
|
|
\a NbTimes (if \a NbTimes parameter is equal to 1, the result will
|
|
contain only the initial non-translated shape).
|
|
- in case of \ref double_multi_translation "Double multi translation":
|
|
\a NbTimes1 x \a NbTimes2 (if \a NbTimes1 and \a NbTimes2 parameters
|
|
are both equal to 1, the result will contain a single non-translated
|
|
initial shape).
|
|
|
|
\anchor single_multi_translation
|
|
|
|
In case of <b>Simple Multi Translation</b> the object is translated in one direction.
|
|
|
|
\image html mtrans1.png
|
|
|
|
The following parameters and options can be defined in this dialog:
|
|
- <b>Result Name</b>;
|
|
- <b> Main Object </b> to be translated;
|
|
- \b Vector of translation (DX by default). If a curve has been
|
|
selected instead of the Vector, only its first and last vertices will
|
|
be used to get the vector direction and the dialog preview will
|
|
display the vector along which the object will be translated;
|
|
- <b>Step</b> is the distance between the shape copies;
|
|
- <b>Nb. Times</b> is the number of shape copies;
|
|
- <b>Reverse Direction </b> checkbox allows changing the direction of translation;
|
|
- \ref restore_presentation_parameters_page "Advanced options".
|
|
|
|
\image html multi_translation_initialsn.png "The initial object"
|
|
|
|
\image html multi_translation1dsn.png "The result of a simple multi-translation"
|
|
|
|
\n <b>TUI Command:</b> <em>geompy.MakeMultiTranslation1D(Shape, Dir,
|
|
Step, NbTimes)</em>
|
|
\n <b>Arguments:</b> Name + 1 shape + 1 vector (for direction) + 1
|
|
step value + 1 value (repetition).
|
|
|
|
\anchor double_multi_translation
|
|
|
|
In case of <b>Double Multi Translation</b> the object is translated in two directions.
|
|
|
|
\image html mtrans2.png
|
|
|
|
The following parameters and options can be defined in this dialog:
|
|
- <b>Result Name</b>;
|
|
- <b> Main Object </b> to be translated;
|
|
- <b> Vector U/V</b> of translation (DX and DY by default). If a curve has been
|
|
selected instead of the Vector, only its first and last vertices will
|
|
be used to get the vector direction and the dialog preview will
|
|
display the vector along which the object will be translated;
|
|
- <b>Step U/V</b> is the distance between the shape copies;
|
|
- <b>Nb. Times U/V</b> is the number of shape copies;
|
|
- <b>Reverse U/V </b> checkbox allows changing the direction of translation;
|
|
- \ref restore_presentation_parameters_page "Advanced options".
|
|
|
|
\image html multi_translation_initialsn.png "The initial object"
|
|
|
|
\image html multi_translation2dsn.png "The result of a double multi-translation"
|
|
|
|
\n <b>TUI Command:</b> <em>geompy.MakeMultiTranslation2D(Shape, Dir1,
|
|
Step1, NbTimes1, Dir2, Step2, NbTimes2),</em> where \em Shape is a shape
|
|
to be translated, \em Dir1 is the first direction of translation, \em Step1 of
|
|
the first translation, \em NbTimes1 is a number of translations to be done
|
|
along \em Dir1, \em Dir2 is the second direction of translation, \em Step2 of the
|
|
second translation, \em NbTimes2 is a number of translations to be done
|
|
along \em Dir2.
|
|
\n <b>Arguments:</b> Name + 1 shape + 2 vectors defining the direction
|
|
+ 2 step values + 2 values (repetitions).
|
|
|
|
Our <b>TUI Scripts</b> provide you with useful examples of the use of
|
|
\ref tui_multi_translation "Transformation Operations".
|
|
|
|
*/
|