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 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_zoom.png
68 <b>Zoom</b> - allows to zoom in and out.
71 \image html occ_view_pan.png
73 <b>Panning</b> - if the represented objects are greater that the
74 visible area and you don't wish to use <b>Fit all</b> functionality,
75 click on this button and you'll be able to drag the scene to see its
79 \image html occ_view_glpan.png
81 <b>Global panning</b> - represents all displayed objects in the
85 \image html occ_view_rotation_point.png
87 <b>Change rotation point</b> - allows to to choose the point around
88 which the rotation is performed.
90 \image html set_rotation_point_dialog1.png
92 By default the rotation point is located in the Center of the bounding
95 \image html set_rotation_point_dialog2.png
97 Unchecking <b>Use Bounding Box Center</b> checkbox allows you to
98 define the coordinates of the rotation point manually.
100 - <b>Set to Origin</b> button restores the default rotation point
103 - <b>Select Point from View</b> button allows to select the rotation
104 point in the 3D Viewer.
108 \image html occ_view_rotate.png
110 <b>Rotation</b> - allows to rotate the selected object using the
114 \image html occ_view_front.png
115 \image html occ_view_back.png
116 \image html occ_view_top.png
117 \image html occ_view_bottom.png
118 \image html occ_view_left.png
119 \image html occ_view_right.png
121 These buttons orientate the scene strictly about coordinate axes:
122 \b Front, \b Back, \b Top, \b Bottom, \b Left or \b Right side.
125 \image html occ_view_anticlockwise.png
127 <b>Rotate counterclockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly counterclockwise.
130 \image html occ_view_clockwise.png
132 <b>Rotate clockwise</b> - rotates view 90 @htmlonly ° @endhtmlonly clockwise.
135 \image html occ_view_reset.png
137 <b>Reset</b> - restores the default position (isometric) of objects in
141 \image html occ_view_shoot.png
143 <b>Memorise view</b> - saves the current position of objects in the
147 \image html occ_view_presets.png
149 <b>Restore view</b> - restores the saved position of objects in the
153 \image html occ_view_clone.png
155 <b>Clone view</b> - opens a new duplicate scene.
158 \anchor clipping_planes
159 \image html occ_view_clipping.png
161 <b>Clipping</b> - allows to create cross-section views (clipping
162 planes) of geometrical objects.
164 To start, click on the \em New button.
166 Now you must specify what mode of creating plane you want to choose:
167 absolute or relative.
171 \image html Clipping_Absolute.png
173 - <b>Base point</b> - allows to define the coordinates of the base
174 point for the clipping plane.
176 - <b>Reset</b> - returns the base point to coordinate origin.
178 - <b>Direction</b> - allows to define the orientation of the
181 - <b>Invert</b> - allows to select which part of the object will be
182 removed and which will remain after clipping.
186 \image html Clipping_Relative.png
188 - \b Orientation ( ||X-Y, ||X-Z or ||Y-Z).
189 - \b Distance between the opposite extremities of the boundary box of
190 selected objects, if it is set to 0.5 the boundary box is split in two halves.
191 - \b Rotation (in angle degrees) <b>around X</b> (Y to Z) and <b>around
192 Y</b> (X to Z) (depending on the chosen Orientation)
195 If the <b>Show preview</b> button is on, you can see the clipping plane
198 If the <b>Auto Apply</b> button is on, you can preview the
199 cross-section in the viewer.
203 \image html occ_view_scaling.png
205 <b>Scaling</b> - represents objects deformed (stretched or stuffed)
206 along the axes of coordinates.
209 \image html occ_view_graduated_axes.png
211 <b>Graduated axes</b> - allows to define axes parameters and graduate
214 \image html graduatedaxes2.png
216 - <b>Axis name</b> - if checked the axis name is displayed in the viewer.
218 - <b>Name</b> - allows to redefine the axis name.
220 - <b>Font</b> - allows to define the font color of the axis name.
222 - <b>Labels</b> - if checked the labels are displayed in the viewer.
224 - <b>Number</b> - allows to define the number of labels.
226 - <b>Offset</b> - allows to define the distance between labels.
228 - <b>Font</b> - allows to define the font color of labels names.
230 - <b>Tick marks</b> - if checked the tick marks are displayed in the viewer.
232 - <b>Length</b> - allows to define the length of tick marks.
234 - <b>Is visible</b> - if checked the axis is displayed in the viewer.
238 \image html occ_view_ambient.png
240 <b>Toggle ambient light</b> - toggle "keep only ambient light" flag
244 \image html occ_view_minimized.png
245 \image html occ_view_maximized.png
247 <b>Minimize/Maximize</b> - these buttons allow switching the current
248 view area to the minimized / maximized state.
251 \image html occ_view_return_3d_view.png
253 <b>Return to 3D</b> - this button switches from 2D view projection back to the 3D view mode.
256 \image html occ_view_sync.png
258 <b>Synchronize view</b> - allows to synchronize 3d view
259 parameters. This button has two states - checked and
260 unchecked. Clicking on this button opens a drop-down menu listing the
261 compatible 3d views. As soon as the user selects any view from the
262 list, the parameters (view point, position, zoom coefficient, etc.) of
263 the current view are synchronized with the selected view (static
266 In addition, when this button is in the "checked" state, the dynamic
267 synchronization of the views is performed, i.e. any zoom, pan, rotate
268 or other view operation done in one view is automatically applied to
272 \anchor occ_background
275 OCC Viewer background can be customized using the "Change background"
276 popup menu command that opens the following dialog box:
278 \image html change_background_dlg.png
280 The following types of the background are supported:
282 - Single color: the background is colored with the solid color
283 specified by the user in the dialog box.
285 - Gradient background: the background is gradiently colored according
286 to two colors and the gradient type specified in the dialog box. The
287 following types of background are supported:
305 - Image: allows to set image as viewer background and define filling type:
307 - Center: the image is located at the center of the viewer backgound
309 - Tile: the image fills the entire viewer backgound one by one
311 - Stretch: the image is stretched to the entire viewer backgound.
313 Default background for the viewer is specified via the
314 \ref occ_preferences "application preferences".
316 <h2>Polyline selection</h2>
318 OCC Viewer features a special <b>Polyline Selection</b> mechanism,
319 which allows selecting an arbitraty part of the graphic area using a
320 polygon frame (rubber band), instead of the usual selection with a
323 To produce a Polyline Selection, lock the right mouse button and draw
324 the first side of the polygon, then change the direction by clicking
325 the left mouse button add draw another side, etc. The whole selection
326 frame is drawn with the locked right mouse button.
328 \image html polyselection1.png
330 As a result, only the nodes within the frame are selected.
332 \image html polyselection2.png