From d295609a3f8a797a33dc56b59ee60088fb277c73 Mon Sep 17 00:00:00 2001 From: Paul Elliott Date: Wed, 11 Nov 2026 21:30:13 -0500 Subject: [PATCH 1/4] fix(volume-rendering): fit Shift and Width slider steps to the color range Derive the slider step and bounds from the full mapping range rather than the image data range and a fixed Width minimum of 1, so normalized and narrow float volumes and volumes with far outliers can be edited, and an unshifted range sits on the Shift slider grid. --- src/components/VolumeRendering.vue | 35 +++------- .../__tests__/mappingRangeSliders.spec.ts | 29 ++++++++ src/utils/mappingRangeSliders.ts | 14 ++++ tests/specs/volume-coloring-reset.e2e.ts | 25 ++----- .../specs/volume-mapping-range-sliders.e2e.ts | 68 +++++++++++++++++++ tests/specs/volume-modality-presets.e2e.ts | 29 ++------ tests/specs/volumeTestUtils.ts | 25 ++++++- 7 files changed, 155 insertions(+), 70 deletions(-) create mode 100644 src/utils/__tests__/mappingRangeSliders.spec.ts create mode 100644 src/utils/mappingRangeSliders.ts create mode 100644 tests/specs/volume-mapping-range-sliders.e2e.ts diff --git a/src/components/VolumeRendering.vue b/src/components/VolumeRendering.vue index 77e549b97..cd7048d16 100644 --- a/src/components/VolumeRendering.vue +++ b/src/components/VolumeRendering.vue @@ -21,6 +21,7 @@ import { useResizeObserver } from '@/src/composables/useResizeObserver'; import { useCurrentImage } from '@/src/composables/useCurrentImage'; import useVolumeColoringStore from '@/src/store/view-configs/volume-coloring'; import { piecewiseHistogram } from '@/src/utils/histogram'; +import { mappingRangeSliders } from '@/src/utils/mappingRangeSliders'; import { getColorFunctionRangeFromPreset, getScalarSample, @@ -254,21 +255,11 @@ export default defineComponent({ ); const hasCurrentImage = computed(() => !!currentImageData.value); - // the data range, if any - const imageDataRange = computed((): [number, number] => { - const image = currentImageData.value; - if (image) { - return image.getPointData().getScalars().getRange(); - } - return [0, 1]; - }); - // The store refits a relative preset's opacity range once a streaming image loads. const fullMappingRange = computed( () => getColorFunctionRangeFromPreset(selectedPreset.value || '') || - opacityFunction.value?.mappingRange || - imageDataRange.value + opacityFunction.value?.mappingRange || [0, 1] ); const fullMappingRangeWidth = computed(() => { const range = fullMappingRange.value; @@ -351,17 +342,9 @@ export default defineComponent({ mappingRange: computed( () => colorTransferFunctionRef.value!.mappingRange ), - colorSliderStep: computed(() => { - const [low, high] = imageDataRange.value; - const width = high - low; - const step = Math.min(1, width / 256); - return step > 1 ? Math.round(step) : step; - }), - rangeShiftMin: computed(() => -fullMappingRangeWidth.value / 2), - rangeShiftMax: computed(() => fullMappingRangeWidth.value / 2), + sliders: computed(() => mappingRangeSliders(fullMappingRangeWidth.value)), rangeShift, rangeWidth, - rangeWidthMax: computed(() => fullMappingRangeWidth.value * 2), request3DAnimation, cancel3DAnimation, selectPreset, @@ -388,9 +371,9 @@ export default defineComponent({ density="compact" hide-details label="Shift" - :min="rangeShiftMin" - :max="rangeShiftMax" - :step="colorSliderStep" + :min="sliders.shift[0]" + :max="sliders.shift[1]" + :step="sliders.step" @pointerdown="request3DAnimation" @pointerup="cancel3DAnimation" /> @@ -400,9 +383,9 @@ export default defineComponent({ density="compact" hide-details label="Width" - min="1" - :max="rangeWidthMax" - :step="colorSliderStep" + :min="sliders.width[0]" + :max="sliders.width[1]" + :step="sliders.step" @pointerdown="request3DAnimation" @pointerup="cancel3DAnimation" /> diff --git a/src/utils/__tests__/mappingRangeSliders.spec.ts b/src/utils/__tests__/mappingRangeSliders.spec.ts new file mode 100644 index 000000000..8357cfc07 --- /dev/null +++ b/src/utils/__tests__/mappingRangeSliders.spec.ts @@ -0,0 +1,29 @@ +import { describe, expect, it } from 'vitest'; +import { mappingRangeSliders } from '@/src/utils/mappingRangeSliders'; + +const onGrid = (value: number, origin: number, step: number) => + Number.isInteger((value - origin) / step); + +describe('mappingRangeSliders', () => { + it.each([0.01, 0.78, 6095, 6095.5])( + 'lets Width shrink below the full width %s and keeps zero shift on the grid', + (fullWidth) => { + const { step, shift, width } = mappingRangeSliders(fullWidth); + expect(step).toBeGreaterThan(0); + expect(step).toBeLessThanOrEqual(Math.min(1, fullWidth / 2)); + expect(width[0]).toBeLessThan(fullWidth); + expect(width[1]).toBe(2 * fullWidth); + expect(shift[0]).toBe(-shift[1]); + expect(shift[1]).toBeGreaterThanOrEqual(fullWidth / 2); + expect(onGrid(0, shift[0], step)).toBe(true); + } + ); + + it('steps by whole units over large ranges', () => { + expect(mappingRangeSliders(6095)).toEqual({ + step: 1, + shift: [-3048, 3048], + width: [1, 12190], + }); + }); +}); diff --git a/src/utils/mappingRangeSliders.ts b/src/utils/mappingRangeSliders.ts new file mode 100644 index 000000000..80e70af1a --- /dev/null +++ b/src/utils/mappingRangeSliders.ts @@ -0,0 +1,14 @@ +/** + * Step and bounds for the Shift and Width sliders that edit a mapping range + * relative to a full range of the given width. + */ +export function mappingRangeSliders(fullWidth: number) { + const step = Math.min(1, fullWidth / 256); + // Whole steps either side of zero keep an unshifted range on the slider grid. + const halfShift = step > 0 ? Math.ceil(fullWidth / 2 / step) * step : 0; + return { + step, + shift: [-halfShift, halfShift] as const, + width: [step, 2 * fullWidth] as const, + }; +} diff --git a/tests/specs/volume-coloring-reset.e2e.ts b/tests/specs/volume-coloring-reset.e2e.ts index 095a6431a..86abb10d8 100644 --- a/tests/specs/volume-coloring-reset.e2e.ts +++ b/tests/specs/volume-coloring-reset.e2e.ts @@ -6,8 +6,11 @@ import { nrrd, showColorPresets, openWith3DLayout, + pressOn, radialRamp, selectedPreset, + sliderThumb, + stablePixels, writeNrrd, } from './volumeTestUtils'; @@ -15,9 +18,8 @@ const SIZE = 16; const EDITOR = '[data-testid="volume-opacity-editor"]'; const RESET = '[data-testid="volume-reset-color-opacity"]'; -const thumb = (slider: string) => $(slider).$('[role="slider"]'); -const shiftThumb = () => thumb('[data-testid="volume-color-shift"]'); -const widthThumb = () => thumb('[data-testid="volume-color-width"]'); +const shiftThumb = () => sliderThumb('volume-color-shift'); +const widthThumb = () => sliderThumb('volume-color-width'); const ambientThumb = () => $('.v-slider*=Ambient').$('[role="slider"]'); const sliderValue = async (slider: ChainablePromiseElement) => String(await slider.getAttribute('aria-valuenow')); @@ -46,23 +48,6 @@ async function waitForPixels( ); } -async function stablePixels(selector: string, inset: number) { - let previous = await pixels(selector, inset, 'volume-coloring-stable.png'); - await browser.waitUntil(async () => { - const next = await pixels(selector, inset, 'volume-coloring-stable.png'); - const same = next.equals(previous); - previous = next; - return same; - }); - return previous; -} - -async function pressOn(slider: ChainablePromiseElement, key: string) { - await slider.scrollIntoView({ block: 'center', behavior: 'instant' }); - await slider.click(); - await browser.keys(key); -} - async function dragOpacityCurve(steps: number) { const editor = $(EDITOR).$('canvas'); await editor.scrollIntoView({ block: 'center', behavior: 'instant' }); diff --git a/tests/specs/volume-mapping-range-sliders.e2e.ts b/tests/specs/volume-mapping-range-sliders.e2e.ts new file mode 100644 index 000000000..8061770bc --- /dev/null +++ b/tests/specs/volume-mapping-range-sliders.e2e.ts @@ -0,0 +1,68 @@ +import { volViewPage } from '../pageobjects/volview.page'; +import { waitForModuleTransitions } from './utils'; +import { + differingFraction, + floatVoxels, + nrrd, + openWith3DLayout, + pressOn, + radialRamp, + sliderThumb, + stablePixels, + writeNrrd, +} from './volumeTestUtils'; + +const SIZE = 16; +const VIEW = '[data-testid~="vtk-volume-view"]'; + +const ramp = radialRamp(SIZE); +const VOLUMES: [string, (index: number) => number][] = [ + ['normalized with a far outlier', (i) => (i === 0 ? 1000 : ramp(i) / 1000)], + ['spanning 0 to 0.01', (i) => ramp(i) / 1e5], + ['in Hounsfield units', (i) => (ramp(i) > 300 ? 700 : ramp(i) ? 40 : -1024)], +]; + +async function slider(testId: string) { + const thumb = sliderThumb(testId); + const [min, max, now] = await Promise.all( + ['aria-valuemin', 'aria-valuemax', 'aria-valuenow'].map(async (name) => + Number(await thumb.getAttribute(name)) + ) + ); + return { thumb, min, max, now }; +} + +describe('3D rendering Shift and Width sliders', () => { + VOLUMES.forEach(([label, valueAt], index) => { + it(`edit the color range of a volume ${label}`, async () => { + const name = `volume-mapping-range-${index}`; + await openWith3DLayout( + writeNrrd(name, nrrd([], 'float', SIZE), floatVoxels(SIZE, valueAt)), + name + ); + await volViewPage.renderingModuleTab.waitForClickable(); + await volViewPage.renderingModuleTab.click(); + await waitForModuleTransitions(); + + const shift = await slider('volume-color-shift'); + const width = await slider('volume-color-width'); + expect(shift.now).toBe(0); + expect(width.min).toBeLessThan(width.now); + expect(width.max / width.now).toBeCloseTo(2, 6); + + const before = await stablePixels(VIEW, 40); + await pressOn(width.thumb, 'Home'); + const narrowed = await slider('volume-color-width'); + expect(narrowed.now).toBe(narrowed.min); + expect(narrowed.now).toBeLessThan(width.now / 100); + expect( + differingFraction(before, await stablePixels(VIEW, 40)) + ).toBeGreaterThan(0.05); + + await pressOn(shift.thumb, 'ArrowRight'); + const shifted = await slider('volume-color-shift'); + expect(shifted.now).toBeGreaterThan(0); + expect(shifted.now).toBeLessThanOrEqual(width.now / 128); + }); + }); +}); diff --git a/tests/specs/volume-modality-presets.e2e.ts b/tests/specs/volume-modality-presets.e2e.ts index 015ba3b0c..5bf7ababb 100644 --- a/tests/specs/volume-modality-presets.e2e.ts +++ b/tests/specs/volume-modality-presets.e2e.ts @@ -15,6 +15,7 @@ import { showColorPresets, openWith3DLayout, selectedPreset, + stablePixels, writeNrrd, } from './volumeTestUtils'; @@ -116,6 +117,8 @@ describe('volume preset from declared modality', () => { }); }); +const VIEW = '[data-testid~="vtk-volume-view"]'; + // The inset keeps only the view center, where every test volume has signal. const CENTER_INSET = 280; @@ -132,26 +135,6 @@ async function brightCenterPixels(name: string, inset: number, level = 40) { return { bright, fraction: bright / (data.length / 4) }; } -/** Captures the 3D view until two consecutive frames match. */ -async function stableViewPixels() { - const capture = async () => - ( - await captureViewPixels( - '[data-testid~="vtk-volume-view"]', - 40, - 'stable-view.png' - ) - )[0].data; - let previous = await capture(); - await browser.waitUntil(async () => { - const next = await capture(); - const same = next.equals(previous); - previous = next; - return same; - }); - return previous; -} - async function expectVisibleVolume(name: string) { await browser.waitUntil( async () => (await brightCenterPixels(name, CENTER_INSET)).bright > 50, @@ -251,7 +234,7 @@ describe('grayscale default fitted to the data', () => { name ); await expectVisibleVolume(name); - rendered.push(await stableViewPixels()); + rendered.push(await stablePixels(VIEW, 40)); } expect(differingFraction(rendered[0], rendered[1])).toBeLessThan(0.01); }); @@ -266,7 +249,7 @@ describe('grayscale default fitted to the data', () => { loadedName ); await expectVisibleVolume(loadedName); - const loaded = await stableViewPixels(); + const loaded = await stablePixels(VIEW, 40); const name = 'fitted-mr-dicom'; const manifest = `${name}.json`; @@ -277,7 +260,7 @@ describe('grayscale default fitted to the data', () => { await openWith3DLayout(`tmp/${manifest}`, name); // Ray jitter differs between sources on ~8%; a range left unfit differs on ~45%. await browser.waitUntil( - async () => differingFraction(loaded, await stableViewPixels()) < 0.2, + async () => differingFraction(loaded, await stablePixels(VIEW, 40)) < 0.2, { timeoutMsg: 'Expected the streamed series to match once refit' } ); }); diff --git a/tests/specs/volumeTestUtils.ts b/tests/specs/volumeTestUtils.ts index a99898fbb..1c1fbc470 100644 --- a/tests/specs/volumeTestUtils.ts +++ b/tests/specs/volumeTestUtils.ts @@ -1,7 +1,7 @@ import fs from 'node:fs'; import path from 'node:path'; import { volViewPage } from '../pageobjects/volview.page'; -import { makeTempDir, writeManifestToFile } from './utils'; +import { captureViewPixels, makeTempDir, writeManifestToFile } from './utils'; const LAYOUT = { layouts: { @@ -88,3 +88,26 @@ export function differingFraction(a: Buffer, b: Buffer) { } return differing / (a.length / 4); } + +export const sliderThumb = (testId: string) => + $(`[data-testid="${testId}"]`).$('[role="slider"]'); + +/** Captures a view until two consecutive frames match. */ +export async function stablePixels(selector: string, inset: number) { + const capture = async () => + (await captureViewPixels(selector, inset, 'stable-pixels.png'))[0].data; + let previous = await capture(); + await browser.waitUntil(async () => { + const next = await capture(); + const same = next.equals(previous); + previous = next; + return same; + }); + return previous; +} + +export async function pressOn(slider: ChainablePromiseElement, key: string) { + await slider.scrollIntoView({ block: 'center', behavior: 'instant' }); + await slider.click(); + await browser.keys(key); +} From 3e91cdf47b5770aa28d35451c5e879faa5ead2f1 Mon Sep 17 00:00:00 2001 From: Paul Elliott Date: Sun, 15 Nov 2026 03:42:13 -0500 Subject: [PATCH 2/4] test(volume-rendering): bound the slider step at 1/256 of the color range --- src/utils/__tests__/mappingRangeSliders.spec.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/utils/__tests__/mappingRangeSliders.spec.ts b/src/utils/__tests__/mappingRangeSliders.spec.ts index 8357cfc07..bc6553365 100644 --- a/src/utils/__tests__/mappingRangeSliders.spec.ts +++ b/src/utils/__tests__/mappingRangeSliders.spec.ts @@ -10,7 +10,7 @@ describe('mappingRangeSliders', () => { (fullWidth) => { const { step, shift, width } = mappingRangeSliders(fullWidth); expect(step).toBeGreaterThan(0); - expect(step).toBeLessThanOrEqual(Math.min(1, fullWidth / 2)); + expect(step).toBeLessThanOrEqual(Math.min(1, fullWidth / 256)); expect(width[0]).toBeLessThan(fullWidth); expect(width[1]).toBe(2 * fullWidth); expect(shift[0]).toBe(-shift[1]); From 778a094460985f1603a48527eeb1d1f7c8265fbc Mon Sep 17 00:00:00 2001 From: Paul Elliott Date: Mon, 16 Nov 2026 17:11:47 -0500 Subject: [PATCH 3/4] test(volume-rendering): share the 3D view selector across volume specs --- tests/specs/volume-mapping-range-sliders.e2e.ts | 2 +- tests/specs/volume-modality-presets.e2e.ts | 9 ++------- tests/specs/volumeTestUtils.ts | 2 ++ 3 files changed, 5 insertions(+), 8 deletions(-) diff --git a/tests/specs/volume-mapping-range-sliders.e2e.ts b/tests/specs/volume-mapping-range-sliders.e2e.ts index 8061770bc..6aa75864f 100644 --- a/tests/specs/volume-mapping-range-sliders.e2e.ts +++ b/tests/specs/volume-mapping-range-sliders.e2e.ts @@ -9,11 +9,11 @@ import { radialRamp, sliderThumb, stablePixels, + VIEW, writeNrrd, } from './volumeTestUtils'; const SIZE = 16; -const VIEW = '[data-testid~="vtk-volume-view"]'; const ramp = radialRamp(SIZE); const VOLUMES: [string, (index: number) => number][] = [ diff --git a/tests/specs/volume-modality-presets.e2e.ts b/tests/specs/volume-modality-presets.e2e.ts index 5bf7ababb..6684c27b5 100644 --- a/tests/specs/volume-modality-presets.e2e.ts +++ b/tests/specs/volume-modality-presets.e2e.ts @@ -16,6 +16,7 @@ import { openWith3DLayout, selectedPreset, stablePixels, + VIEW, writeNrrd, } from './volumeTestUtils'; @@ -117,17 +118,11 @@ describe('volume preset from declared modality', () => { }); }); -const VIEW = '[data-testid~="vtk-volume-view"]'; - // The inset keeps only the view center, where every test volume has signal. const CENTER_INSET = 280; async function brightCenterPixels(name: string, inset: number, level = 40) { - const [{ data }] = await captureViewPixels( - '[data-testid~="vtk-volume-view"]', - inset, - `${name}.png` - ); + const [{ data }] = await captureViewPixels(VIEW, inset, `${name}.png`); let bright = 0; for (let index = 0; index < data.length; index += 4) if (Math.max(data[index], data[index + 1], data[index + 2]) > level) diff --git a/tests/specs/volumeTestUtils.ts b/tests/specs/volumeTestUtils.ts index 1c1fbc470..0e121931a 100644 --- a/tests/specs/volumeTestUtils.ts +++ b/tests/specs/volumeTestUtils.ts @@ -3,6 +3,8 @@ import path from 'node:path'; import { volViewPage } from '../pageobjects/volview.page'; import { captureViewPixels, makeTempDir, writeManifestToFile } from './utils'; +export const VIEW = '[data-testid~="vtk-volume-view"]'; + const LAYOUT = { layouts: { default: { From 2843a0f3cd7b4505436844c8824b31a8e4601251 Mon Sep 17 00:00:00 2001 From: Paul Elliott Date: Mon, 16 Nov 2026 21:32:00 -0500 Subject: [PATCH 4/4] test(volume-rendering): wait for the narrowed render after Home on Width --- tests/specs/volume-mapping-range-sliders.e2e.ts | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/tests/specs/volume-mapping-range-sliders.e2e.ts b/tests/specs/volume-mapping-range-sliders.e2e.ts index 6aa75864f..a6605c98b 100644 --- a/tests/specs/volume-mapping-range-sliders.e2e.ts +++ b/tests/specs/volume-mapping-range-sliders.e2e.ts @@ -55,9 +55,11 @@ describe('3D rendering Shift and Width sliders', () => { const narrowed = await slider('volume-color-width'); expect(narrowed.now).toBe(narrowed.min); expect(narrowed.now).toBeLessThan(width.now / 100); - expect( - differingFraction(before, await stablePixels(VIEW, 40)) - ).toBeGreaterThan(0.05); + await browser.waitUntil( + async () => + differingFraction(before, await stablePixels(VIEW, 40)) > 0.05, + { timeoutMsg: 'Expected Home on Width to narrow the 3D render' } + ); await pressOn(shift.thumb, 'ArrowRight'); const shifted = await slider('volume-color-shift');