Salome HOME
Merge from V6_main_20120808 08Aug12
[modules/smesh.git] / doc / salome / gui / SMESH / input / translation.doc
index 45565acaa6f8a29491df96acd3149893782d76ee..56c1dfb05abd4cf6e9418f0595582db76c6957ff 100644 (file)
@@ -5,45 +5,70 @@
 \n This geometrical operation allows to translate in space your mesh
 or some of its elements.
 
+<em>To translate a mesh:</em>
+
+<ol>
+<li>From the \b Modification menu choose \b Transformation -> \b Translation item  or click
+<em>"Translation"</em> button in the toolbar.
+
 \image html translation.png "Translation button"
 
-<em>To translate your mesh:</em>
-\par
-From the \b Modification choose \b Transformation and from its
-sub-menu select the \b Translation item. The following dialog box
-shall appear:
+One of the following dialogs will appear:
+
+It is possible to define the vector of thanslation:
+\image html translation1.png "by two points"
 
-\image html translation1.png
+\image html translation2.png "by the vector from the origin of coordinates" 
 
-\image html translation2.png
+</li>
+
+<li>
+In the dialog:
+<ul>
+<li>specify the IDs of the translated elements:
 
-\par
-This operation has two options, you can translate in space your mesh
-or some of its elements specifying:
 <ul>
-<li>two points (starting and ending)</li>
-<li>one vector</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; or</li>
+<li>choose mesh elements with the mouse in the 3D Viewer. It is
+possible to select a whole area with a mouse frame; or</li> 
+<li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
+viewer; or</li>
+<li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
+about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
 </ul>
+</li>
 
+<li>specify the vector of translation:
 <ul>
-<li>Select elements for the translation operation
+<li>specify the cooordinates of the start and end \b Points of the
+vector of translation; or</li>
+<li>specify the end point of the \b Vector of rotation starting at the
+origin of coordinates.</li>
+</ul>
+</li>
+
+<li>specify the conditions of translation:
 <ul>
-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li>activate <b>Move elements</b> radio button to create  the source
+mesh (or elements) at the new location and erase it from the previous location;</li>
+<li>activate <b>Copy elements</b> radio button to create the source
+mesh (or elements) at the new location, but leave it at the previous
+location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
+<li>activate <b>Create as new mesh</b> radio button to leave the
+source mesh (or elements) at its previous location and create a new
+mesh at the new location, the new mesh appears in the Object Browser
+with the default name MeshName_rotated (it is possible to change this
+name in the adjacent box);</li>
+<li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
 </ul>
 </li>
-<li>When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location</li>
-<li>When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.</li>
-<li>When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_translated (you can change this name in the adjacent box).</li>
-<li><b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.</li>
+
+<li>activate <b>Preview</b> checkbox to show the result of transformation in the viewer </li>
+<li>click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
 </ul>
+</ol>
 
-<br><b>See Also</b> a sample TUI Script of a 
-\ref tui_translation "Translation" operation.  
+<br><b>See Also</b> a sample TUI Script of a \ref tui_translation "Translation" operation.  
 
 */