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
  52 the result of the scale operation;</li>
  53 <li>activate <b>Create as new mesh</b> radio button to leave the
  54 source mesh (or elements) at its previous location and create a new
  55 mesh at the new location, the new mesh appears in the Object Browser
  56 with the default name MeshName_scaled (it is possible to change this
  57 name in the adjacent box);</li>
  58 <li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
  59 </ul>
  60 </li>
  61
  62 </li>
  63
  64 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
  65 </ol>
  66
  67
  68
  69 <b>Examle of using:</b>
  70
  71 1. Create quandrangle mesh 3x3 on simple planar face (200x200)
  72
  73 \image html scaleinit01.png
  74
  75 and union 3 face (along axis Z) to group "gr_faces"
  76
  77 \image html scaleinit02.png
  78
  79
  80
  81 2. Perform scale opration for whole mesh with creation of new mesh:
  82
  83 \image html scale03.png
  84
  85 result after operation:
  86
  87 \image html scaleres03.png
  88
  89
  90
  91 3. Perform scale operation for whole mesh with copy of elements:
  92
  93 \image html scale04.png
  94
  95 result after operation:
  96
  97 \image html scaleres04.png
  98
  99
 100
 101 4. Perform scale opration for group of faces with copy of elements:
 102
 103 \image html scale06.png
 104
 105 result after operation:
 106
 107 \image html scaleres06.png
 108
 109
 110
 111 5. Perform scale opration for two edges with moving of elements:
 112
 113 \image html scale07.png
 114
 115 result after operation:
 116
 117 \image html scaleres07.png
 118
 119
 120
 121 6. Perform scale opration for one face with moving of elements:
 122
 123 \image html scale09.png
 124
 125 result after operation:
 126
 127 \image html scaleres09.png
 128
 129
 130 <br><b>See Also</b> a sample TUI Script of a \ref tui_scale "Scale" operation.
 131
 132
 133 */