Salome HOME
Merge remote branch 'origin/akl/22379'
[modules/geom.git] / doc / salome / gui / GEOM / input / translation_operation.doc
index 32958367d12e6e75ba2b7ccd233b734f91523f8c..4ebe45b14b92ef6d7b0f3d180534b76210988479 100644 (file)
@@ -7,37 +7,37 @@
 
 This Operation makes a translation of an \b Object. To translate a
 shape you need to define the base shape and the coordinates of the
-vector of translation. <b>Create a copy</b> checkbox allows to keep the
-initial object, otherwise it will be removed.
+vector of translation. 
+\n <b>Create a copy</b> checkbox allows to keep the initial object, otherwise it will be removed. 
+\n \ref restore_presentation_parameters_page "Advanced options".
 \n The \b Result of all operations will be any \b GEOM_Object.
 
-\n Firstly you can define an \b Object and the vector coordinates along the
+The \b Vector of translation can be defined in three different ways selectable using the radio buttons. 
+
+\n Firstly you can define the \b Vector by coordinates along the
 axes.
 \n <b>TUI Command:</b> <em>geompy.MakeTranslation(Shape, DX, DY,
 DZ),</em> where Shape is a shape to be translated, DX, DY, DZ are
 components of translation vector.
 \n <b>Arguments:</b> Name + one or several objects + 3 values (coordinates).
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
 
 \image html transformation1.png
 
-\n Secondly you can define an \b Object and the start and the end points
-of the vector.
+\n Secondly you can define the \b Vector by the start and the end points.
 \n <b>TUI Command:</b> <em>geompy.MakeTranslationTwoPoints(Object, Point1, Point2)</em>
 \n <b>Arguments:</b> Name + one or several objects + 2 vertices
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
+
 
 \image html transformation2.png
 
-\n Finally you can define an \b Object and the vector. The object will be translated by the length of the vector.  
-\n <b>TUI Command:</b> <em>geompy.MakeTranslationVector(Object, Vector)</em>
-\n <b>Activate Distance</b> checkbox and <b>Distance</b> field allow defining the custom distance of translation.
-\n <b>TUI Command </b> for translation by vector and custom distance: <em>geompy.MakeTranslationVectorDistance(Object, Vector, Distance)</em> 
+\n Finally you can define the \b Vector explicitely. The \b Object will be translated by the length of the vector. 
+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. 
+\n <b>Activate Distance</b> checkbox and <b>Distance</b> field allow defining a custom distance of translation.
+
+
+\n <b>TUI Command:</b> for translation by vector: <em>geompy.MakeTranslationVector(Object, Vector)</em>
+\n <b>TUI Command </b> for translation by vector and a custom distance: <em>geompy.MakeTranslationVectorDistance(Object, Vector, Distance)</em> 
 \n <b>Arguments:</b> Name + one or several objects + 1 vector.
-\n <b>Advanced option:</b>
-   \ref restore_presentation_parameters_page "Set presentation parameters and subshapes from arguments".
 
 \image html transformation3.png