Skip to content

Toolbar

The toolbar sits above the image. Every control is listed here in toolbar order, with what it does, when it is shown, and its keyboard shortcut. Hover any button to see its tooltip.

The full toolbar in the Image view

Which buttons you see depends on the plot type and the image. For example, the Slice slider appears only for stacks, and the 3D camera buttons replace the zoom buttons in 3D views. The host application can also hide whole groups (see Hidden groups).

Moving the toolbar

Control Icon What it does
Drag to float the toolbar Press and drag to detach the toolbar into a floating window you can place anywhere over the page.
Dock to top Shown while the toolbar floats. Puts it back above the image.

The toolbar detached as a floating window

Tip

The floating toolbar can be dragged partly off-screen. If you lose it, use Dock to top. Its position is not remembered after a reload.

View group

Control Icon What it does Shown
Plot type dropdown Image Chooses how the data is drawn. See Plot types. An image or a spatial dataset is loaded
Iso band slider — The intensity band drawn as surfaces (0–255, mapped onto the volume's range). See Isosurface. Isosurface
Add an intensity line Adds a coloured line and plots the intensity along it. See Intensity profile lines. Image and Heatmap
Channels & Histogram Opens the brightness/contrast, channel and colormap dialog. See Channels & Histogram. Always
Spatial omics controls Opens the Spatial omics panel. See Spatial omics. Spatial omics plot types
Smoothen Switches between raw pixels (default, crisp blocks when zoomed in) and smoothed (bilinear) rendering. The icon turns white while smoothing is on. Image
Slice slider — Steps through the slices of a stack. See Stacks. Stacks
Single image mode / Stack mode / Heatmap and Contour only: one slice at a time (with high-definition zoom), or every slice with Plotly's own Z-plane slider. Stacks, Heatmap/Contour
Download image as PNG Saves what the view shows as a PNG. See Download. Always
Fit to view Fits the whole image (or the 3D scene) into the view. 2D views

Zoom group (2D views)

Control Icon Key What it does
Zoom drag — Heatmap and Contour: drag a rectangle to zoom into it. Not shown in the Image view.
Zoom box B Drag a box to zoom into it. Stays active until you pick another tool.
Pan the image P Drag to pan.
Zoom in + or = Zooms in one step (×1.3) about the centre.
Zoom out - or _ Zooms out one step.

See Navigation for mouse zoom, click-to-zoom, the minimap and the scale bar.

3D group (3D views)

Replaces the zoom group in Surface, Volume, Isosurface and Spatial omics 3D.

Control Icon What it does
Zoom Dragging zooms the camera.
Pan Dragging pans the camera.
Orbital rotation Dragging rotates freely around the scene.
Turntable rotation Dragging rotates around the vertical axis (default).
Reset camera to default Puts the camera back to fit the scene.
Toggle 3D axes / scale Shows or hides the axes with their lengths (on by default).
Toggle wireframe Draws surfaces as wireframes (off by default).
Res — Resolution of the 3D build: Full, ½, ¼ (default) or ⅛. Changing it rebuilds the view.
Slice editor Volume and Isosurface: splits the view into the 3D volume, the slice being edited and two sections. See Slice editor.

The mouse wheel always zooms in 3D. Details in Stacks, volumes and 3D.

Region group

Control Icon Key What it does
Open the Region Editor — Opens the Region Editor as a floating dialog.
Selection mode S Neutral mode: select, move and reshape regions.
Draw a rectangle R Drag to draw a rectangle.
Draw a polyline L Drag to draw an open line.
Draw a freeform region F Drag to draw a closed shape.
Brush — Paint a region; Shift erases. Shows a Size slider.
Draw a polygon — Click each vertex; click the first point to close. Image view.
Add a vertex — Click an edge of the selected polygon. Image view.
Delete a vertex — Click a vertex of the selected polygon. Image view.
Wand W Grow a region from similar pixels. Shows a Sens. slider.
Vertex eraser E Remove vertices under a circle cursor. Shows a Radius slider.
Undo Ctrl+Z Undo the last region action (up to 10).
Redo Ctrl+Shift+Z / Ctrl+Y Redo the last undone action.
Delete selected region Del / Backspace / D Delete every selected region.

Each tool is described in full in Region tools. Clicking the active tool again turns it off.

In the Volume and Isosurface views, with the slice editor closed, only the Region Editor, Selection, Undo, Redo and Delete are shown. Selection then picks class surfaces in 3D.

Segmentation group

Control Icon What it does
Segment with SAM (box prompt) Replaces each drawn rectangle with the object SAM finds inside it.
SAM point prompts Click an object to segment it; Shift/Alt-click excludes; Enter commits; Esc undoes.
Pick the SAM model Chooses the SAM model used by both SAM tools; shows each model's size, speed and domain.
Segment cells (cellpose-SAM) Segments every cell inside each drawn rectangle.

The host application may add its own tools here (for example detection models), each with a model picker and a parameters button . See AI segmentation.

Help

Control Icon What it does
Help Opens this page of the user guide in a new tab.

Hidden groups

An application embedding SIV can hide groups of controls:

Group hidden Controls removed
Special tools Plot type (with Iso and intensity line), Channels & Histogram, Spatial omics, Smoothen, Download, Fit to view
Zoom tools Zoom drag, Zoom box, Pan, Zoom in, Zoom out
Region tools Every region and segmentation tool, and the Slice editor button
Help The Help button

The 3D camera controls, stack controls, the right-click menu and the keyboard shortcuts are never hidden. The host can also add its own buttons at the start of the toolbar.