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