Skip to main content

The 3D View

The 3D view displays three-dimensional renderings of your data, including volume images, surface meshes, and volume meshes.

3D View and 2D Views

Display Modes​

The 3D view can display different types of renderings:

ModeDescription
Volume RenderingSemi-transparent visualization of volume image data
Surface RenderingSolid display of surface mesh models
Volume Mesh RenderingDisplay of tetrahedral/hexahedral meshes
MixedCombination of volume and surface rendering

Mouse Controls​

ActionMouseDescription
RotateLeft-dragRotates the view around the centre of rotation
PanMiddle-dragMoves the view horizontally and vertically
ZoomRight-dragZooms in (drag up) or out (drag down)
ZoomScroll wheelZooms in and out in steps
Set crosshair centreMiddle-clickMoves the crosshair to the clicked location in all slice views, while the crosshair is enabled
Move a slice planeShift + middle-dragMoves the slice plane under the cursor through the volume
Pick an objectRight-click without draggingSelects the object under the cursor in the Scene Tree and opens its context menu

Keyboard Shortcuts​

ShortcutAction
RReset view to default orientation
CSet center of rotation under mouse cursor and center it on screen
VToggle perspective/orthographic projection
SSolid representation mode
ESolid with edges representation mode
WWireframe representation mode
QPoint representation mode
XView from +X direction (Right)
Shift+XView from -X direction (Left)
YView from +Y direction (Front)
Shift+YView from -Y direction (Back)
ZView from +Z direction (Top)
Shift+ZView from -Z direction (Bottom)
IIsometric view
Ctrl+SpaceMaximize or restore the active 3D view
F11Detach the active 3D view
Ctrl+Alt+SpaceToggle fullscreen for the active 3D view

View Options​

Access view options from the View ribbon tab:

Controller And Settings​

The 3D view also provides a controller overlay with quick access to view actions and a 3D View Settings dialog. The dialog contains GPU volume-rendering options plus renderer choices for:

SettingDescription
Volume rendererChoose between Single volume renderer (default) and Multi-volume renderer for grayscale volumes
Mask direct rendererChoose between Single volume renderer and Multi-volume renderer for direct mask preview

The grayscale volume renderer setting updates the currently loaded volumes immediately. The direct mask preview renderer setting also updates the currently loaded direct mask previews immediately.

note

For best interaction quality, keep 3D view → View settings → Performance → Quality at Maximum while Mask 3D Preview (Direct) is enabled. Lower settings may show edge artefacts while interacting in the 3D view.

See 3D View Controller And Settings for the full dialog reference.

Camera Settings​

SettingDescription
PerspectiveStandard 3D perspective projection
OrthographicParallel projection without perspective distortion
Field of ViewAdjusts the viewing angle (perspective mode)

Display Options​

The Visibility menu of the 3D view controller shows and hides the scene overlays:

OptionDescription
Crosshair AxesThe crosshair marking the intersection of the three slice planes
Center of Rotation AxesA marker at the point the camera orbits around
Origin AxesCoordinate axes at the scene origin
Color Map BarThe colour scale legend of the active colour map
Scene Scale RulerA distance scale along the edge of the view
Scene Bounding BoxAn outline around the whole scene
Scene Axes LabelsAxis direction labels on the bounding box
Show FPSThe frames-per-second counter
Software LogoThe logo overlay in the corner of the view

The Orientation Axes menu chooses the marker in the corner of the view - None, Unidirectional Axes, Bidirectional Axes, Cube, or Human - and its size. Background colours and gradients come from the More Options menu of the same controller.

Lighting​

Scene lighting is managed in Light Studio, which handles the default headlight plus up to eight lights, their type, colours, position, and spotlight parameters, one deliberate shadow-casting light, and multi-light presets. Floor shadows and ambient occlusion are configured in 3D View Settings.

Clipping​

Two independent mechanisms cut the 3D scene open, and they can be combined:

MechanismWhereDescription
Clipping boxView tab → 3D ClippingAn axis-aligned box; everything outside it is hidden, or everything inside it when Invert is on
Slice plane clippingView tab → 3D View → Slice Planes, or the slice view right-click menuCuts the scene open along a slice plane of the active volume, keeping the front or the back half

Neither modifies the data; both only change what the 3D view draws. See 3D Clipping.

The clipping box, where only what is inside the box is drawn or only what is outside with Invert, and slice plane clipping, where the scene is cut open along a slice plane of the active volume and one half is kept

When a clipping or primitive ROI widget is visible, use its controls while the pointer is over the widget: left-drag cuboid faces or handles to adjust them; Ctrl+left-drag translates a cuboid or sphere and adjusts a plane or cylinder; Ctrl+right-drag resizes the widget. These controls take precedence over 3D view navigation. See Default Shortcuts for the full interaction reference.

Volume Rendering Controls​

When displaying volume images:

ControlDescription
Transfer FunctionMaps intensity values to colors and opacity
PresetsPre-configured transfer functions for common use cases
Window/LevelAdjusts the displayed intensity range
QualityBalance between rendering speed and quality

Context Menu​

Right-click on an object in the 3D view, without dragging, to select it in the Scene Tree and open a menu for it. The menu opens only when the click lands on an object; right-clicking empty space does nothing.

EntryApplies toDescription
Object nameAllThe name of the object the menu belongs to, shown at the top
Toggle VisibilityAllShows or hides the object
ActivateAllMakes the object the active one. Not offered when it is already active
ColorSurfaces, volume meshes, single-label masksSixteen named colours, Random Color, and Custom Color... for a colour picker
OpacitySurfaces, volume meshes, masksFixed steps from 1% to 100%
RepresentationSurfaces, volume meshes, masksPoints, Wireframe, Solid, Solid Edges

Volumes offer only the name, Toggle Visibility, and Activate, because their appearance is driven by Render Properties. Multi-label masks have no Color entry, since each label carries its own colour, and a mask shown with Mask 3D Preview (Direct) has no Representation entry, since direct rendering draws no mesh.

tip

Press C while hovering over a feature of interest to set the center of rotation there and bring that point to the middle of the 3D view, making it easier to inspect specific regions during 3D exploration.