doc/salome/gui/SMESH/input/scale.doc

   1 /*!
   2
   3 \page scale_page Scale
   4
   5 \n This geometrical operation allows to scale in space your mesh
   6 or some of its elements.
   7
   8 <em>To scale a mesh:</em>
   9
  10 <ol>
  11 <li>From the \b Modification menu choose \b Transformation -> \b Scale
  12 \b Transform item.
  13
  14 One of the following dialogs will appear:
  15
  16 With one scale factor:
  17 \image html scale01.png
  18
  19 Or with different scale factors for axises:
  20 \image html scale02.png
  21
  22 </li>
  23
  24 <li>
  25 In the dialog:
  26 <ul>
  27 <li>specify the IDs of the translated elements:
  28
  29 <ul>
  30 <li><b>Select the whole mesh, submesh or group</b> activating this
  31 checkbox; or</li>
  32 <li>choose mesh elements with the mouse in the 3D Viewer. It is
  33 possible to select a whole area with a mouse frame; or</li>
  34 <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
  35 viewer; or</li>
  36 <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
  37 about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
  38 </ul>
  39 </li>
  40
  41 <li>specify the base point for scale</li>
  42
  43 <li>specify the scale factor</li>
  44
  45 <li>specify the conditions of scale:
  46 <ul>
  47 <li>activate <b>Move elements</b> radio button to create  the source
  48 mesh (or elements) at the new location and erase it from the previous location;</li>
  49 <li>activate <b>Copy elements</b> radio button to create the source
  50 mesh (or elements) at the new location, but leave it at the previous
  51 location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
  52 <li>activate <b>Create as new mesh</b> radio button to leave the
  53 source mesh (or elements) at its previous location and create a new
  54 mesh at the new location, the new mesh appears in the Object Browser
  55 with the default name MeshName_rotated (it is possible to change this
  56 name in the adjacent box);</li>
  57 <li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
  58 </ul>
  59 </li>
  60
  61 </li>
  62
  63 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
  64 </ol>
  65
  66
  67
  68 <b>Examle of using:</b>
  69
  70 1. Create quandrangle mesh 3x3 on simple planar face (200x200)
  71
  72 \image html scaleinit01.png
  73
  74 and union 3 face (along axis Z) to group "gr_faces"
  75
  76 \image html scaleinit02.png
  77
  78
  79
  80 2. Perform scale opration for whole mesh with creation of new mesh:
  81
  82 \image html scale03.png
  83
  84 result after operation:
  85
  86 \image html scaleres03.png
  87
  88
  89
  90 3. Perform scale operation for whole mesh with copy of elements:
  91
  92 \image html scale04.png
  93
  94 result after operation:
  95
  96 \image html scaleres04.png
  97
  98
  99
 100 4. Perform scale opration for group of faces with copy of elements:
 101
 102 \image html scale06.png
 103
 104 result after operation:
 105
 106 \image html scaleres06.png
 107
 108
 109
 110 5. Perform scale opration for two edges with moving of elements:
 111
 112 \image html scale07.png
 113
 114 result after operation:
 115
 116 \image html scaleres07.png
 117
 118
 119
 120 6. Perform scale opration for one face with moving of elements:
 121
 122 \image html scale09.png
 123
 124 result after operation:
 125
 126 \image html scaleres09.png
 127
 128
 129 <br><b>See Also</b> a sample TUI Script of a \ref tui_scale "Scale" operation.
 130
 131
 132 */