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 axes:
  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 </ul>
  66 </ol>
  67
  68
  69
  70 <b>Example of using:</b>
  71
  72 1. Create quandrangle mesh 3x3 on a simple planar face (200x200)
  73
  74 \image html scaleinit01.png
  75
  76 and union 3 faces (along axis Z) to group "gr_faces"
  77
  78 \image html scaleinit02.png
  79
  80
  81
  82 2. Perform scale operation for the whole mesh and create a new mesh:
  83
  84 \image html scale03.png
  85
  86 result after operation:
  87
  88 \image html scaleres03.png
  89
  90
  91
  92 3. Perform scale operation for the whole mesh and copy elements:
  93
  94 \image html scale04.png
  95
  96 result after operation:
  97
  98 \image html scaleres04.png
  99
 100
 101
 102 4. Perform scale operation for a group of faces and copy elements:
 103
 104 \image html scale06.png
 105
 106 result after operation:
 107
 108 \image html scaleres06.png
 109
 110
 111
 112 5. Perform scale operation for two edges and move elements:
 113
 114 \image html scale07.png
 115
 116 result after operation:
 117
 118 \image html scaleres07.png
 119
 120
 121
 122 6. Perform scale operation for one face and move elements:
 123
 124 \image html scale09.png
 125
 126 result after operation:
 127
 128 \image html scaleres09.png
 129
 130
 131 <br><b>See Also</b> a sample TUI Script of a \ref tui_scale "Scale" operation.
 132
 133
 134 */