copper3d 3.4.3 → 3.4.5

package/dist/Utils/segmentation/tools/ZoomTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ZoomTool.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/tools/ZoomTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ZoomTool.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/tools/ZoomTool.ts"],"names":[],"mappings":"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"}

package/dist/bundle.esm.js

@@ -70871,6 +70871,17 @@ class MaskVolume {
      * @throws {RangeError} If any dimension or the channel count is < 1.
      */
     constructor(width, height, depth, channels = 1, customColorMap) {
+        /**
+         * Monotonic data-mutation counter.
+         *
+         * Incremented by every method that mutates voxel data (not color).
+         * Consumers (e.g. the contour cache in RenderingUtils) key cached
+         * derivations on this value so an edit automatically invalidates them —
+         * it is impossible to forget an invalidation point because every write
+         * bumps the version. Color-map changes do **not** bump it (colors are
+         * applied at fill time, never cached).
+         */
+        this.version = 0;
         if (width < 1 || height < 1 || depth < 1) {
             throw new RangeError(`Dimensions must be ≥ 1, got (${width}, ${height}, ${depth})`);
         }
@@ -70960,6 +70971,16 @@ class MaskVolume {
      */
     setVoxel(x, y, z, value, channel = 0) {
         this.data[this.getIndex(x, y, z, channel)] = value;
+        this.version++;
+    }
+    /**
+     * Return the current data-mutation version.
+     *
+     * Increments on every voxel write. Use as a cache key so derived data
+     * (e.g. extracted contours) is invalidated whenever the volume changes.
+     */
+    getVersion() {
+        return this.version;
     }
     // ── Color map management ──────────────────────────────────────────
     /**
@@ -71116,6 +71137,7 @@ class MaskVolume {
             throw new Error(`ImageData size mismatch: expected ${expectedW}×${expectedH}, ` +
                 `got ${imageData.width}×${imageData.height}`);
         }
+        this.version++;
         const pixels = imageData.data;
         const { width, height } = this.dims;
         const ch = this.numChannels;
@@ -71217,6 +71239,7 @@ class MaskVolume {
             throw new Error(`ImageData size mismatch: expected ${expectedW}×${expectedH}, ` +
                 `got ${imageData.width}×${imageData.height}`);
         }
+        this.version++;
         // Build RGB→channel lookup map for O(1) reverse lookup
         const rgbToChannel = this.buildRgbToChannelMap();
         const pixels = imageData.data;
@@ -71481,6 +71504,7 @@ class MaskVolume {
             throw new Error(`Data length mismatch: expected ${this.data.length}, got ${newData.length}`);
         }
         this.data = newData;
+        this.version++;
     }
     /**
      * Create an independent deep copy of this volume.
@@ -71520,6 +71544,7 @@ class MaskVolume {
      */
     clear() {
         this.data.fill(0);
+        this.version++;
     }
     /**
      * Check if the volume contains any non-zero voxel data.
@@ -71572,6 +71597,7 @@ class MaskVolume {
      */
     clearSlice(sliceIndex, axis = 'z', channel) {
         this.validateSliceIndex(sliceIndex, axis);
+        this.version++;
         const [sliceW, sliceH] = this.getSliceDimensions(axis);
         const volData = this.data;
         const nch = this.numChannels;
@@ -71683,6 +71709,7 @@ class MaskVolume {
      */
     setSliceUint8(sliceIndex, data, axis = 'z') {
         this.validateSliceIndex(sliceIndex, axis);
+        this.version++;
         const [sliceW, sliceH] = this.getSliceDimensions(axis);
         const nch = this.numChannels;
         const rowStride = this.dims.width * nch;
@@ -72126,10 +72153,18 @@ const CELL_POLYGONS = [
     /* 15 (full)  */ [[[0, 0], [1, 0], [1, 1], [0, 1]]],
 ];
 /**
- * Emit all per-cell polygons covering the voxels where `labels === targetLabel`.
+ * Emit polygons covering the voxels where `labels === targetLabel`.
  * Pure geometry function — no Canvas dependency. Consumers can build a Path2D
  * (see {@link extractLabelContours}) or walk the vertex arrays directly
  * (tests, export, stroke rendering).
+ *
+ * Boundary cells (marching-squares cases 1–14) emit their cut polygon as
+ * usual. Solid interior (case 15) is **coalesced into horizontal run-length
+ * rectangles** instead of one unit square per cell, collapsing the subpath
+ * count from O(area) to ≈ O(perimeter + rows). The filled region is
+ * pixel-identical (contiguous full-cell squares tile exactly into a rectangle
+ * with the same TL→TR→BR→BL winding), which is what keeps slice-scrubbing
+ * fast on large masks without changing the rendered silhouette.
  */
 function extractLabelPolygons(labels, width, height, targetLabel, stride = 1, channelOffset = 0, bbox) {
     var _a, _b, _c, _d;
@@ -72151,7 +72186,25 @@ function extractLabelPolygons(labels, width, height, targetLabel, stride = 1, ch
     // map to voxel-square CENTERS in render space. Voxel (i, j) occupies
     // render square [i, i+1] × [j, j+1]; its center is (i+0.5, j+0.5).
     const SHIFT = 0.5;
+    // Emit a single rectangle covering a contiguous run of full (code 15)
+    // cells [runStart .. runEnd] on row j. A full cell i covers render square
+    // [i+0.5, i+1.5] × [j+0.5, j+1.5]; consecutive full cells tile perfectly,
+    // so the run is pixel-identical to the per-cell squares it replaces.
+    // Vertices use the same TL→TR→BR→BL (CCW screen-space) winding as the
+    // case-15 unit square, so the nonzero fill matches at shared edges.
+    const pushFullRun = (runStart, runEnd, j) => {
+        const x0 = runStart + SHIFT;
+        const x1 = runEnd + 1 + SHIFT;
+        const y0 = j + SHIFT;
+        const y1 = j + 1 + SHIFT;
+        out.push([[x0, y0], [x1, y0], [x1, y1], [x0, y1]]);
+    };
     for (let j = j0; j < j1; j++) {
+        // Index where the current contiguous run of full (code 15) cells began,
+        // or -1 when no run is open. Coalescing the solid interior into row runs
+        // drops the per-cell square count from O(area) to O(rows + perimeter),
+        // which is what keeps fast slice-scrubbing smooth on large masks.
+        let runStart = -1;
         for (let i = i0; i < i1; i++) {
             const tl = sample(i, j);
             const tr = sample(i + 1, j);
@@ -72161,6 +72214,17 @@ function extractLabelPolygons(labels, width, height, targetLabel, stride = 1, ch
                 (tr ? 4 : 0) |
                 (br ? 2 : 0) |
                 (bl ? 1 : 0);
+            if (code === 15) {
+                // Extend (or open) the current full-cell run; defer emission.
+                if (runStart === -1)
+                    runStart = i;
+                continue;
+            }
+            // Non-full cell ends any open run — flush it as one rectangle.
+            if (runStart !== -1) {
+                pushFullRun(runStart, i - 1, j);
+                runStart = -1;
+            }
             if (code === 0)
                 continue;
             const polygons = CELL_POLYGONS[code];
@@ -72173,6 +72237,10 @@ function extractLabelPolygons(labels, width, height, targetLabel, stride = 1, ch
                 out.push(abs);
             }
         }
+        // Flush a run that reached the end of the row (last visited cell is i1-1).
+        if (runStart !== -1) {
+            pushFullRun(runStart, i1 - 1, j);
+        }
     }
     return out;
 }
@@ -73637,6 +73705,23 @@ class RenderingUtils {
         this._reusableSliceBuffer = null;
         this._reusableBufferWidth = 0;
         this._reusableBufferHeight = 0;
+        /**
+         * Per-layer contour cache.
+         *
+         * Caches the *expensive* part of slice rendering — `getSliceUint8` +
+         * `findLabelsInSlice` + `extractLabelContours` (Path2D build) — keyed by
+         * `${axis}:${sliceIndex}:${volume.version}`. The contours live in voxel
+         * coordinates; zoom only changes the `ctx.scale` transform, so on zoom /
+         * recomposite we reuse the cached Path2D and just re-fill, skipping
+         * marching-squares entirely. A volume edit bumps its version → cache miss
+         * → recompute (correct, automatic). Colors and channel visibility are
+         * applied at fill time and intentionally *not* cached, so toggling them
+         * needs no recompute.
+         *
+         * One entry per layer (the current slice). Switching slice/axis or
+         * editing overwrites it.
+         */
+        this._contourCache = new Map();
         this.state = state;
     }
     // ── Volume Accessor Helpers ──────────────────────────────────────
@@ -73735,14 +73820,27 @@ class RenderingUtils {
             const volume = this.getVolumeForLayer(layer);
             if (!volume)
                 return;
-            const channelVis = this.state.gui_states.layerChannel.channelVisibility[layer];
-            const slice = volume.getSliceUint8(sliceIndex, axis);
-            const W = slice.width;
-            const H = slice.height;
             const stride = volume.getChannels();
-            const labels = findLabelsInSlice(slice.data, W, H, stride, 0);
-            if (labels.length === 0)
+            const cacheKey = `${axis}:${sliceIndex}:${volume.getVersion()}`;
+            // Cache miss → run the expensive extraction once. Hits (zoom,
+            // recomposite, contrast toggle) skip straight to the fill below.
+            let entry = this._contourCache.get(layer);
+            if (!entry || entry.key !== cacheKey) {
+                const slice = volume.getSliceUint8(sliceIndex, axis);
+                const W = slice.width;
+                const H = slice.height;
+                const labels = findLabelsInSlice(slice.data, W, H, stride, 0);
+                const paths = new Map();
+                for (const lbl of labels) {
+                    paths.set(lbl, extractLabelContours(slice.data, W, H, lbl, stride, 0));
+                }
+                entry = { key: cacheKey, W, H, labels, paths };
+                this._contourCache.set(layer, entry);
+            }
+            if (entry.labels.length === 0)
                 return;
+            const { W, H, labels, paths } = entry;
+            const channelVis = this.state.gui_states.layerChannel.channelVisibility[layer];
             targetCtx.save();
             // Vector fill — imageSmoothingEnabled is irrelevant here, but keep
             // it off to match the rest of the pipeline.
@@ -73759,8 +73857,10 @@ class RenderingUtils {
             for (const lbl of labels) {
                 if (channelVis && channelVis[lbl] === false)
                     continue;
+                const path = paths.get(lbl);
+                if (!path)
+                    continue;
                 const color = volume.getChannelColor(lbl);
-                const path = extractLabelContours(slice.data, W, H, lbl, stride, 0);
                 targetCtx.fillStyle =
                     `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a / 255})`;
                 targetCtx.fill(path, 'nonzero');
@@ -73778,6 +73878,7 @@ class RenderingUtils {
         this._reusableSliceBuffer = null;
         this._reusableBufferWidth = 0;
         this._reusableBufferHeight = 0;
+        this._contourCache.clear();
     }
     /**
      * Apply the same flip transform used by flipDisplayImageByAxis() to any
@@ -74536,7 +74637,30 @@ class ZoomTool extends BaseTool {
     }
     // ===== Zoom Wheel =====
     configMouseZoomWheel() {
-        let moveDistance = 1;
+        // Coalesce multiple wheel events fired within one frame into a single
+        // resizePaintArea() call via requestAnimationFrame. Each resize triggers
+        // a full display redraw (+ mask recomposite), so without coalescing a
+        // fast scroll fires dozens of these per frame. The accumulation is done
+        // on the logical zoom (sizeFactor) — not the DOM offsetWidth — so deltas
+        // still compound correctly even though the DOM size hasn't updated yet.
+        let rafId = null;
+        let pending = null;
+        const flush = () => {
+            rafId = null;
+            if (!pending)
+                return;
+            const p = pending;
+            pending = null;
+            if (p.recenter) {
+                this.callbacks.resetPaintAreaUIPosition();
+            }
+            else {
+                this.callbacks.resetPaintAreaUIPosition(p.l, p.t);
+            }
+            this.callbacks.resizePaintArea(p.moveDistance);
+            this.callbacks.setIsDrawFalse(1000);
+            this.ctx.nrrd_states.view.sizeFactor = p.moveDistance;
+        };
         return (e) => {
             var _a, _b;
             if ((_a = this.ctx.eventRouter) === null || _a === void 0 ? void 0 : _a.isShiftHeld()) {
@@ -74551,36 +74675,38 @@ class ZoomTool extends BaseTool {
             const delta = e.detail ? e.detail > 0 : e.wheelDelta < 0;
             this.ctx.protectedData.isDrawing = true;
             const rect = this.container.getBoundingClientRect();
-            const ratioL = (e.clientX -
-                rect.left -
-                this.mainAreaContainer.offsetLeft -
-                this.ctx.protectedData.canvases.drawingCanvas.offsetLeft) /
-                this.ctx.protectedData.canvases.drawingCanvas.offsetWidth;
-            const ratioT = (e.clientY -
-                rect.top -
-                this.mainAreaContainer.offsetTop -
-                this.ctx.protectedData.canvases.drawingCanvas.offsetTop) /
-                this.ctx.protectedData.canvases.drawingCanvas.offsetHeight;
+            const drawingCanvas = this.ctx.protectedData.canvases.drawingCanvas;
+            const ratioL = (e.clientX - rect.left - this.mainAreaContainer.offsetLeft - drawingCanvas.offsetLeft) /
+                drawingCanvas.offsetWidth;
+            const ratioT = (e.clientY - rect.top - this.mainAreaContainer.offsetTop - drawingCanvas.offsetTop) /
+                drawingCanvas.offsetHeight;
             const ratioDelta = !delta ? 1 + 0.1 : 1 - 0.1;
-            const w = this.ctx.protectedData.canvases.drawingCanvas.offsetWidth * ratioDelta;
-            const h = this.ctx.protectedData.canvases.drawingCanvas.offsetHeight * ratioDelta;
-            const l = Math.round(e.clientX - this.mainAreaContainer.offsetLeft - w * ratioL - rect.left);
-            const t = Math.round(e.clientY - this.mainAreaContainer.offsetTop - h * ratioT - rect.top);
-            moveDistance = w / this.ctx.nrrd_states.image.originWidth;
+            // Compound from the latest pending target (this frame) or the current
+            // committed sizeFactor.
+            const base = pending ? pending.moveDistance : this.ctx.nrrd_states.view.sizeFactor;
+            let moveDistance = base * ratioDelta;
             if (moveDistance > 8) {
+                // Max zoom: original behaviour clamps without re-laying out.
                 moveDistance = 8;
+                this.ctx.nrrd_states.view.sizeFactor = moveDistance;
+                this.callbacks.setIsDrawFalse(1000);
+                return;
             }
-            else if (moveDistance < 1) {
+            if (moveDistance < 1) {
                 moveDistance = 1;
-                this.callbacks.resetPaintAreaUIPosition();
-                this.callbacks.resizePaintArea(moveDistance);
+                pending = { moveDistance, l: 0, t: 0, recenter: true };
             }
             else {
-                this.callbacks.resetPaintAreaUIPosition(l, t);
-                this.callbacks.resizePaintArea(moveDistance);
+                // Target displayed size for this zoom level → keep cursor anchored.
+                const w = this.ctx.nrrd_states.image.originWidth * moveDistance;
+                const h = this.ctx.nrrd_states.image.originHeight * moveDistance;
+                const l = Math.round(e.clientX - this.mainAreaContainer.offsetLeft - w * ratioL - rect.left);
+                const t = Math.round(e.clientY - this.mainAreaContainer.offsetTop - h * ratioT - rect.top);
+                pending = { moveDistance, l, t, recenter: false };
+            }
+            if (rafId === null) {
+                rafId = requestAnimationFrame(flush);
             }
-            this.callbacks.setIsDrawFalse(1000);
-            this.ctx.nrrd_states.view.sizeFactor = moveDistance;
         };
     }
 }
@@ -79324,7 +79450,7 @@ function evaluateElement(element, weights) {
 }
 
 // import * as kiwrious from "copper3d_plugin_heart_k";
-const REVISION = "v3.4.3-beta";
+const REVISION = "v3.4.5-beta";
 console.log(`%cCopper3D Visualisation %cBeta:${REVISION}`, "padding: 3px;color:white; background:#023047", "padding: 3px;color:white; background:#f50a25");
 
 export { CHANNEL_COLORS, CHANNEL_HEX_COLORS, CameraViewPoint, Copper3dTrackballControls, GaussianSmoother, MeshNodeTool, NrrdTools, REVISION, addBoxHelper, addLabelToScene, configKiwriousHeart, convert3DPostoScreenPos, convertScreenPosto3DPos, copperMScene, copperMSceneRenderer, copperRenderer, copperRendererOnDemond, copperScene, copperSceneOnDemond, createTexture2D_NRRD, fullScreenListenner, kiwrious, loading, removeGuiFolderChilden, rgbaToCss, rgbaToHex, setHDRFilePath, throttle };