3 \page occ_3d_viewer_page OCC 3D Viewer
7 The functionalities of OCC viewer are available via its Viewer
8 Toolbar. Buttons marked with small downward triangles have extended
9 functionality which can be accessed by locking on them with left mouse
12 \image html occviewer_toolbar.png
15 \image html occ_view_camera_dump.png
17 <b>Dump View</b> - exports an object from the viewer in bmp, png or
21 \image html occ_view_style_switch.png
23 <b>Interaction style switch</b> - allows to switch between standard
24 and "keyboard free" interaction styles. "Keyboard free" style allows
25 to process all view transformations without using keyboard (only by
26 mouse) and perform selection in view by pressing "S" key. By default,
27 rotation in this mode is performed by left mouse button, panning - by
28 middle mouse button, zooming - by left and middle mouse buttons
29 pressed simultaneously.
32 \image html occ_view_zooming_style_switch.png
34 <b>Zooming style switch</b> - allows to switch between standard
35 (zooming at the center of the view) and advanced (zooming at the
36 current cursor position) zooming styles.
39 \image html occ_view_triedre.png
41 <b>Show/Hide Trihedron</b> - shows or hides coordinate axes.
44 \image html occ_view_preselection.png
46 <b>Enable/Disable preselection</b> - enables or disables preselection (highlighting) in the view.
49 \image html occ_view_selection.png
51 <b>Enable/Disable selection</b> - enables or disables selection in the view.
54 \image html occ_view_fitall.png
56 <b>Fit all</b> - allows to select a point to be the center of a scene
57 representing all displayed objects in the visible area.
60 \image html occ_view_fitarea.png
62 <b>Fit area</b> - resizes the view to place in the visible area only
63 the contents of a frame drawn with pressed left mouse button.
66 \image html occ_view_fitselection.png
68 <b>Fit selection</b> - fits view contents to the current selection.
71 \image html occ_view_zoom.png
73 <b>Zoom</b> - allows to zoom in and out.
76 \image html occ_view_pan.png
78 <b>Panning</b> - if the represented objects are greater that the
79 visible area and you don't wish to use <b>Fit all</b> functionality,
80 click on this button and you'll be able to drag the scene to see its
84 \image html occ_view_glpan.png
86 <b>Global panning</b> - represents all displayed objects in the
90 \image html occ_view_rotation_point.png
92 <b>Change rotation point</b> - allows to to choose the point around
93 which the rotation is performed.
95 \image html set_rotation_point_dialog1.png
97 By default the rotation point is located in the Center of the bounding
100 \image html set_rotation_point_dialog2.png
102 Disabling <b>Use Bounding Box Center</b> check-box allows you to
103 define the coordinates of the rotation point manually.
105 - <b>Set to Origin</b> button restores the default rotation point
108 - <b>Gravity Center of Selected Object</b> button allows using the gravity center of the object selected in the viewer as the center of the rotation point.
109 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.
113 \image html occ_view_rotate.png
115 <b>Rotation</b> - allows to rotate the selected object using the
119 \image html occ_view_front.png
120 \image html occ_view_back.png
121 \image html occ_view_top.png
122 \image html occ_view_bottom.png
123 \image html occ_view_left.png
124 \image html occ_view_right.png
126 These buttons orientate the scene strictly about coordinate axes:
127 \b Front, \b Back, \b Top, \b Bottom, \b Left or \b Right side.
130 \image html occ_view_anticlockwise.png
132 <b>Rotate counterclockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly counterclockwise.
135 \image html occ_view_clockwise.png
137 <b>Rotate clockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly clockwise.
140 \image html occ_view_orthographic.png
142 <b>Ortographic projection</b> - default OCC viewer projection mode.
145 \image html occ_view_perspective.png
147 <b>Perspective projection</b> - perspective OCC viewer projection mode.
150 \image html occ_view_stereo.png
152 <b>Stereo projection</b> - stereoscopic rendering of the view.
153 \note Activation of this mode also switches the view to perpective projection
154 in case if orthographic one has been active.
155 \note By default, quad-buffered stereo is activated, if it is supported by graphic card.
156 If no stereo capabilities are available, an error message is shown.
157 \note Settigs of stereoscopic view take place in
158 \ref occ_preferences "OCC 3D Viewer" preferences.
162 \image html occ_view_reset.png
164 <b>Reset</b> - restores the default position (isometric) of objects in
168 \image html occ_view_shoot.png
170 <b>Memorise view</b> - saves the current position of objects in the
174 \image html occ_view_presets.png
176 <b>Restore view</b> - restores the saved position of objects in the
180 \image html occ_view_clone.png
182 <b>Clone view</b> - opens a new duplicate scene.
185 \anchor clipping_planes
187 \b Clipping allows creating cross-section views (clipping planes)
190 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.
192 <b>Absolute Coordinates</b>
194 \image html Clipping_Absolute.png
196 - <b>Base point</b> - allows defining the coordinates of the base
197 point for the clipping plane.
199 - <b>Reset</b> - returns the base point to coordinate origin.
201 - <b>Direction</b> - allows defining the orientation of the
204 - <b>Invert</b> - allows selecting, which part of the object will be
205 removed and which will remain after clipping.
209 \image html Clipping_Relative.png
211 - \b Orientation ( ||X-Y, ||X-Z or ||Y-Z).
213 - \b Distance between the opposite extremities of the boundary box of
214 selected objects, if it is set to 0.5 the boundary box is split in two halves.
216 - \b Rotation (in angle degrees) <b>around X</b> (Y to Z) and <b>around
217 Y</b> (X to Z) (depending on the chosen Orientation)
219 The other parameters are available in both modes :
220 - <b>Preview</b> check-box shows the clipping plane in the <b>3D Viewer</b>.
221 - <b>Auto Apply</b> check-box shows button is on, you can preview the
222 cross-section in the <b>3D Viewer</b>.
224 It is also possible to interact with the clipping plane directly in 3D
225 view using the mouse.
229 \image html occ_view_scaling.png
231 <b>Scaling</b> - represents objects deformed (stretched or stuffed)
232 along the axes of coordinates.
235 \image html occ_view_graduated_axes.png
237 <b>Graduated axes</b> - allows to define axes parameters and graduate
240 \image html graduatedaxes2.png
242 - <b>Axis name</b> - if checked the axis name is displayed in the viewer.
244 - <b>Name</b> - allows to redefine the axis name.
246 - <b>Font</b> - allows to define the font color of the axis name.
248 - <b>Labels</b> - if checked the labels are displayed in the viewer.
250 - <b>Number</b> - allows to define the number of labels.
252 - <b>Offset</b> - allows to define the distance between labels.
254 - <b>Font</b> - allows to define the font color of labels names.
256 - <b>Tick marks</b> - if checked the tick marks are displayed in the viewer.
258 - <b>Length</b> - allows to define the length of tick marks.
260 - <b>Is visible</b> - if checked the axis is displayed in the viewer.
264 \image html occ_view_ambient.png
266 <b>Toggle ambient light</b> - toggle "keep only ambient light" flag
270 \image html occ_view_minimized.png
271 \image html occ_view_maximized.png
273 <b>Minimize/Maximize</b> - these buttons allow switching the current
274 view area to the minimized / maximized state.
277 \image html occ_view_return_3d_view.png
279 <b>Return to 3D</b> - this button switches from 2D view projection back to the 3D view mode.
282 \image html occ_view_sync.png
284 <b>Synchronize view</b> - allows to synchronize 3d view
285 parameters. This button has two states - checked and
286 unchecked. Clicking on this button opens a drop-down menu listing the
287 compatible 3d views. As soon as the user selects any view from the
288 list, the parameters (view point, position, zoom coefficient, etc.) of
289 the current view are synchronized with the selected view (static
292 In addition, when this button is in the "checked" state, the dynamic
293 synchronization of the views is performed, i.e. any zoom, pan, rotate
294 or other view operation done in one view is automatically applied to