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 scale the selected
  48 mesh (or elements) without creating a copy;</li>
  49 <li>activate <b>Copy elements</b> radio button to duplicate the selected
  50 mesh (or elements) and to apply scaling to the copy within the same mesh;</li>
  51 <li>activate <b>Create as new mesh</b> radio button to leave the
  52 selected mesh (or elements) at its previous location and create a new
  53 mesh of the scaled copy of the selected elements; the new mesh appears in the Object Browser
  54 with the default name MeshName_scaled (it is possible to change this
  55 name in the adjacent box);</li>
  56 <li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
  57 </ul>
  58 </li>
  59
  60 </li>
  61
  62 <li>activate <b>Preview</b> checkbox to show the result of transformation in the viewer </li>
  63 <li>click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
  64 </ul>
  65 </ol>
  66
  67
  68
  69 <b>Example of using:</b>
  70
  71 1. Create quandrangle mesh 3x3 on a simple planar face (200x200)
  72
  73 \image html scaleinit01.png
  74
  75 and union 3 faces (along axis Z) to group "gr_faces"
  76
  77 \image html scaleinit02.png
  78
  79
  80
  81 2. Perform scale operation for the whole mesh and create a 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 the whole mesh and copy 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 operation for a group of faces and copy 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 operation for two edges and move 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 operation for one face and move 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 */