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
  57 elements existing in the source mesh to the newly created mesh.</li>
  58 </ul>
  59 </li>
  60
  61 </li>
  62
  63 <li>activate <b>Preview</b> checkbox to show the result of transformation in the viewer </li>
  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 */