doc/salome/gui/input/occ_3d_viewer.doc

   1 /*!
   2
   3 \page occ_3d_viewer_page OCC 3D Viewer
   4
   5 The functionalities of OCC viewer are available via its Viewer
   6 Toolbar. Buttons marked with small downward triangles have extended
   7 functionality which can be accessed by locking on them with left mouse
   8 button.
   9
  10 \image html occviewer_toolbar.png "Viewer Toolbar"
  11
  12 <hr>
  13 \image html image77.png
  14 \n <center><b>Dump View</b> - exports an object from the viewer in bmp, png, jpg
  15 or jpeg image format.</center>
  16 <hr>
  17
  18 \image html image88.gif
  19 \n <center><b>Show/Hide Trihedron</b> - shows or hides coordinate axes.</center>
  20 <hr>
  21
  22 \image html image96.png
  23 \n <center><b>Fit all</b> - allows to select a point to be the center of a
  24 scene representing all displayed objects in the visible area.</center>
  25 <hr>
  26
  27 \image html image97.png
  28 \n <center><b>Fit area</b> - resizes the view to place in the visible area
  29 only the contents of a frame drawn with pressed left mouse button.</center>
  30 <hr>
  31
  32 \image html image98.png
  33 \n <center><b>Zoom</b> - allows to zoom in and out.</center>
  34 <hr>
  35
  36 \image html image99.gif
  37 \n <center><b>Panning</b> - if the represented objects are greater that the
  38 visible area and you don't wish to use <b>Fit all</b> functionality, click on
  39 this button and you'll be able to drag the scene to see its remote
  40 parts.</center>
  41 <hr>
  42
  43 \image html image100.png
  44 \n <center><b>Global panning</b> - represents all displayed objects in
  45 the visible area.</center>
  46 <hr>
  47
  48 \image html view_rotation_point.png
  49 \n <center><b>Change rotation point</b> - allows to to choose the point around
  50 which the rotation is performed.</center>
  51
  52 \image html set_rotation_point_dialog1.png
  53
  54 <center>By default the rotation point is located in the Center of the bounding
  55 box of an object.</center>
  56
  57 \image html set_rotation_point_dialog2.png
  58
  59 <center>Unchecking <b>Use Bounding Box Center</b> checkbox allows you to
  60 define the coordinates of the rotation point manually.</center>
  61
  62 <b>Set to Origin</b> button restores the default rotation point
  63 coordinates.\n
  64 <b>Select Point from View</b> button allows to select the rotation
  65 point in the 3D Viewer.
  66 <hr>
  67
  68 \image html image89.png
  69 \n <center><b>Rotation</b> - allows to rotate the selected object using the
  70 mouse.</center>
  71
  72 \image html image102.gif
  73
  74 <center>These buttons orientate the scene strictly about coordinate axes.</center>
  75 <hr>
  76
  77 \image html image91.png
  78 \n <center><b>Reset</b> - restores the default position (isometric) of
  79 objects in the scene.</center>
  80 <hr>
  81
  82 \image html image103.png
  83 \n <center><b>Memorise view</b> - saves the current position of
  84 objects in the scene.</center>
  85 <hr>
  86
  87 \image html image105.gif
  88 \n <center><b>Restore view</b> - restores the saved position of
  89 objects in the scene.</center>
  90 <hr>
  91
  92 \image html image86.png
  93 \n <center><b>Clone view</b> - opens a new duplicate scene.</center>
  94 <hr>
  95
  96 \image html image106.png
  97 \n <center><b>Clipping</b> - allows to create cross-section views
  98 (clipping planes) of geometrical objects.</center>
  99
 100 \image html clipping.png
 101 <ul>
 102 <li><b>Base point</b> - allows to define the coordinates of the base
 103 point for the clipping plane.</li>
 104 <ul>
 105 <li><b>Reset</b> - returns the base point to coordinate origin.</li>
 106 </ul>
 107 <li><b>Direction</b> - allows to define the orientation of the
 108 clipping plane.</li>
 109 <ul>
 110 <li><b>Invert</b> - allows to select which part of the object will be removed
 111 and which will remain after clipping.</li>
 112 </ul>
 113 <li><b>Preview</b> - allows to see the results of clipping in the
 114 viewer.</li>
 115 </ul>
 116 <hr>
 117 \image html occviewer_axialscale.png
 118 \n <center><b>Scaling</b> - represents objects deformed (stretched or
 119 stuffed) along the axes of coordinates.</center>
 120
 121 <b>Note!</b> OCC Viewer features a special <b>Polyline Selection</b> mechanism, which allows selecting an arbitraty part of the graphic area using a polygon frame, instead of the usual selection with a rectangular frame.
 122
 123 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.
 124
 125 \image html polyselection1.png
 126
 127 As a result, only the nodes within the frame are selected.
 128
 129 \image html polyselection2.png
 130
 131 */