Viewport controls

The 3D view fills the center. The sidebar and the flyouts along the top decide what you see. The mouse and the axis widget decide how you move.

Mouse

Navigation follows the trackball used in VTK and ParaView, for both WebGL and WebGPU:

Action Control
Rotate Left-drag
Pan Middle-drag (click the wheel)
Zoom Scroll wheel, pinch, or right-drag

Zoom to cursor (Viewport → Camera) keeps scroll zoom centered on the pointer.

Trackball rings are optional colored circles at the orbit center. They are off until you turn them on under Viewport → Camera.

Dragging the model pauses while a tool has the pointer, such as the extract rectangle or the clip plane. In default navigation mode, the cursor becomes a pointer over any visible geometry you can click to select in the Scene sidebar (all loaded sources in a multi-asset scene, not only the active one); elsewhere on the canvas it stays the normal arrow. Clicks on the Axis widget at the bottom left (±X, ±Y, ±Z) snap the model to that view while the camera and floor grid stay fixed in world space, then fit the active model to the canvas (same framing as Fit model to canvas under Align model). They do not start a drag-rotate. The widget’s orientation follows left-drag rotation of the model (and updates when you pan or zoom the camera).

Fit the model

Fit model to canvas (Align model) places the orbit center on the selected mesh and scales the view so the mesh fits, keeping your current angle while the mesh is still on screen. If you have zoomed past it, or it has left the view, fit aims at the mesh so it comes back.

Camera and display

Only one top toolbar flyout is open at a time — hovering or focusing another icon closes the previous menu.

Camera (viewport navigation):

  • Rotate clockwise / counter-clockwise — roll the camera around the direction you are looking
  • Fit model to canvas — frame the selected mesh
  • Zoom to box — zoom to a rectangle, when that tool is on

Display (representation style — duplicated in Scene → Selected prim when a mesh row is selected):

  • Points, Wireframe, Surface, Surface with edges — wireframe and surface with edges may be unavailable on very large meshes; see Large meshes in the browser.

Simulation visualization (toolbar group after Camera / Display): Time only on the top strip. Field (VTK) — field, point/cell probe, legend, colormap — appears in Selected prim only while inspecting a Material row (or mesh Material action), not on geometry display controls. VTK dataset info (ℹ️) and Extract shortcuts stay in the Selected prim header on VTK mesh rows when applicable.

Save viewport image (camera)

The camera button beside those menus saves a PNG of the 3D view (including the axis gizmo and field legend when they are visible). Sidebar, menus, and probe readout are omitted. The file downloads as scenaven-<timestamp>.png. It is available once a model is loaded.

VTK dataset info (ℹ️)

The ℹ️ control is in Scene → Selected prim, beside the VTK filter icons (clip, warp, extract). It opens VTK dataset information for the active selection (source, clip, warp, or extract): counts, bounds, and field arrays.

The panel includes:

  • Point and cell counts, bounds, and dataset type
  • Point and cell fields — name, number of components, and how many values
  • A breakdown of cell types
  • The current frame and time, when the dataset has time steps
  • Labels for Transient, Deforming, and a result such as Clip, Warp, or extract

It needs a volume on the server. On the cloud preview, dataset info is available with the full tool set on on-prem (Open, Scene filter shortcuts, Python session). See Cloud connection.

Legend (Selected prim)

When a field is active, Selected prim → Field (VTK) shows:

  • Field dropdown (scalar)
  • Colormap preset — palette icon; dropdown opens inline on the legend row (with rescale / range / color count)
  • Rescale to data range — one-click icon; fits the color bar to the field min/max
  • Custom range — icon collapses the other legend icons and shows Min, Max, and Apply on the same row; click the icon again (or Escape) to restore the full icon strip
  • Color count — icon toggles a slider on that row (default 256; fewer steps look banded)

The viewport color bar updates with these controls; it is not edited from the top toolbar.

Field probes and legend (Material inspect → Scalar VTK)

When Selected prim is in material inspect (UsdShade Material row or the mesh Material action), the Field (VTK) block shows the field selector and one icon row: point probe, cell probe, legend rescale/range, color count, and colormap.

Activate a probe, then click in the viewport; values appear in the bottom probe readout. Probes need a loaded model. Geometry-only selected prim shows display style and appearance only — not scalar/probe/legend.

Time controls

Shown when there is more than one time step:

  • Step backward and forward
  • Play and pause
  • Scrub the time index
  • ? — opens Time animation

With a clip or warp in the scene tree, Play may show Building animation… once, while every step is prepared. That is separate from Applying warp filter when you scrub a single frame. See Time animation.

Viewport card

These change the picture only. They do not call the server.

Section What you can set
Appearance Sun/moon icon in the section header (hover for tooltip) toggles light/dark UI; Background color swatch, preset dropdown (Ivory, Slate, Sea, Gray — Custom when the swatch does not match), plus optional Gradient beside the swatch
Display Icon toggles (hover for labels) for floor grid (on by default) and ground reflection (on by default), each with a compact intensity slider (25% / 40% when enabled; up to 150%; on/off and intensities saved in the browser for your next visit), plus orientation axis (corner helper; click ±X, ±Y, or ±Z to turn to that view)
Lighting Preset chips (Studio, IBL, Ambient, Dome)
Finish Matte / Satin / Gloss chips — adjusts how shiny solid surfaces look (scalar coloring uses the same finish); saved in the browser for your next visit
Camera Persp / Ortho chips, FOV slider (perspective only), icon toggles for zoom to cursor and trackball rings, reset icon in the section header
Picture Off / FXAA / SMAA chips, Exp exposure slider, icon toggles for shadows and selection outline (outline and AA need post-processing; disabled on WebGPU when degraded)

Lighting presets change the shading. Studio is the everyday key light. Studio IBL adds image-based lighting. Ambient is flatter, with little directional light. Dome wraps the model in a broader surrounding light.

Finish tweaks PBR roughness on mesh surfaces: Gloss is the default (with Studio lighting), Satin adds a middle ground, and Matte is flatter for analysis — Studio IBL makes gloss read best (the app may suggest IBL once per browser session when Gloss is active without IBL).

Anti-aliasing smooths jagged edges. Off leaves them raw. FXAA is a fast smooth. SMAA is a higher-quality smooth. Selection outline draws an outline on the selected mesh.

When the Viewport card shows Renderer, WebGL is the default on every visit and WebGPU is the newer graphics path. Lighting, edges, and points can look slightly different after a switch. Playback pauses while the view rebuilds. When your browser supports WebGPU, see WebGL & WebGPU for switching renderers and what to expect.

Scene → Selected prim (OpenUSD row inspector)

When you select a row in the Scene stage tree, Selected prim below the tree shows the inspector for that prim. On a VTK mesh (UsdGeomMesh) row, this is where you set display style, scalar field / solid color, colormap, opacity, and bounding box — the same representation choices as the top Display menu, plus field coloring. On a Material row, Field (VTK) and probes appear here while you inspect the bound shader.

Colormap and opacity update immediately in the browser.

Clip plane

When the clip plane icon is on in Selected prim → Clip:

  • A plane appears in the view
  • Drag it to move the cut
  • Release, and the server rebuilds the clipped surface

Keyboard

Most actions are in the menus and the sidebar. Drag navigation applies when the pointer is on the view.

Status bar

A frosted bar along the bottom of the 3D view groups colored chips (with icons where it helps):

  • Render — WebGL or WebGPU logo, FPS (green / amber / red by frame rate)
  • View — canvas size
  • Scene — triangle and draw-call counts
  • System — GPU (with vendor logo when recognized) and RAM (JavaScript heap in Chromium-based browsers; hover the chip for details — not total system RAM)
  • Timeline — current step when a time series is loaded

If the view feels slow

  • After the surface has loaded, orbit should stay smooth. The full volume stays on the server.
  • Transparency and a dense wireframe cost more. Switch display style if the frame rate drops.
  • Probes read field values already loaded. They do not rebuild the mesh.