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.

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. |

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.