]> SALOME platform Git repositories - modules/visu.git/blobdiff - doc/salome/gui/VISU/input/viewing_3d_presentations.doc
Salome HOME
Merge from V5_1_main 14/05/2010
[modules/visu.git] / doc / salome / gui / VISU / input / viewing_3d_presentations.doc
index 890a53d7b55240c8231c456cbe3ad7e2d8516b38..0ea0cecc5ac7c5403da3cc83b9fb1eb0cac07104 100644 (file)
 
 \page viewing_3d_presentations_page Viewing 3D presentations
 
-<ul>
-<li>\subpage viewing_3d_presentations_intro_page</li>
-<li>\subpage translate_presentation_page</li>
-<li>\subpage clipping_page</li>
-<li>\subpage sweeping_page</li>
-<li>\subpage selection_info_page</li>
-</ul>
-
-*/
\ No newline at end of file
+Each  newly created presentation is displayed in the <b>VTK 3D
+Viewer</b>. <b>VTK 3D Viewer</b> is described in details in the
+documentation on GUI module.
+
+To display an existing presentation, right-click on it in the
+Object Browser and select \b Show.
+
+\image html viewing3.png
+
+Right mouse-click on the Presentation gives access to the following
+options:
+
+\image html viewing1.png
+
+\note All parameters are context-sensitive: NOT all types of
+visualization and NOT all properties can be set for a certain 3D
+presentation.
+
+- <b>Hide all</b> - allows to hide all objects from the
+viewer.
+
+- <b>Edit</b> - allows to return to the menu, where the presentation
+has been created and change its parameters.
+
+- \anchor filter_by_scalars_anchor <b>Filter by Scalars</b> - allows
+showing only the cells with values that fit into the defined
+<b>Scalar Range</b>.
+
+\image html viewing2.png
+
+In the dialog box, check in <b>Filter by scalar range</b> box and input
+the minimum and the maximum values for the <b>Scalar Range</b>.
+
+\image html viewing4.png 
+
+- \anchor rename_anchor <b>Rename</b> - allows to rename the presentation.
+- <b>Copy</b> - allows to create a copy of the presentation in the
+same subfolder (time stamp) in the Object Browser.
+
+- <b>Values Labeling</b> allows to display values applied to the
+cells or nodes of a 3D presentation.
+
+\image html values_labeling.png
+
+\anchor labeling_parameters_anchor
+
+- <b>Labeling Parameters</b> allows to change such labeling parameters as font and color.
+
+\image html labeling_parameters.png
+
+- <b>Hide</b> - allows to hide the selected presentation from the
+viewer.
+- If selected in the Object Browser, <b>Hide</b> is replaced by
+<b>Show</b>, which allows to display the selected presentation in the
+viewer.
+- <b>Show Only</b> - allows to display only the selected
+presentation, hiding all other from the viewer.
+
+- <b>Hide Scalar Bar</b>/<b>Show Scalar Bar</b> - allows to show/hide the scalar bar
+attached to the 3d presentation.
+
+- <b>Representation</b> - allows to switch among the available
+representation types.\n\n\image html viewing10.png 
+  - <b>Points</b> \image html viewing5.png
+  - <b>Surface</b> \image html viewing6.png
+  - <b>Wireframe</b> \image html viewing7.png
+  - <b>Insideframe</b> - displays the wires lying within the object \image html viewing8.png
+  - <b>Surfaceframe</b> - displays wires and cells lying on the object surface \image html viewing9.png
+  - <b>Feature edges</b> - shows the contour of the object \image html viewing11.png
+  - <b>Shrink</b> \image html viewing12.png
+  - <b>Shading on</b> - colors the object in a realistic way,
+    revealing its geometry, for example, by applying shadows to the
+    inside regions; used together with \b Surface.
+  - <b>Shading off</b> - colors the object basing only on scalar values.
+
+- <b>2D Quadratic</b> - allows to choose how the quadratic elements
+are visualized: as straight lines or as arcs of circle.
+
+\image html quadratic.png
+
+- \b Properties
+  - \b Opacity - allows to set the value of opacity of the
+  presentation between 0 (transparent) and 100 (opaque).
+  \note For a \ref gauss_points_presentations_page "Gauss Points"
+  presentation, displayed using <b>Point Sprites</b> or <b>OpenGL
+  Points</b> \ref primitive_types_page "primitives", this property
+  only allows switching between transparent and opaque modes. The
+  textures are drawn in the opaque mode if the opacity is equal to
+  100% and in the transparent mode if the opacity is lower that 100%
+  (note that they become invisible when the opacity is equal to
+  0%).\n\n \image html viewing13.png
+  - <b>Line Width</b> - allows to set the width of lines representing
+    edges of the presentation between 1 (thin) and 100 (thick).\n\n
+    \image html line_width.png
+  - <b>Shrink Factor</b> - allows to set the shrink factor of the
+  presentation to be used in \b Shrink mode. Possible values range
+  between 20 and 100, the default value is 80.\n\n \image html
+  shrink_factor.png
+  - <b>Edge Color</b> - allows to set the color of lines representing
+  the edges of the presentation displayed in SurfaceFrame mode.
+  - \ref point_marker_page "Point Marker" - allows to change the
+  representation of points.
+
+- \ref translate_presentation_page "Translate Presentation" - allows
+to translate the presentation along coordinate axes.
+- \ref clipping_page "Clipping Planes" - allows to create
+cross-section views of presentations.
+- \ref sweeping_page "Sweep" - allows to display pseudo-animation of
+the presentation.
+
+- <b>Dump view</b> - exports an object from the viewer in bmp, png,
+jpg or jpeg image format.
+- <b>Change Background</b> - allows to change the properties of the
+background.
+
+- <b>View Operations</b> checkbox - shows or hides the VTK viewer
+toolbar. The information about the VTK viewer functionalities is
+available in the documentation on the GUI module.
+- <b>Recording operations</b> checkbox - shows or hides buttons used
+for \ref recording_page "Recording".
+
+The following menu items are added when the presentation is
+selected in the Object Browser.
+
+- \b Delete - removes the presentation from the study.
+- \b Refresh - updates the presentation in the VTK viewer.
+- \b Find - activates <b> Find Tool</b> described in the documentation
+  on GUI module.
+
+When you create several presentations of the same object, you may wish
+to see them simultaneously,  which might be impossible, because they
+all are located at the same place. To solve this problem, right-click
+in the viewer and select <b>Arrange Actors</b> in the pop-up menu.
+
+\image html arrangeactors.png
+
+In \b Auto mode you specify along which \b Axis and at which
+<b>Relative Distance</b> the presentations should be lined up.
+
+\image html arrangeactors1.png
+
+In \b Manual mode you set the coordinates for each presentation
+separately.
+
+Displaying several presentations at the same time may cause
+superposition of their scalar bars. To avoid this, check <b>Arrange
+Scalar Bars</b> radio button  in the <b>Preferences -> Post-Pro ->
+Scalar Bar</b>. A separate scalar bar will be displayed for each
+presentation.
+
+Alternatively you may wish to merge the scalar bars to have a
+common scalar bar for all presentations. To do this, select several
+presentations or fields in the object browser, right-click and from
+the pop-up menu select <b>Merge Scalar Range</b>.
+
+To restore separate bars and scales for each module select <b>Use
+Field Range</b> from the same menu.
+
+*/