smesh/doc/salome/gui/SMESH/input/scale.doc
2011-06-06 08:15:39 +00:00

135 lines
3.0 KiB
Plaintext

/*!
\page scale_page Scale
\n This geometrical operation allows to scale in space your mesh
or some of its elements.
<em>To scale a mesh:</em>
<ol>
<li>From the \b Modification menu choose \b Transformation -> \b Scale
\b Transform item.
One of the following dialogs will appear:
With one scale factor:
\image html scale01.png
Or with different scale factors for axes:
\image html scale02.png
</li>
<li>
In the dialog:
<ul>
<li>specify the IDs of the translated elements:
<ul>
<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 base point for scale</li>
<li>specify the scale factor</li>
<li>specify the conditions of scale:
<ul>
<li>activate <b>Move elements</b> radio button to scale the selected
mesh (or elements) without creating a copy;</li>
<li>activate <b>Copy elements</b> radio button to duplicate the selected
mesh (or elements) and to apply scaling to the copy within the same mesh;</li>
<li>activate <b>Create as new mesh</b> radio button to leave the
selected mesh (or elements) at its previous location and create a new
mesh of the scaled copy of the selected elements; the new mesh appears in the Object Browser
with the default name MeshName_scaled (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 existing in the source mesh to the newly created mesh.</li>
</ul>
</li>
</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>
<b>Example of using:</b>
1. Create quandrangle mesh 3x3 on a simple planar face (200x200)
\image html scaleinit01.png
and union 3 faces (along axis Z) to group "gr_faces"
\image html scaleinit02.png
2. Perform scale operation for the whole mesh and create a new mesh:
\image html scale03.png
result after operation:
\image html scaleres03.png
3. Perform scale operation for the whole mesh and copy elements:
\image html scale04.png
result after operation:
\image html scaleres04.png
4. Perform scale operation for a group of faces and copy elements:
\image html scale06.png
result after operation:
\image html scaleres06.png
5. Perform scale operation for two edges and move elements:
\image html scale07.png
result after operation:
\image html scaleres07.png
6. Perform scale operation for one face and move elements:
\image html scale09.png
result after operation:
\image html scaleres09.png
<br><b>See Also</b> a sample TUI Script of a \ref tui_scale "Scale" operation.
*/