]> 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 b4545de605e2ecb19761fe6e01c4ae68cd5bfe76..0ea0cecc5ac7c5403da3cc83b9fb1eb0cac07104 100644 (file)
@@ -2,10 +2,11 @@
 
 \page viewing_3d_presentations_page Viewing 3D presentations
 
-\n Each  newly created presentation is displayed in the <b>VTK 3D
+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.
-\n To display an existing presentation, right-click on it in the
+
+To display an existing presentation, right-click on it in the
 Object Browser and select \b Show.
 
 \image html viewing3.png
@@ -19,144 +20,116 @@ options:
 visualization and NOT all properties can be set for a certain 3D
 presentation.
 
-\anchor filter_by_scalars_anchor
+- <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.
 
-<ul>
-<li><b>Hide all</b> - allows to hide all objects from the
-viewer.</li>
-<li><b>Edit</b> - allows to return to the menu, where the presentation
-has been created and change its parameters.</li>
-<li><b>Filter by Scalars</b> - allows showing only the cells with
-values that fit into the defined <b>Scalar Range</b>.
+- \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 this menu, check in <b>Filter by scalar range</b> box and input
-the minimum and the maximum values for the <b>Scalar Range</b></li>
+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
-
-<li><b>Rename</b> - allows to rename the presentation.</li>
-<li><b>Copy</b> - allows to create a copy of the presentation in the
-same subfolder (time stamp) in the Object Browser.</li>
+- \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.
 
-<li><b>Hide</b> - allows to hide the selected presentation from the
-viewer.</li>
-<li>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.</li>
-
-<li><b>Values Labeling</b> allows to display values applied to the
+- <b>Values Labeling</b> allows to display values applied to the
 cells or nodes of a 3D presentation.
 
 \image html values_labeling.png
-</li>
 
 \anchor labeling_parameters_anchor
 
-<li><b>Labeling Parameters</b> allows to change such labeling parameters as font and color.
+<b>Labeling Parameters</b> allows to change such labeling parameters as font and color.
 
 \image html labeling_parameters.png
 
-</li>
-
-<li><b>Show Only</b> - allows to display only the selected
-presentation, hiding all other from the viewer.</li>
-<li><b>Hide Scalar Bar</b>/<b>Show Scalar Bar</b> - allows to show/hide the scalar bar
-attached to the 3d presentation.</li>
-<li><b>Representation</b> - allows to switch among the available
-representation types.
-
-\image html viewing10.png 
-
-</ul>
-
-\image html viewing5.png "Points"
-
-\image html viewing6.png "Surface" 
-
-\image html viewing7.png "Wireframe"
-
-\image html viewing8.png "Insideframe - displays the wires lying within the object"
-
-\image html viewing9.png "Surfaceframe - displays wires and cells lying on the object surface" 
-
-\image html viewing11.png "Feature edges - shows the contour of the object" 
-
-\image html viewing12.png "Shrink"
-
-<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. </li>
-
-\anchor width_opacity_anchor
-<ul>
-<li><b>2D Quadratic</b> - allows to choose how the quadratic elements
-are visualized: as straight lines or as arcs of circle.</li>
+- <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
 
-<li>\b Properties</li>
-
-<ul>
-<li>\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%).
-</li>
-
-\image html viewing13.png 
-
-<li><b>Line Width</b> - allows to set the width of lines representing
-edges of the presentation between 1 (thin) and 100 (thick).</li>
-
-\image html line_width.png
-
-<li><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.</li>
-
-\image html shrink_factor.png
-
-<li><b>Edge Color</b> - allows to set the color of lines representing
-the edges of the presentation displayed in SurfaceFrame mode</li> 
-
-</ul>
-<li>\ref translate_presentation_page "Translate Presentation" - allows
-to translate the presentation along coordinate axes.</li>
-<li>\ref clipping_page "Clipping Planes" - allows to create
-cross-section views of presentations.</li>
-<li>\ref sweeping_page "Sweep" - allows to display pseudo-animation of
-the presentation.</li>
-
-<li><b>Dump view</b> - exports an object from the viewer in bmp, png,
-jpg or jpeg image format.</li>
-<li><b>Change Background</b> - allows to change the properties of the
-background.</li>
-<li><b>View Operations</b> checkbox - shows or hides the VTK viewer
+- \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.</li>
-<li><b>Recording operations</b> checkbox - shows or hides buttons used
-for \ref recording_page "Recording" </li>
+available in the documentation on the GUI module.
+<b>Recording operations</b> checkbox - shows or hides buttons used
+for \ref recording_page "Recording".
 
-<li>The following menu items are added when the presentation is
-selected in the Object Browser</li>.
-<ul>
-<li> \b Delete - removes the presentation from the study.</li>
-<li> \b Refresh - updates the presentation in the VTK viewer </li>
-<li> \b Find - activates <b> Find Tool</b> described in the documentation
-on GUI module. </li>
+The following menu items are added when the presentation is
+selected in the Object Browser.
 
-</ul>
-</ul>
+- \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
@@ -173,17 +146,18 @@ In \b Auto mode you specify along which \b Axis and at which
 In \b Manual mode you set the coordinates for each presentation
 separately.
 
-<br>
 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.
-\n Alternatively you may wish to merge the scalar bars to have a
+
+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>.
-\n To restore separate bars and scales for each module select <b>Use
+
+To restore separate bars and scales for each module select <b>Use
 Field Range</b> from the same menu.
 
 */