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_fitall.png
46 <b>Fit all</b> - allows to select a point to be the center of a scene
47 representing all displayed objects in the visible area.
50 \image html occ_view_fitarea.png
52 <b>Fit area</b> - resizes the view to place in the visible area only
53 the contents of a frame drawn with pressed left mouse button.
56 \image html occ_view_zoom.png
58 <b>Zoom</b> - allows to zoom in and out.
61 \image html occ_view_pan.png
63 <b>Panning</b> - if the represented objects are greater that the
64 visible area and you don't wish to use <b>Fit all</b> functionality,
65 click on this button and you'll be able to drag the scene to see its
69 \image html occ_view_glpan.png
71 <b>Global panning</b> - represents all displayed objects in the
75 \image html occ_view_rotation_point.png
77 <b>Change rotation point</b> - allows to to choose the point around
78 which the rotation is performed.
80 \image html set_rotation_point_dialog1.png
82 By default the rotation point is located in the Center of the bounding
85 \image html set_rotation_point_dialog2.png
87 Unchecking <b>Use Bounding Box Center</b> checkbox allows you to
88 define the coordinates of the rotation point manually.
90 - <b>Set to Origin</b> button restores the default rotation point
93 - <b>Select Point from View</b> button allows to select the rotation
94 point in the 3D Viewer.
98 \image html occ_view_rotate.png
100 <b>Rotation</b> - allows to rotate the selected object using the
104 \image html occ_view_front.png
105 \image html occ_view_back.png
106 \image html occ_view_top.png
107 \image html occ_view_bottom.png
108 \image html occ_view_left.png
109 \image html occ_view_right.png
111 These buttons orientate the scene strictly about coordinate axes:
112 \b Front, \b Back, \b Top, \b Bottom, \b Left or \b Right side.
115 \image html occ_view_anticlockwise.png
117 <b>Rotate counterclockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly counterclockwise.
120 \image html occ_view_clockwise.png
122 <b>Rotate clockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly clockwise.
125 \image html occ_view_reset.png
127 <b>Reset</b> - restores the default position (isometric) of objects in
131 \image html occ_view_shoot.png
133 <b>Memorise view</b> - saves the current position of objects in the
137 \image html occ_view_presets.png
139 <b>Restore view</b> - restores the saved position of objects in the
143 \image html occ_view_clone.png
145 <b>Clone view</b> - opens a new duplicate scene.
148 \image html occ_view_clipping.png
150 <b>Clipping</b> - allows to create cross-section views (clipping
151 planes) of geometrical objects.
153 \image html clipping.png
155 - <b>Base point</b> - allows to define the coordinates of the base
156 point for the clipping plane.
158 - <b>Reset</b> - returns the base point to coordinate origin.
160 - <b>Direction</b> - allows to define the orientation of the
163 - <b>Invert</b> - allows to select which part of the object will be
164 removed and which will remain after clipping.
166 - <b>Preview</b> - allows to see the results of clipping in the
171 \image html occ_view_scaling.png
173 <b>Scaling</b> - represents objects deformed (stretched or stuffed)
174 along the axes of coordinates.
177 \image html occ_view_graduated_axes.png
179 <b>Graduated axes</b> - allows to define axes parameters and graduate
182 \image html graduatedaxes2.png
184 - <b>Axis name</b> - if checked the axis name is displayed in the viewer.
186 - <b>Name</b> - allows to redefine the axis name.
188 - <b>Font</b> - allows to define the font color of the axis name.
190 - <b>Labels</b> - if checked the labels are displayed in the viewer.
192 - <b>Number</b> - allows to define the number of labels.
194 - <b>Offset</b> - allows to define the distance between labels.
196 - <b>Font</b> - allows to define the font color of labels names.
198 - <b>Tick marks</b> - if checked the tick marks are displayed in the viewer.
200 - <b>Length</b> - allows to define the length of tick marks.
202 - <b>Is visible</b> - if checked the axis is displayed in the viewer.
206 \image html occ_view_ambient.png
208 <b>Toggle ambient light</b> - toggle "keep only ambient light" flag
212 \image html occ_view_minimized.png
213 \image html occ_view_maximized.png
215 <b>Minimize/Maximize</b> - these buttons allow switching the current
216 view area to the minimized / maximized state.
219 \image html occ_view_sync.png
221 <b>Synchronize view</b> - allows to synchronize 3d view
222 parameters. This button has two states - checked and
223 unchecked. Clicking on this button opens a drop-down menu listing the
224 compatible 3d views. As soon as the user selects any view from the
225 list, the parameters (view point, position, zoom coefficient, etc.) of
226 the current view are synchronized with the selected view (static
229 In addition, when this button is in the "checked" state, the dynamic
230 synchronization of the views is performed, i.e. any zoom, pan, rotate
231 or other view operation done in one view is automatically applied to
235 \anchor occ_background
238 OCC Viewer background can be customized using the "Change background"
239 popup menu command that opens the following dialog box:
241 \image html change_background_dlg.png
243 The following types of the background are supported:
245 - Single color: the background is colored with the solid color
246 specified by the user in the dialog box.
248 - Gradient background: the background is gradiently colored according
249 to two colors and the gradient type specified in the dialog box. The
250 following types of background are supported:
268 - Image: allows to set image as viewer background and define filling type:
270 - Center: the image is located at the center of the viewer backgound
272 - Tile: the image fills the entire viewer backgound one by one
274 - Stretch: the image is stretched to the entire viewer backgound.
276 Default background for the viewer is specified via the
277 \ref occ_preferences "application preferences".
279 <h2>Polyline selection</h2>
281 OCC Viewer features a special <b>Polyline Selection</b> mechanism,
282 which allows selecting an arbitraty part of the graphic area using a
283 polygon frame (rubber band), instead of the usual selection with a
286 To produce a Polyline Selection, lock the right mouse button and draw
287 the first side of the polygon, then change the direction by clicking
288 the left mouse button add draw another side, etc. The whole selection
289 frame is drawn with the locked right mouse button.
291 \image html polyselection1.png
293 As a result, only the nodes within the frame are selected.
295 \image html polyselection2.png