X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2Finput%2Focc_3d_viewer.doc;h=7f79605ac69ccea8a81486728eed1811a9e9a9f1;hb=77a9b7ac9d8b364358e1760e74a44e86557b79aa;hp=6473189928e65abff99902b5d80da7e4b758b9c6;hpb=a0054494bc71aff902b2bac8449acbcb118192e4;p=modules%2Fgui.git
diff --git a/doc/salome/gui/input/occ_3d_viewer.doc b/doc/salome/gui/input/occ_3d_viewer.doc
index 647318992..7f79605ac 100644
--- a/doc/salome/gui/input/occ_3d_viewer.doc
+++ b/doc/salome/gui/input/occ_3d_viewer.doc
@@ -43,7 +43,7 @@ current cursor position) zooming styles.
\image html occ_view_preselection.png
-Enable/Disable preselection - enables or disables preselection in the view.
+Enable/Disable preselection - enables or disables preselection (highlighting) in the view.
\image html occ_view_selection.png
@@ -63,6 +63,11 @@ representing all displayed objects in the visible area.
the contents of a frame drawn with pressed left mouse button.
+\image html occ_view_fitselection.png
+
+Fit selection - fits view contents to the current selection.
+
+
\image html occ_view_zoom.png
Zoom - allows to zoom in and out.
@@ -94,14 +99,14 @@ box of an object.
\image html set_rotation_point_dialog2.png
-Unchecking Use Bounding Box Center checkbox allows you to
+Disabling Use Bounding Box Center check-box allows you to
define the coordinates of the rotation point manually.
- Set to Origin button restores the default rotation point
coordinates.
-- Select Point from View button allows to select the rotation
- point in the 3D Viewer.
+- Gravity Center of Selected Object button allows using the gravity center of the object selected in the viewer as the center of the rotation point.
+When you click this button, you should first choose the type of selectable object: Point, Edge, Face or Solid and only then proceed with selection in the viewer.
@@ -132,6 +137,28 @@ These buttons orientate the scene strictly about coordinate axes:
Rotate clockwise - rotates view 90 @htmlonly ° @endhtmlonly clockwise.
+\image html occ_view_orthographic.png
+
+Ortographic projection - default OCC viewer projection mode.
+
+
+\image html occ_view_perspective.png
+
+Perspective projection - perspective OCC viewer projection mode.
+
+
+\image html occ_view_stereo.png
+
+Stereo projection - stereoscopic rendering of the view.
+\note Activation of this mode also switches the view to perpective projection
+in case if the orthographic one has been active.
+\note By default, quad-buffered stereo is activated, if it is supported by the graphic card.
+If no stereo capabilities are available, an error message is shown.
+\note The stereoscopic view settings can be defined in
+\ref occ_preferences "OCC 3D Viewer" preferences.
+
+
+
\image html occ_view_reset.png
Reset - restores the default position (isometric) of objects in
@@ -156,29 +183,25 @@ scene.
\anchor clipping_planes
-\image html occ_view_clipping.png
-Clipping - allows to create cross-section views (clipping
-planes) of geometrical objects.
+\b Clipping allows creating cross-section views (clipping planes)
+of your mesh.
-To start, click on the \em New button.
+To create a clipping plane, click on the \b New button in the dialog and choose how it is definition by \b Absolute or \b Relative coordinates.
-Now you must specify what mode of creating plane you want to choose:
-absolute or relative.
-
-Absolute mode
+Absolute Coordinates
\image html Clipping_Absolute.png
-- Base point - allows to define the coordinates of the base
+- Base point - allows defining the coordinates of the base
point for the clipping plane.
- Reset - returns the base point to coordinate origin.
-- Direction - allows to define the orientation of the
+- Direction - allows defining the orientation of the
clipping plane.
- - Invert - allows to select which part of the object will be
+ - Invert - allows selecting, which part of the object will be
removed and which will remain after clipping.
Relative mode
@@ -186,17 +209,20 @@ absolute or relative.
\image html Clipping_Relative.png
- \b Orientation ( ||X-Y, ||X-Z or ||Y-Z).
+
- \b Distance between the opposite extremities of the boundary box of
selected objects, if it is set to 0.5 the boundary box is split in two halves.
+
- \b Rotation (in angle degrees) around X (Y to Z) and around
Y (X to Z) (depending on the chosen Orientation)
+The other parameters are available in both modes :
+- Preview check-box shows the clipping plane in the 3D Viewer.
+- Auto Apply check-box shows button is on, you can preview the
+cross-section in the 3D Viewer.
-If the Show preview button is on, you can see the clipping plane
-in the viewer.
-
-If the Auto Apply button is on, you can preview the
-cross-section in the viewer.
+It is also possible to interact with the clipping plane directly in 3D
+view using the mouse.
@@ -248,6 +274,11 @@ on/off.
view area to the minimized / maximized state.
+\image html occ_view_return_3d_view.png
+
+Return to 3D - this button switches from 2D view projection back to the 3D view mode.
+
+
\image html occ_view_sync.png
Synchronize view - allows to synchronize 3d view
@@ -264,66 +295,76 @@ or other view operation done in one view is automatically applied to
the other view.
-\anchor occ_background
-Background
+\image html occ_view_ray_tracing.png
-OCC Viewer background can be customized using the "Change background"
-popup menu command that opens the following dialog box:
+\anchor ray_tracing
-\image html change_background_dlg.png
+Ray tracing - allows to switch between rendering methods in run-time
+in the current OCCT 3D view. It can be used to produce images with photorealistic quality.
-The following types of the background are supported:
+\image html doc_ray_tracing.png
-- Single color: the background is colored with the solid color
- specified by the user in the dialog box.
+- Ray tracing - specifies rendering mode: OpenGL rasterization (by default) or GPU ray-tracing.
-- Gradient background: the background is gradiently colored according
- to two colors and the gradient type specified in the dialog box. The
- following types of background are supported:
+ - Depth - defines maximum ray-tracing depth.
+
+ - Specular reflections - enables/disables specular reflections.
+
+ - Adaptive anti-aliasing - enables/disables adaptive anti-aliasing.
+
+ - Shadows rendering - enables/disables shadows rendering.
+
+ - Transparent shadow - enables/disables light propagation through transparent media.
+
+
+
+\image html occ_view_env_texture.png
- - Horizontal
+\anchor env_texture
- - Vertical
+Environment texture - allows to set parameters for environment texture.
+This is a special mode of texture mapping when specular reflection of environment texture
+is simulated by OpenGL using a special texture coordinates generation algorithm (a sphere map).
- - First diagonal
+\image html doc_env_texture.png
- - Second diagonal
+- Environment texture - enables/disables environment texture in the current OCCT 3D view.
- - First corner
+User can select one of 7 predefined environment texture from the list or define its texture from file by
+choosing item "Custom..." in a combo box.
- - Second corner
+\note Note that the environment texture file should normally satisfy the following requirements
+in order to produce good visual result:
+- The image file should have 2:1 width-to-height ratio.
+- It should constitute a 360-degrees panoramic image created using a fish-eye lens.
- - Third corner
+
+
+\image html occ_view_light_source.png
- - Fourth corner
+\anchor light_source
-- Image: allows to set image as viewer background and define filling type:
+Light source - allows to set parameters for light source.
- - Center: the image is located at the center of the viewer backgound
+It's possible to choose a type of light source between directional and positional light.
- - Tile: the image fills the entire viewer backgound one by one
+\image html doc_dir_light_source.png
- - Stretch: the image is stretched to the entire viewer backgound.
+Directional light - creates a directional light source in the viewer.
+It is defined by direction coordinates, color and headlight parameter.
-Default background for the viewer is specified via the
-\ref occ_preferences "application preferences".
+\image html doc_pos_light_source.png
-Polyline selection
+Positional light - creates an isolated light source X,Y,Z in the viewer.
+It is also defined by the color and headlight parameter.
-OCC Viewer features a special Polyline Selection mechanism,
-which allows selecting an arbitraty part of the graphic area using a
-polygon frame (rubber band), instead of the usual selection with a
-rectangular frame.
+Click:
-To produce a Polyline Selection, lock the right mouse button and draw
-the first side of the polygon, then change the direction by clicking
-the left mouse button add draw another side, etc. The whole selection
-frame is drawn with the locked right mouse button.
-
-\image html polyselection1.png
+- Apply and Close to apply defined light source to the OCC 3D Viewer.
-As a result, only the nodes within the frame are selected.
+- Default to restore default values of light source.
-\image html polyselection2.png
+- Close to return parameters of light source on initial values.
+
*/