QA: Viewing¶
Test cases for opening images, the toolbar, plot types, navigation, display settings, stacks, 3D views, the slice editor, intensity profiles and image export. See How to use the plan for IDs, priorities and recording results. Reference: Toolbar, Plot types, Navigation, Channels & Histogram, Stacks, volumes and 3D, Intensity profile lines.
Unless a case says otherwise, start from the live demo freshly loaded, in the primary browser, with WebGPU available.
Opening images and loading states¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-001 | Open a PNG sample | P1 | img01.png |
1. Click img01.png in the gallery. |
The image opens in the Image view, fitted to the viewer. Minimap shows bottom-right. No error toast. |
| VIEW-002 | Open a TIFF decoded in the browser | P1 | TIFF B16-69_O7_CFP-1_hyper.tif |
1. Click the TIFF tile. 2. Wait for "decoding…" to clear. | The image opens in the Image view. No error toast. |
| VIEW-003 | Open a DICOM slice | P1 | micro-ct folder |
1. Open the micro-ct folder. 2. Click case1_040.dcm. |
A grayscale slice opens in the Image view. |
| VIEW-004 | Open a DICOM folder as a z-stack | P1 | micro-ct folder |
1. Right-click any DCM tile. | The whole folder loads as one z-stack: the toolbar shows a Slice slider and the text "z of max". |
| VIEW-005 | Open a tiled whole-slide image | P1 | WSI CMU-1 |
1. Click the WSI CMU-1 tile. 2. Zoom in several steps. |
A low-resolution view appears quickly, then sharpens. Tiles load as you zoom; no white or missing tiles once loading settles. |
| VIEW-006 | Loading overlay for a single image | P2 | WSI BC18 |
1. Click the tile and watch the viewer immediately. | A spinner with "Loading image..." shows until the first view is drawn. |
| VIEW-007 | "Sharpening preview..." overlay | P3 | A host image with a preview tier (JIT) | 1. Open an image that has a small preview tier. | While the low-resolution preview is on screen and the full tier loads, a translucent "Sharpening preview..." overlay shows; it clears when the full tier is drawn. |
| VIEW-008 | Stack loading progress and Cancel | P2 | WSI Project002 · 2ch x 27z stack |
1. Open the stack. 2. Pick Heatmap, then Stack mode. 3. Click Cancel while "Loading frames..." shows. | A determinate progress bar with "Loading frames..." and a Cancel button show. Cancel stops loading and resets the slice to 0. |
| VIEW-009 | Switching images keeps a 2D plot type | P2 | img01.png, img03.png |
1. Open img01.png, pick Heatmap. 2. Open img03.png. |
img03.png opens in Heatmap (the 2D type carries over when it is still allowed). |
| VIEW-010 | Switching images resets a 3D plot type | P2 | micro-ct z-stack, img01.png |
1. Load the micro-ct z-stack, pick Volume. 2. Open img01.png. |
img01.png opens in Image; the camera mode is back to turntable. |
| VIEW-011 | Error toast when an image cannot be drawn | P3 | A broken or unreachable image (JIT, or block the tile server in DevTools) | 1. Block requests to the tile server. 2. Open a WSI. | An error toast "Could not draw the image" with "<file>: <message>. Try opening it again." (or a sticky "An error occured" toast when the image info cannot be read). ⚠ see Known issues (KI-42). |
Toolbar¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-020 | Toolbar contents in the Image view | P1 | img01.png |
1. Open the image. 2. Hover each button. | In order: drag handle, plot-type dropdown, Add an intensity line, Channels & Histogram, Smoothen, Download image as PNG, Fit to view, Zoom box, Pan, Zoom in, Zoom out, Region Editor and region tools, segmentation tools, Help. Each shows its tooltip. |
| VIEW-021 | Tooltips show shortcuts | P3 | img01.png |
1. Hover Zoom box, Pan, Zoom in, Zoom out. | Tooltips read "Zoom box (b)", "Pan the image (p)", "Zoom in (+)", "Zoom out (-)", with the key rendered as a key cap. |
| VIEW-022 | Detach the toolbar | P2 | img01.png |
1. Press and drag the ≡ handle ("Drag to float the toolbar") into the image. | The toolbar detaches into a floating window that follows the pointer; it starts at the top-left (8, 8) of the page and stays above the image. A pin button "Dock to top" appears. |
| VIEW-023 | Dock the toolbar | P2 | Floating toolbar (VIEW-022) | 1. Click the pin "Dock to top". | The toolbar snaps back above the image. |
| VIEW-024 | Floating toolbar is not clamped | P3 | Floating toolbar | 1. Drag the floating toolbar towards the window edge and beyond. | The toolbar can move partly or fully off-screen; Dock to top brings it back. ⚠ see Known issues (KI-08). |
| VIEW-025 | Floating position is not remembered | P3 | Floating toolbar | 1. Dock, then detach again. 2. Reload the page. | Each new detach starts at (8, 8). After a reload the toolbar is docked. |
| VIEW-026 | Help opens the user guide | P1 | Any image | 1. Click the toolbar Help (question-mark circle). | A new browser tab opens on the guide's Toolbar reference page. The viewer keeps its state. |
| VIEW-027 | Help URL follows the host's docsUrl |
P2 | JIT (or a host setting VIZ_CONFIG.docsUrl) |
1. Click toolbar Help in JIT. | The tab opens <docsUrl>reference/toolbar/ on the host's own documentation site, not the GitHub Pages copy. |
| VIEW-028 | Host can hide toolbar groups | P3 | A host with toolbarTools (JIT processing pipeline, or developer build) |
1. Open a viewer configured with specialTools: false / zoomTools: false / regionTools: false / help: false. |
specialTools:false hides the dropdown, Iso slider, intensity line, Channels & Histogram, Spatial omics, Smoothen, Download and Fit to view. zoomTools:false hides the 2D zoom buttons. regionTools:false hides region, segmentation and Slice editor buttons. help:false hides Help. 3D camera controls, stack controls and the context menu and shortcuts stay. |
Plot types¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-040 | Plot types offered for an RGB image | P1 | img04.png |
1. Open the plot-type dropdown. | Exactly Image, Heatmap, Surface. Contour, Volume and Isosurface are not offered (RGB is not grayscale). |
| VIEW-041 | Plot types offered for a grayscale slice | P1 | One micro-ct DCM slice | 1. Open the dropdown. | Image, Heatmap, Contour, Surface. No Volume or Isosurface (not a stack). |
| VIEW-042 | Plot types offered for a grayscale z-stack | P1 | micro-ct z-stack | 1. Open the dropdown. | Image, Heatmap, Contour, Surface, Volume, Isosurface. |
| VIEW-043 | Plot types offered for a multichannel stack | P2 | TIFF GFPA_IBA1_…_zstack |
1. Open the dropdown. | Volume and Isosurface are offered (multichannel counts as grayscale-compatible). |
| VIEW-044 | Each entry shows its icon | P3 | micro-ct z-stack | 1. Open the dropdown. | Each entry has its icon: image, heatmap, contour, surface, cube, isosurface. |
| VIEW-045 | Heatmap view | P1 | img01.png |
1. Pick Heatmap. | A Plotly heatmap with a colour bar replaces the image. Region tools stay available. |
| VIEW-046 | Contour view | P2 | micro-ct slice | 1. Pick Contour. | Contour lines of the slice are drawn (grid downsampled to at most 400 cells per axis). |
| VIEW-047 | Surface view | P1 | micro-ct slice; WebGPU | 1. Pick Surface. 2. Drag to rotate. | A 3D height field builds (a "… in 3D…" badge while building), and rotates with the mouse. 3D camera controls replace the 2D zoom tools. |
| VIEW-048 | Surface works on RGB | P2 | img04.png; WebGPU |
1. Pick Surface. | The height field is built from luminance; no error. |
| VIEW-049 | Volume view | P1 | micro-ct z-stack; WebGPU | 1. Pick Volume. | A maximum-intensity-projection volume renders in a 3D box with axes. |
| VIEW-050 | Isosurface view | P1 | micro-ct z-stack; WebGPU | 1. Pick Isosurface. | An isosurface renders; the Iso band slider appears in the toolbar. |
| VIEW-051 | Plot-type switch disarms the active tool | P2 | img01.png |
1. Press r (rectangle armed). 2. Pick Heatmap. |
No region tool is highlighted after the switch. |
| VIEW-052 | Unsupported type falls back to Image | P2 | img01.png then img04.png |
1. On a grayscale image pick Contour. 2. Open the RGB img04.png. |
img04.png opens in Image (Contour is not offered for RGB). |
| VIEW-053 | Test-mode plot types | P3 | Demo with ?test=1 (or a host with testMode) |
1. Open micro-ct z-stack. 2. Open the dropdown. | Labels carry their backend: "Image (OSD)", "Heatmap (Plotly)", "Volume (napari · WebGPU)"… and extra types are listed: Scatter 2D/3D (Plotly), Surface (Plotly), Isosurface (Plotly), Image (napari · WebGPU), Scatter 2D/3D (napari · WebGPU). |
| VIEW-054 | 3D types without WebGPU | P2 | micro-ct z-stack; WebGPU off | 1. Pick Volume, Isosurface, Surface in turn. | The view falls back to a Plotly rendering (or an equivalent drawing); no blank view and no uncaught error. The fallback is reported in the console only. |
Navigation (2D)¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-070 | Scroll to zoom (Image view) | P1 | WSI CMU-1 |
1. Scroll up over a feature. 2. Scroll down. | Zooms in toward the pointer, out again, smoothly (about 1.03× per wheel event). |
| VIEW-071 | Drag to pan | P1 | WSI CMU-1, zoomed in |
1. Drag the image with no tool armed. | The image pans with the pointer. |
| VIEW-072 | Click to zoom | P2 | WSI CMU-1, no tool armed |
1. Click a point once. 2. Shift-click. | A click zooms in about 2× toward the clicked point; Shift-click zooms out. |
| VIEW-073 | Click-to-zoom is off while a tool is armed | P2 | img01.png |
1. Press r. 2. Click the image. |
The view does not zoom. |
| VIEW-074 | Zoom in / out buttons and keys | P1 | img01.png |
1. Click Zoom in, then Zoom out. 2. Press +, =, -, _. |
Each press zooms 1.3× in or out about the view centre. + and = zoom in; - and _ zoom out. ⚠ see Known issues (KI-01: OSD's own +/- may zoom twice when the canvas has focus). |
| VIEW-075 | Zoom-out limit | P3 | img01.png |
1. Zoom out repeatedly. | Zooming out continues below the original size, down to about 1% of the view. ⚠ see Known issues (KI-15). |
| VIEW-076 | Zoom-in limit | P3 | img01.png |
1. Zoom in repeatedly. | Zooming stops at about 20 screen pixels per image pixel. |
| VIEW-077 | Zoom box | P1 | WSI CMU-1 |
1. Press b (or click Zoom box). 2. Drag a rectangle. |
While dragging, the outside is dimmed and the box has white corner marks. On release the view fits the box. The tool stays armed (button highlighted). |
| VIEW-078 | Zoom box ignores tiny drags | P3 | WSI CMU-1, zoom box armed |
1. Drag less than 5 px. | Nothing happens. |
| VIEW-079 | Pan tool toggle | P2 | img01.png |
1. Press p. 2. Press p again. |
The Pan button highlights, then un-highlights. |
| VIEW-080 | Fit to view (Image view) | P1 | WSI CMU-1, zoomed in |
1. Click Fit to view. | The whole image is fitted to the viewer. An armed tool stays armed. ⚠ see Known issues (KI-06). |
| VIEW-081 | Fit to view (Heatmap) | P2 | img01.png, Heatmap, zoomed in |
1. Press r. 2. Click Fit to view. |
The heatmap autoscales to the whole image; the armed tool is disarmed. |
| VIEW-082 | Minimap | P1 | WSI CMU-1 |
1. Zoom in. 2. Look at the bottom-right. | The minimap shows the whole slide with a red rectangle for the current view; it moves as you pan. It does not fade out. |
| VIEW-083 | Scale bar | P1 | WSI CMU-1 (has a pixel size) |
1. Zoom in and out. | Bottom-left scale bar with a round length (1, 2 or 5 × 10ⁿ) in µm (or mm); it updates on every zoom. |
| VIEW-084 | No scale bar without a pixel size | P2 | img01.png |
1. Look at the bottom-left. | No scale bar is shown. |
| VIEW-085 | Smoothen toggle | P2 | img01.png |
1. Zoom in until pixels are large. 2. Click Smoothen. 3. Click it again. | By default pixels are crisp blocks. With Smoothen on, the button is filled with a white icon and the image is smoothed (bilinear). Off again: crisp blocks. |
| VIEW-086 | Smoothen only in the Image view | P3 | img01.png |
1. Pick Heatmap. | The Smoothen button is not shown. |
| VIEW-087 | Smoothen survives an image switch | P3 | img01.png, img03.png |
1. Turn Smoothen on. 2. Open img03.png. |
Smoothen is still on. |
| VIEW-088 | Heatmap high-definition zoom | P2 | WSI CMU-1, Heatmap |
1. Use Zoom drag (magnifier) and drag a small box. | The zoomed range is re-fetched at screen resolution; for an uncached file "Caching image..." shows briefly. |
| VIEW-089 | Heatmap wheel zoom | P2 | img01.png, Heatmap |
1. Scroll one notch with a mouse wheel. 2. Scroll on a trackpad. | Each wheel event zooms a full 1.3× step about the view centre (not the pointer). On a trackpad zoom is very fast. ⚠ see Known issues (KI-02). |
| VIEW-090 | Zoom drag only in Plotly views | P3 | img01.png |
1. In Image view, look for Zoom drag. 2. Switch to Heatmap. | Zoom drag (magnifier) is not shown in Image view; it is shown in Heatmap. |
| VIEW-091 | Context menu: view entries (2D) | P2 | img01.png, no regions |
1. Right-click the image. | Entries: Autoscale, Zoom to box, Pan, Zoom in, Zoom out, then the region tools (Select, Freeform, Brush, Polyline, Rectangle, Wand, Vertex eraser, Polygon (click vertices), Add vertex, Delete vertex). The armed mode is highlighted. |
| VIEW-092 | Context menu: Zoom selection in Heatmap | P3 | img01.png, Heatmap |
1. Right-click the plot. | Zoom selection is listed (it is not listed in the Image view). Polygon / Add vertex / Delete vertex are not listed. |
| VIEW-093 | Keys go to the focused or hovered viewer | P3 | img01.png |
1. Click into a text box elsewhere on the page. 2. Press r. |
Nothing happens while focus is in an input. After moving the pointer over the image and pressing r, the rectangle tool arms. |
| VIEW-094 | OpenSeadragon built-in keys | P2 | img01.png, click the image first |
1. Press r, f, 0, w, a, s, d. |
Record what happens. Known collisions: r may rotate the image 90°, f flip it, 0 go home, w a s d pan. ⚠ see Known issues (KI-01). |
Channels & Histogram¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-110 | Open the dialog | P1 | img04.png |
1. Click Channels & Histogram. | A non-modal, draggable, resizable dialog "Channels & Histogram" (30rem wide; 90vw under 960 px). The image stays usable behind it. |
| VIEW-111 | Available in every plot type | P3 | micro-ct z-stack | 1. Switch through each plot type. | The Channels & Histogram button is present in every plot type. |
| VIEW-112 | Grayscale channel table | P2 | micro-ct slice | 1. Open the dialog. | One row "Intensity", no colour swatch, a Show checkbox. |
| VIEW-113 | RGB channel table | P1 | img04.png |
1. Open the dialog. | Rows Red, Green, Blue, each with a colour swatch and a checked Show box; a "<channel> LUT" row with 7 swatches. |
| VIEW-114 | Hide and show a channel | P1 | img04.png |
1. Untick Show for Blue. 2. Tick it again. | Blue disappears from the image (nuclei vanish), then returns. |
| VIEW-115 | Only 4 channels visible by default | P2 | A host image with more than 4 channels (JIT) | 1. Open the image and the dialog. | The first 4 channels are shown, the others unticked (unless the server's descriptor says otherwise). |
| VIEW-116 | Default multichannel names and colours | P3 | A multichannel image without channel metadata | 1. Open the dialog. | Channels are named "Channel N" and coloured red, green, blue, white, cyan, magenta, yellow in order. |
| VIEW-117 | Channel groups | P3 | A host image with grouped channels (JIT) | 1. Open the dialog. | Group rows with a chevron, label and "(count)". The group checkbox is checked only when all its channels are shown; its tooltip reads "N of M shown"; toggling it shows or hides every channel in the group. |
| VIEW-118 | Change a channel colour | P2 | img04.png |
1. Click the Green swatch. 2. Pick a honeycomb cell. | The picker closes and green structures take the new colour. |
| VIEW-119 | Colour picker fields | P3 | img04.png, swatch open |
1. Type #ff00ff in the hex field. 2. Type zz in the hex field. 3. Drag the H slider and release. |
A valid #RRGGBB applies; invalid text is ignored. Slider and number-field changes apply on release, not while dragging. R/G/B fields clamp to 0–255. Clicking outside closes the picker. ⚠ see Known issues (KI-43). |
| VIEW-120 | LUT presets | P2 | img04.png |
1. Select the Green row. 2. Click the Magenta LUT swatch. | The Green channel is drawn in magenta. Swatch tooltips: Red, Green, Blue, Gray, Cyan, Magenta, Yellow. |
| VIEW-121 | Histogram for the selected channel | P1 | img04.png |
1. Click the Red row, then the Green row. | The header reads "Histogram — Red" then "Histogram — Green"; 256 bins in the channel's colour; dotted cyan (Min) and red (Max) markers. |
| VIEW-122 | Log histogram | P3 | img04.png |
1. Tick Log. | The y axis becomes log₁₀ ("log₁₀ count"). |
| VIEW-123 | Min / Max sliders (8-bit) | P1 | img04.png |
1. Drag Min up to 50. 2. Type 200 in the Max field. | Range 0–255, step 1. The image contrast changes live; the histogram markers move. |
| VIEW-124 | Min can never exceed Max | P2 | img04.png |
1. Set Max to 100. 2. Drag Min past 100. | Max is pushed up with Min (and vice versa); Min ≤ Max always. |
| VIEW-125 | Gamma | P2 | img04.png |
1. Move Gamma to its ends. | Range 0.1–5, step 0.01, shown with two decimals; default 1.00. |
| VIEW-126 | Busy spinner while adjusting | P3 | img04.png |
1. Drag Min. | A small spinner shows next to the control and clears about 0.5 s after the last change. |
| VIEW-127 | Auto contrast | P1 | WSI 2-channel fluorescence |
1. Select a dim channel. 2. Click Auto. | Min and Max move to saturate about 0.1% of pixels at each end; the channel becomes clearly visible. |
| VIEW-128 | Reset | P2 | After VIEW-120 and VIEW-123 | 1. Click Reset. | Min 0, Max 255 (or the native range), Gamma 1 and the channel's default tint are restored. |
| VIEW-129 | Native (>8-bit) histogram | P2 | WSI 2-channel fluorescence |
1. Open the dialog. | The histogram axis and the Min/Max sliders use native units over the observed min–max (not 0–255); slider step is about range/255. |
| VIEW-130 | Colormap list (grayscale only) | P1 | micro-ct slice | 1. Open the Colormap selector. | Tooltip "Color Lookup Tables". Groups: Sequential, Sequential (2), Perceptually Uniform Sequential, Diverging, Cyclic, Qualitative, Miscellaneous, each entry with a thumbnail. Default Greys Inv. |
| VIEW-131 | Apply a colormap | P1 | micro-ct slice | 1. Pick Viridis. | The slice is drawn in Viridis. |
| VIEW-132 | No colormap for RGB / multichannel | P2 | img04.png |
1. Open the dialog. | No Colormap selector is shown. |
| VIEW-133 | Invert | P2 | micro-ct slice | 1. Tick Invert. | The display is inverted. There is no separate "reverse colormap" control. ⚠ see Known issues (KI-13). |
| VIEW-134 | Hiding the only grayscale channel | P3 | micro-ct slice | 1. Untick Show for Intensity. | The image goes blank; nothing prevents it. ⚠ see Known issues (KI-09). |
| VIEW-135 | Settings kept on re-plot, reset on new file | P2 | img04.png, img03.png |
1. Change Gamma on img04.png. 2. Switch to Heatmap and back. 3. Open img03.png. |
Gamma is kept across the plot-type switch. img03.png opens with default settings. |
| VIEW-136 | Display settings are not persisted | P3 | img04.png |
1. Change Min/Max. 2. Reload the page and reopen img04.png. |
Defaults are back. |
| VIEW-137 | Export composite (Image view) | P2 | WSI CMU-1 |
1. Click Export composite (PNG). | A PNG <stem>_composite.png downloads: the largest pyramid level up to 32 MP, with the current display settings. Tiles that fail leave gaps. |
| VIEW-138 | Export 16-bit TIFF | P2 | WSI 2-channel fluorescence |
1. Select a channel with a >8-bit histogram. 2. Click Export 16-bit TIFF. | Tooltip "Data-preserving multi-band TIFF (visible channels, native bit depth)". A file <stem>_16bit.ome.tif downloads. The button is not shown for 8-bit images. |
| VIEW-139 | Live recolouring in every backend | P3 | img04.png |
1. Open the dialog. 2. Switch to Heatmap and to Surface while changing Min. | Every view recolours live from the same settings. |
Download¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-150 | Download PNG (Image view) | P1 | img01.png, zoomed, with a region |
1. Click Download image as PNG. | img01.png-stem .png downloads: what is on screen (zoom and colours), without the region outlines, scale bar or minimap. |
| VIEW-151 | Download PNG (Heatmap) | P2 | img01.png, Heatmap |
1. Click Download image as PNG. | A PNG of the Plotly chart downloads, named after the file (or image.png). |
| VIEW-152 | Download PNG (napari views) | P3 | micro-ct z-stack, Volume | 1. Click Download image as PNG. | A screenshot of the 3D view downloads as napari-js.png. ⚠ see Known issues (KI-05). |
Stacks and slices¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-170 | Slice slider | P1 | TIFF GFPA_IBA1_…_zstack |
1. Drag the Slice slider. | Tooltip "Slice through the stack (← / → keys)". The readout shows "z of max", both 0-based (last slice: "N−1 of N−1"). The image follows (debounced while dragging, final on release). |
| VIEW-171 | ← / → keys step slices (Image view) | P1 | Same stack | 1. Hover the image. 2. Press → three times, then ←. | The slice steps one at a time. |
| VIEW-172 | Arrow keys ignored while a control has focus | P3 | Same stack | 1. Click into the Min field of Channels & Histogram. 2. Press →. | The slice does not change. |
| VIEW-173 | Zoom and pan kept across slices | P2 | WSI Project002 · … (z=13) |
1. Zoom into a corner. 2. Step slices. | The view stays where it is; previously visited slices redraw instantly. |
| VIEW-174 | Heatmap single-image mode | P2 | micro-ct z-stack, Heatmap | 1. Look at the stack toggle. 2. Drag the Slice bar and release. | Two buttons: "Single image mode" (filled) and "Stack mode". The slice tooltip reads "Slice to plot (← / → keys)". The heatmap re-plots on release (or ~400 ms after keyboard steps). |
| VIEW-175 | Heatmap stack mode | P2 | micro-ct z-stack, Heatmap | 1. Click Stack mode. | All frames load with "Loading frames..."; Plotly's own "Z-plane:" slider appears under the plot. |
| VIEW-176 | Z-plane numbering | P3 | After VIEW-175 | 1. Compare Plotly's "Z-plane:" labels with the toolbar slider. | Plotly numbers from 1, the toolbar slider from 0. ⚠ see Known issues (KI-07). |
| VIEW-177 | ← / → in Heatmap | P3 | micro-ct z-stack, Heatmap single-image mode | 1. Hover the plot, press →. 2. Focus the slice slider, press →. | Arrow keys over the plot do not step; they step only while the slider has focus. ⚠ see Known issues (KI-10). |
| VIEW-178 | No slice control in Volume without editor | P2 | micro-ct z-stack, Volume | 1. Look at the toolbar. | No Slice slider (until the slice editor is opened). |
3D views¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-190 | 3D camera controls | P1 | micro-ct z-stack, Volume | 1. Hover each 3D control. | Zoom ("Zoom"), Pan ("Pan"), Orbital rotation, Turntable rotation (highlighted by default), Reset camera ("Reset camera to default"). |
| VIEW-191 | Rotate, pan, zoom, reset | P1 | Same | 1. Drag (turntable). 2. Pick Pan and drag. 3. Scroll. 4. Click Reset camera. | The scene rotates, pans and zooms; Reset camera fits the view back to the default. |
| VIEW-192 | Orbit vs turntable | P3 | Same | 1. Pick Orbital rotation and drag. 2. Pick Turntable and drag. | On napari views both behave the same (free rotation). ⚠ see Known issues (KI-04). On Plotly 3D views (test mode) they differ. |
| VIEW-193 | 3D axes toggle | P2 | Same | 1. Click Toggle 3D axes / scale twice. | Axes with their lengths (µm when known) hide, then show. Default: shown (white icon). |
| VIEW-194 | Wireframe toggle | P3 | micro-ct slice, Surface | 1. Click Toggle wireframe. | The surface is drawn as a wireframe; click again to restore. Default off. |
| VIEW-195 | Resolution (Res) | P2 | micro-ct z-stack, Volume | 1. Open Res ("Resolution (decimate factor)"). 2. Pick Full, then ⅛. | Options Full / ½ / ¼ / ⅛, default ¼. Each change reloads the view at that detail; the box proportions do not change. ⚠ see Known issues (KI-11). |
| VIEW-196 | Volume Z-height grip | P2 | micro-ct z-stack, Volume | 1. Drag the round blue ↕ grip on the top face up by ~180 px. 2. Double-click the grip. | Tooltip "Drag to change the volume height (Z). Double-click to reset." Dragging 180 px doubles the height (clamped 0.1–10×); double-click resets. |
| VIEW-197 | Isosurface band | P2 | micro-ct z-stack, Isosurface | 1. Narrow the Iso slider to 150–255. 2. Widen it to 0–255. | Range 0–255, step 1, readout "lo–hi", default 0–255. The surface changes with the band. ⚠ see Known issues (KI-12: band behaviour on napari, band after Res change). |
| VIEW-198 | Multichannel volume | P3 | TIFF GFPA_IBA1_…_zstack, Volume |
1. Open Volume. | One tinted layer per visible channel. |
| VIEW-199 | Loading badge | P3 | micro-ct z-stack | 1. Pick Volume and watch the bottom-centre. | A pill like "Image reloading…" / "Building … in 3D…" shows (only for loads longer than ~150 ms). |
| VIEW-200 | 3D context menu | P3 | micro-ct z-stack, Volume | 1. Right-click the 3D view. | Zoom, Pan, Orbital rotation, Turntable rotation, separator, Reset camera. |
| VIEW-201 | Volume view region tools | P2 | micro-ct z-stack, Volume | 1. Look at the region part of the toolbar. | Only Region Editor, Selection, Undo, Redo, Delete and the Slice editor toggle are shown. |
Slice editor (Volume and Isosurface)¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-220 | Open the slice editor | P1 | micro-ct z-stack, Volume | 1. Click Slice editor. | A 2×2 layout: 3D volume (top-left), the slice "Z · slice N" (top-right), section through X "X · n px" (bottom-left), through Y "Y · n px" (bottom-right). The Slice slider appears. Full region tools appear. |
| VIEW-221 | Tooltip toggles | P3 | Same | 1. Hover the button before and after opening. | "Slice editor: the slice and the sections through x and y beside the 3D view" / "Close the slice editor"; aria-pressed follows. |
| VIEW-222 | Draw on the slice pane | P1 | Slice editor open | 1. Press f, draw a region in the Z pane. |
The region appears on the slice and its outline shows in the X and Y sections (translucent). |
| VIEW-223 | Drag the z plane in 3D | P2 | Slice editor open | 1. Drag the z plane's grip in the 3D view. | The slice in the Z pane follows; the plane brightens while dragged. |
| VIEW-224 | Click a section to move planes | P2 | Slice editor open | 1. Click a point in the X section. | The slice and the other section move to that point. |
| VIEW-225 | Section pane zoom and pan | P3 | Slice editor open | 1. Scroll on a section pane. 2. Drag. 3. Double-click. | Zoom about the pointer (0.2–50×); drag > 4 px pans; double-click fits. |
| VIEW-226 | Resize panes | P3 | Slice editor open | 1. Drag the vertical and horizontal dividers. 2. Focus a divider, press arrow keys. | Panes resize between 20% and 80%; arrow keys move the divider 5%. |
| VIEW-227 | Editor state kept across plot types | P3 | Slice editor open | 1. Switch to Heatmap. 2. Back to Volume. | The slice editor is open again. |
| VIEW-228 | Closing keeps Select, disarms others | P3 | Slice editor open, f armed |
1. Close the slice editor. | The freeform tool is disarmed. If Select was armed, it stays armed. |
| VIEW-229 | "Waiting for the volume…" | P3 | Large tiled stack | 1. Open Volume and the editor immediately. | Section panes show "Waiting for the volume…" until the volume is assembled. |
Intensity profile lines¶
| ID | Title | Pri | Preconditions / data | Steps | Expected result |
|---|---|---|---|---|---|
| VIEW-240 | Add a line | P1 | img01.png |
1. Click Add an intensity line. | A horizontal line across about two-thirds of the visible image, selected with handles (Select armed). A floating "Intensity profile" panel opens near the top-right with "Line 1". |
| VIEW-241 | Line colours cycle | P3 | img01.png |
1. Add 9 lines. | Lines are placed 12% lower each time (clamped to the view); colours cycle through 8 colours (yellow, cyan, pink, green, orange, purple, red, aqua) and repeat. |
| VIEW-242 | Live profile while dragging | P1 | One line | 1. Drag an endpoint across a structure. | The trace updates live; x axis "Position (px)" (or "Position (µm)" with a pixel size), y axis "Intensity". |
| VIEW-243 | µm units | P2 | WSI CMU-1 |
1. Add a line. | x axis reads "Position (µm)". |
| VIEW-244 | Re-sampled at current zoom | P3 | WSI CMU-1, one line |
1. Zoom in on the line and wait. | The trace gets more detail once the view settles. |
| VIEW-245 | Delete a line | P2 | Two lines | 1. Click a line to select it. 2. Click the trash tool (or press Del). | That line and its trace are removed; the other remains. |
| VIEW-246 | Lines are not regions | P2 | One line, Region Editor open | 1. Look at the Region Editor table. 2. Export GeoJSON. | The line is not listed and not exported; Select all does not select it. |
| VIEW-247 | Only in Image and Heatmap | P3 | micro-ct slice | 1. Switch to Contour and Surface. | The Add an intensity line button is shown only in Image and Heatmap. |
| VIEW-248 | Move the inset | P3 | One line | 1. Drag the inset by its header. | The inset moves. |
| VIEW-249 | Values are display values | P3 | WSI 2-channel fluorescence |
1. Add a line. | Values are 8-bit display/preview values (0–255), not native 16-bit values; RGB is converted to luminance. |