doc/salome/gui/VISU/input/viewing_3d_presentations.doc

   1 /*!
   2
   3 \page viewing_3d_presentations_page Viewing 3D presentations
   4
   5 Each  newly created presentation is displayed in the <b>VTK 3D
   6 Viewer</b>. <b>VTK 3D Viewer</b> is described in details in the
   7 documentation on GUI module.
   8
   9 To display an existing presentation, right-click on it in the
  10 Object Browser and select \b Show.
  11
  12 \image html viewing3.png
  13
  14 Right mouse-click on the Presentation gives access to the following
  15 options:
  16
  17 \image html viewing1.png
  18
  19 \note All parameters are context-sensitive: NOT all types of
  20 visualization and NOT all properties can be set for a certain 3D
  21 presentation.
  22
  23 - <b>Hide all</b> - allows to hide all objects from the
  24 viewer.
  25
  26 - <b>Edit</b> - allows to return to the menu, where the presentation
  27 has been created and change its parameters.
  28
  29 - \anchor filter_by_scalars_anchor <b>Filter by Scalars</b> - allows
  30 showing only the cells with values that fit into the defined
  31 <b>Scalar Range</b>.
  32
  33 \image html viewing2.png
  34
  35 In the dialog box, check in <b>Filter by scalar range</b> box and input
  36 the minimum and the maximum values for the <b>Scalar Range</b>.
  37
  38 \image html viewing4.png
  39
  40 - \anchor rename_anchor <b>Rename</b> - allows to rename the presentation.
  41 - <b>Copy</b> - allows to create a copy of the presentation in the
  42 same subfolder (time stamp) in the Object Browser.
  43
  44 - <b>Values Labeling</b> allows to display values applied to the
  45 cells or nodes of a 3D presentation.
  46
  47 \image html values_labeling.png
  48
  49 \anchor labeling_parameters_anchor
  50
  51 - <b>Labeling Parameters</b> allows to change such labeling parameters as font and color.
  52
  53 \image html labeling_parameters.png
  54
  55 - <b>Hide</b> - allows to hide the selected presentation from the
  56 viewer.
  57 - If selected in the Object Browser, <b>Hide</b> is replaced by
  58 <b>Show</b>, which allows to display the selected presentation in the
  59 viewer.
  60 - <b>Show Only</b> - allows to display only the selected
  61 presentation, hiding all other from the viewer.
  62
  63 - <b>Hide Scalar Bar</b>/<b>Show Scalar Bar</b> - allows to show/hide the scalar bar
  64 attached to the 3d presentation.
  65
  66 - <b>Representation</b> - allows to switch among the available
  67 representation types.\n\n\image html viewing10.png
  68   - <b>Points</b> \image html viewing5.png
  69   - <b>Surface</b> \image html viewing6.png
  70   - <b>Wireframe</b> \image html viewing7.png
  71   - <b>Insideframe</b> - displays the wires lying within the object \image html viewing8.png
  72   - <b>Surfaceframe</b> - displays wires and cells lying on the object surface \image html viewing9.png
  73   - <b>Feature edges</b> - shows the contour of the object \image html viewing11.png
  74   - <b>Shrink</b> \image html viewing12.png
  75   - <b>Shading on</b> - colors the object in a realistic way,
  76     revealing its geometry, for example, by applying shadows to the
  77     inside regions; used together with \b Surface.
  78   - <b>Shading off</b> - colors the object basing only on scalar values.
  79
  80 - <b>2D Quadratic</b> - allows to choose how the quadratic elements
  81 are visualized: as straight lines or as arcs of circle.
  82
  83 \image html quadratic.png
  84
  85 - \b Properties
  86   - \b Opacity - allows to set the value of opacity of the
  87   presentation between 0 (transparent) and 100 (opaque).
  88   \note For a \ref gauss_points_presentations_page "Gauss Points"
  89   presentation, displayed using <b>Point Sprites</b> or <b>OpenGL
  90   Points</b> \ref primitive_types_page "primitives", this property
  91   only allows switching between transparent and opaque modes. The
  92   textures are drawn in the opaque mode if the opacity is equal to
  93   100% and in the transparent mode if the opacity is lower that 100%
  94   (note that they become invisible when the opacity is equal to
  95   0%).\n\n \image html viewing13.png
  96   - <b>Line Width</b> - allows to set the width of lines representing
  97     edges of the presentation between 1 (thin) and 100 (thick).\n\n
  98     \image html line_width.png
  99   - <b>Shrink Factor</b> - allows to set the shrink factor of the
 100   presentation to be used in \b Shrink mode. Possible values range
 101   between 20 and 100, the default value is 80.\n\n \image html
 102   shrink_factor.png
 103   - <b>Edge Color</b> - allows to set the color of lines representing
 104   the edges of the presentation displayed in SurfaceFrame mode.
 105
 106 - \ref translate_presentation_page "Translate Presentation" - allows
 107 to translate the presentation along coordinate axes.
 108 - \ref clipping_page "Clipping Planes" - allows to create
 109 cross-section views of presentations.
 110 - \ref sweeping_page "Sweep" - allows to display pseudo-animation of
 111 the presentation.
 112
 113 - <b>Dump view</b> - exports an object from the viewer in bmp, png,
 114 jpg or jpeg image format.
 115 - <b>Change Background</b> - allows to change the properties of the
 116 background.
 117
 118 - <b>View Operations</b> checkbox - shows or hides the VTK viewer
 119 toolbar. The information about the VTK viewer functionalities is
 120 available in the documentation on the GUI module.
 121 - <b>Recording operations</b> checkbox - shows or hides buttons used
 122 for \ref recording_page "Recording".
 123
 124 The following menu items are added when the presentation is
 125 selected in the Object Browser.
 126
 127 - \b Delete - removes the presentation from the study.
 128 - \b Refresh - updates the presentation in the VTK viewer.
 129 - \b Find - activates <b> Find Tool</b> described in the documentation
 130   on GUI module.
 131
 132 When you create several presentations of the same object, you may wish
 133 to see them simultaneously,  which might be impossible, because they
 134 all are located at the same place. To solve this problem, right-click
 135 in the viewer and select <b>Arrange Actors</b> in the pop-up menu.
 136
 137 \image html arrangeactors.png
 138
 139 In \b Auto mode you specify along which \b Axis and at which
 140 <b>Relative Distance</b> the presentations should be lined up.
 141
 142 \image html arrangeactors1.png
 143
 144 In \b Manual mode you set the coordinates for each presentation
 145 separately.
 146
 147 Displaying several presentations at the same time may cause
 148 superposition of their scalar bars. To avoid this, check <b>Arrange
 149 Scalar Bars</b> radio button  in the <b>Preferences -> Post-Pro ->
 150 Scalar Bar</b>. A separate scalar bar will be displayed for each
 151 presentation.
 152
 153 Alternatively you may wish to merge the scalar bars to have a
 154 common scalar bar for all presentations. To do this, select several
 155 presentations or fields in the object browser, right-click and from
 156 the pop-up menu select <b>Merge Scalar Range</b>.
 157
 158 To restore separate bars and scales for each module select <b>Use
 159 Field Range</b> from the same menu.
 160
 161 */