Salome HOME
Merge branch 'V8_4_BR'
[modules/smesh.git] / doc / salome / gui / SMESH / input / scale.rst
1 .. _scale_page:
2
3 *****
4 Scale
5 *****
6
7 This geometrical operation allows to scale in space your mesh or some of its elements.
8
9 **To scale a mesh:**
10
11 #. From the **Modification** menu choose **Transformation** -> **Scale Transform** item.
12         One of the following dialogs will appear:
13
14         With one scale factor:
15
16         .. image:: ../images/scale01.png
17                 :align: center
18
19         Or with different scale factors for axes:
20
21         .. image:: ../images/scale02.png
22                 :align: center
23
24 #. In the dialog:
25         * specify the IDs of the translated elements:
26                 * **Select the whole mesh, submesh or group** activating this checkbox; or
27                 * choose mesh elements with the mouse in the 3D Viewer. It is possible to select a whole area with a mouse frame; or 
28                 * input the element IDs directly in **ID Elements** field. The selected elements will be highlighted in the viewer; or
29                 * apply Filters. **Set filter** button allows to apply a filter to the selection of elements. See more about filters in the :ref:`selection_filter_library_page` page.
30
31         * specify the base point for scale
32
33         * specify the scale factor
34
35         * specify the conditions of scale:
36
37                 * activate **Move elements** radio button to scale the selected mesh (or elements) without creating a copy;
38                 * activate **Copy elements** radio button to duplicate the selected mesh (or elements) and to apply scaling to the copy within the same mesh;
39                 * activate **Create as new mesh** 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);
40                 * activate **Copy groups** checkbox to copy the groups of elements existing in the source mesh to the newly created mesh.
41
42         * activate **Preview** checkbox to show the result of transformation in the viewer 
43         * click **Apply** or **Apply and Close** button to confirm the operation.
44
45
46 **Example of using:**
47
48 #. Create quandrangle mesh 3x3 on a simple planar face (200x200)
49
50         .. image:: ../images/scaleinit01.png
51                 :align: center
52
53         and union 3 faces (along axis Z) to group "gr_faces"
54
55         .. image:: ../images/scaleinit02.png
56                 :align: center
57
58
59
60 #. Perform scale operation for the whole mesh and create a new mesh:
61
62         .. image:: ../images/scale03.png
63                 :align: center
64
65         result after operation:
66
67         .. image:: ../images/scaleres03.png
68                 :align: center
69
70 #. Perform scale operation for the whole mesh and copy elements:
71
72         .. image:: ../images/scale04.png
73                 :align: center
74
75         result after operation:
76
77         .. image:: ../images/scaleres04.png
78                 :align: center
79
80 #. Perform scale operation for a group of faces and copy elements:
81
82         .. image:: ../images/scale06.png
83                 :align: center
84
85         result after operation:
86
87         .. image:: ../images/scaleres06.png
88                 :align: center
89
90
91
92 #. Perform scale operation for two edges and move elements:
93
94         .. image:: ../images/scale07.png
95                 :align: center
96
97         result after operation:
98
99         .. image:: ../images/scaleres07.png
100                 :align: center
101
102
103
104 #. Perform scale operation for one face and move elements:
105
106         .. image:: ../images/scale09.png
107                 :align: center
108
109         result after operation:
110
111         .. image:: ../images/scaleres09.png
112                 :align: center
113
114
115 **See Also** a sample TUI Script of a :ref:`tui_scale` operation.  
116
117
118