copper3d 3.1.2 → 3.2.1

package/dist/index.d.ts

@@ -13,6 +13,7 @@ import { createTexture2D_NRRD } from "./Utils/texture2d";
 import { configKiwriousHeart } from "./Utils/kiwrious/configKiwrious";
 import kiwrious from "./Utils/kiwrious/configKiwrious";
 import { NrrdTools } from "./Utils/segmentation/NrrdTools";
+import { GaussianSmoother } from "./Utils/segmentation/core/GaussianSmoother";
 import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls";
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
@@ -24,6 +25,6 @@ import type { ToolMode, IAnnotationCallbacks } from "./Utils/segmentation/core/t
 import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export declare const REVISION = "v3.1.2-beta";
-export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, };
+export declare const REVISION = "v3.2.1-beta";
+export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, NrrdState, GuiState, IGuiMeta, ToolMode, IAnnotationCallbacks, LayerId, ChannelValue, };

package/dist/index.js

@@ -14,13 +14,13 @@ import { createTexture2D_NRRD } from "./Utils/texture2d";
 import { configKiwriousHeart } from "./Utils/kiwrious/configKiwrious";
 import kiwrious from "./Utils/kiwrious/configKiwrious";
 import { NrrdTools } from "./Utils/segmentation/NrrdTools";
-// Phase 7: Segmentation Module - Unified exports
+import { GaussianSmoother } from "./Utils/segmentation/core/GaussianSmoother";
 import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls";
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
 import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export const REVISION = "v3.1.2-beta";
+export const REVISION = "v3.2.1-beta";
 console.log(`%cCopper3D Visualisation %cBeta:${REVISION}`, "padding: 3px;color:white; background:#023047", "padding: 3px;color:white; background:#f50a25");
-export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, };
+export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,eAAe,EAGf,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAY,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,iDAAiD;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAiB5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG3G,OAAO,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC;AAEtC,OAAO,CAAC,GAAG,CACT,mCAAmC,QAAQ,EAAE,EAC7C,8CAA8C,EAC9C,8CAA8C,CAC/C,CAAC;AAEF,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,yBAAyB,EACzB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,GACV,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,eAAe,EAGf,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAY,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAE9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAiB5E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAG3G,OAAO,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG,aAAa,CAAC;AAEtC,OAAO,CAAC,GAAG,CACT,mCAAmC,QAAQ,EAAE,EAC7C,8CAA8C,EAC9C,8CAA8C,CAC/C,CAAC;AAEF,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,OAAO,EACP,yBAAyB,EACzB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,GACjB,CAAC"}

package/dist/types/Utils/segmentation/DragOperator.d.ts

@@ -18,9 +18,10 @@ export declare class DragOperator {
     private setEmptyCanvasSize;
     private getOrCreateSliceBuffer;
     private renderSliceToCanvas;
+    private compositeAllLayers;
     private refreshSphereOverlayCb;
     private eventRouter;
-    constructor(container: HTMLElement, nrrd_sates: NrrdState, gui_states: GuiState, protectedData: IProtected, drawingPrameters: IDrawingEvents, setSyncsliceNum: () => void, setIsDrawFalse: (target: number) => void, flipDisplayImageByAxis: () => void, setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void, getOrCreateSliceBuffer: (axis: "x" | "y" | "z") => ImageData | null, renderSliceToCanvas: (layer: string, axis: "x" | "y" | "z", sliceIndex: number, buffer: ImageData, targetCtx: CanvasRenderingContext2D, scaledWidth: number, scaledHeight: number) => void);
+    constructor(container: HTMLElement, nrrd_sates: NrrdState, gui_states: GuiState, protectedData: IProtected, drawingPrameters: IDrawingEvents, setSyncsliceNum: () => void, setIsDrawFalse: (target: number) => void, flipDisplayImageByAxis: () => void, setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void, getOrCreateSliceBuffer: (axis: "x" | "y" | "z") => ImageData | null, renderSliceToCanvas: (layer: string, axis: "x" | "y" | "z", sliceIndex: number, buffer: ImageData, targetCtx: CanvasRenderingContext2D, scaledWidth: number, scaledHeight: number) => void, compositeAllLayers: () => void);
     private init;
     setShowDragNumberDiv(sliceIndexContainer: HTMLDivElement): void;
     /**

package/dist/types/Utils/segmentation/DrawToolCore.d.ts

@@ -10,6 +10,7 @@ import { EraserTool } from "./tools/EraserTool";
 import { PanTool } from "./tools/PanTool";
 import { DrawingTool } from "./tools/DrawingTool";
 import { ImageStoreHelper } from "./tools/ImageStoreHelper";
+import { SphereBrushTool } from "./tools/SphereBrushTool";
 import { UndoManager } from "./core";
 /**
  * DrawToolCore — Tool orchestration and event routing.
@@ -41,6 +42,7 @@ export declare class DrawToolCore {
     protected panTool: PanTool;
     protected drawingTool: DrawingTool;
     protected imageStoreHelper: ImageStoreHelper;
+    protected sphereBrushTool: SphereBrushTool;
     /** Slice index recorded when paintOnCanvas() starts, guards stale-click */
     private paintSliceIndex;
     /** Wheel event dispatch mode — replaces manual wheel add/remove (Phase 2) */
@@ -131,4 +133,8 @@ export declare class DrawToolCore {
     enterSphereMode(): void;
     /** Override in NrrdTools */
     exitSphereMode(): void;
+    /** Override in NrrdTools */
+    reloadMasksFromVolume(): void;
+    /** Override in NrrdTools */
+    updateMouseWheelEvent(): void;
 }

package/dist/types/Utils/segmentation/NrrdTools.d.ts

@@ -79,6 +79,8 @@ export declare class NrrdTools {
     getOpacity(): number;
     setBrushSize(size: number): void;
     getBrushSize(): number;
+    setSphereBrushRadius(radius: number): void;
+    getSphereBrushRadius(): number;
     setWindowHigh(value: number): void;
     setWindowLow(value: number): void;
     finishWindowAdjustment(): void;
@@ -86,7 +88,9 @@ export declare class NrrdTools {
     getSliderMeta(key: string): IGuiMeta | null;
     setPencilColor(hex: string): void;
     getPencilColor(): string;
-    executeAction(action: "undo" | "redo" | "clearActiveSliceMask" | "clearActiveLayerMask" | "resetZoom" | "downloadCurrentMask"): void;
+    executeAction(action: "undo" | "redo" | "clearActiveSliceMask" | "clearActiveLayerMask" | "resetZoom" | "downloadCurrentMask" | "gaussianSmooth", opts?: {
+        sigma?: number;
+    }): void;
     undo(): void;
     redo(): void;
     enterKeyboardConfig(): void;

package/dist/types/Utils/segmentation/core/GaussianSmoother.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GaussianSmoother — 3D Gaussian smoothing for segmentation masks.
+ *
+ * Applies a separable 3D Gaussian blur to a single label channel within a
+ * MaskVolume, then thresholds the result back to a binary mask. This smooths
+ * jagged edges and fills small holes in segmentation annotations.
+ *
+ * Pure, stateless utility — no DOM/Canvas/GUI dependencies.
+ *
+ * Performance: uses direct typed-array access (bypassing getVoxel/setVoxel
+ * boundary checks) and branch-free convolution for the interior region.
+ */
+import type { MaskVolume } from './MaskVolume';
+export declare class GaussianSmoother {
+    /**
+     * Smooth a single label channel in-place using separable 3D Gaussian blur.
+     *
+     * Steps:
+     *  1. Extract — create a Float32Array with 1.0 where voxel === channel, 0.0 elsewhere.
+     *  2. Blur — apply separable Gaussian (X → Y → Z) on the float buffer.
+     *  3. Threshold — binarize at 0.5.
+     *  4. Write back — overwrite/erase voxels according to the thresholded result.
+     *
+     * @param volume  The MaskVolume to operate on (modified in-place).
+     * @param channel The label value to smooth (must be > 0).
+     * @param sigma   Base Gaussian sigma in voxel units (default 1.0).
+     * @param spacing Optional voxel spacing [sx, sy, sz]. When provided, per-axis
+     *                sigma is computed as `sigma / spacing[axis]` so that the
+     *                physical smoothing radius is isotropic.
+     */
+    static gaussianSmooth3D(volume: MaskVolume, channel: number, sigma?: number, spacing?: [number, number, number]): void;
+    /**
+     * Generate a normalized 1D Gaussian kernel truncated at ±3σ.
+     *
+     * @param sigma Standard deviation (in voxels). Must be > 0.
+     * @returns Normalized Float32Array of odd length.
+     */
+    static generateKernel1D(sigma: number): Float32Array;
+    /**
+     * In-place single-axis convolution with zero-padding at boundaries.
+     *
+     * Uses a 3-segment approach: left boundary (with bounds check),
+     * middle interior (branch-free, ~95% of work), right boundary
+     * (with bounds check). This eliminates per-element branching
+     * in the hot inner loop.
+     *
+     * @param data   Flat float buffer (width × height × depth).
+     * @param width  X dimension.
+     * @param height Y dimension.
+     * @param depth  Z dimension.
+     * @param axis   0 = X, 1 = Y, 2 = Z.
+     * @param kernel 1D convolution kernel (odd length).
+     */
+    private static convolve1D;
+}

package/dist/types/Utils/segmentation/core/MaskVolume.d.ts

@@ -250,6 +250,15 @@ export declare class MaskVolume {
      * @returns Channel count (≥ 1).
      */
     getChannels(): number;
+    /**
+     * Return the number of bytes in one complete z-slice.
+     *
+     * Equal to `width × height × channels`. Useful for direct buffer
+     * index arithmetic in performance-critical code paths.
+     *
+     * @returns Bytes per z-slice.
+     */
+    getBytesPerSlice(): number;
     /**
      * Return total memory used by the backing buffer, in bytes.
      *

package/dist/types/Utils/segmentation/core/UndoManager.d.ts

@@ -19,6 +19,8 @@ export interface MaskDelta {
     /** Full slice data captured after the drawing operation. */
     newSlice: Uint8Array;
 }
+/** A single delta or a group of deltas treated as one undo unit. */
+export type UndoEntry = MaskDelta[];
 export declare class UndoManager {
     private undoStacks;
     private redoStacks;
@@ -26,18 +28,20 @@ export declare class UndoManager {
     constructor();
     /** Set the currently active layer (determines which stack undo/redo operates on). */
     setActiveLayer(layer: string): void;
-    /** Push a delta onto the active layer's undo stack and clear the redo stack. */
+    /** Push a single delta onto the active layer's undo stack and clear the redo stack. */
     push(delta: MaskDelta): void;
+    /** Push a group of deltas as a single undo unit (e.g. 3D sphere spanning multiple slices). */
+    pushGroup(deltas: MaskDelta[]): void;
     /**
      * Undo the last operation on the active layer.
-     * @returns The delta that was undone, or undefined if nothing to undo.
+     * @returns The delta(s) that were undone, or undefined if nothing to undo.
      */
-    undo(): MaskDelta | undefined;
+    undo(): UndoEntry | undefined;
     /**
      * Redo the last undone operation on the active layer.
-     * @returns The delta that was redone, or undefined if nothing to redo.
+     * @returns The delta(s) that were redone, or undefined if nothing to redo.
      */
-    redo(): MaskDelta | undefined;
+    redo(): UndoEntry | undefined;
     canUndo(): boolean;
     canRedo(): boolean;
     /** Clear undo and redo stacks for a specific layer (called on clearActiveLayer). */

package/dist/types/Utils/segmentation/core/index.d.ts

@@ -70,5 +70,5 @@
 export type { Dimensions, RGBAColor, ChannelColorMap, SliceRenderOptions, LayerId, ChannelValue, ICommXYZ, ICommXY, ISkipSlicesDictType, ToolMode, IDragPrameters, IDrawingEvents, IContrastEvents, IPaintImages, IPaintImage, ILayerRenderTarget, IDownloadImageConfig, INewMaskData, IMaskData, IProtected, IToolModeState, IDrawingConfig, IViewConfig, ILayerChannelState, IGUIStates, IGuiMeta, IGuiParameterSettings, IImageMetadata, IViewState, IInteractionState, ISphereState, IInternalFlags, INrrdStates, IAnnotationCallbacks, IConvertObjType, ICursorPage, IDragOpts, IDrawOpts, IKeyBoardSettings, } from './types';
 export { RenderMode, MASK_CHANNEL_COLORS, MASK_CHANNEL_CSS_COLORS, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, } from './types';
 export { MaskVolume } from './MaskVolume';
-export type { MaskDelta } from './UndoManager';
+export type { MaskDelta, UndoEntry } from './UndoManager';
 export { UndoManager } from './UndoManager';

package/dist/types/Utils/segmentation/core/types.d.ts

@@ -118,7 +118,7 @@ export interface ISkipSlicesDictType {
     [key: string]: any;
 }
 /** Tool mode types for segmentation tools */
-export type ToolMode = "pencil" | "brush" | "eraser" | "sphere" | "calculator";
+export type ToolMode = "pencil" | "brush" | "eraser" | "sphere" | "calculator" | "sphereBrush" | "sphereEraser";
 export interface IDragPrameters {
     move: number;
     y: number;
@@ -137,6 +137,7 @@ export interface IDrawingEvents {
     handleOnDrawingBrushCricleMove: (ev: MouseEvent) => void;
     handleMouseZoomSliceWheel: (e: WheelEvent) => void;
     handleSphereWheel: (e: WheelEvent) => void;
+    handleSphereBrushWheel: (e: WheelEvent) => void;
 }
 export interface IContrastEvents {
     move_x: number;
@@ -223,6 +224,8 @@ export interface IToolModeState {
     pencil: boolean;
     eraser: boolean;
     sphere: boolean;
+    sphereBrush: boolean;
+    sphereEraser: boolean;
     activeSphereType: "tumour" | "skin" | "nipple" | "ribcage";
 }
 /** Drawing configuration — brush/pencil appearance and behavior */
@@ -422,6 +425,7 @@ export interface ISphereState {
     /** Dedicated MaskVolume for SphereTool 3D sphere data. Type is `any` to avoid circular deps. */
     sphereMaskVolume: any;
     sphereRadius: number;
+    sphereBrushRadius: number;
 }
 /** Internal flags — transient operational flags */
 export interface IInternalFlags {

package/dist/types/Utils/segmentation/eventRouter/types.d.ts

@@ -18,7 +18,7 @@ export type InteractionMode = 'idle' | 'draw' | 'drag' | 'contrast' | 'crosshair
 /**
  * GUI tool selection (set from UI buttons)
  */
-export type GuiTool = 'pencil' | 'brush' | 'eraser' | 'sphere';
+export type GuiTool = 'pencil' | 'brush' | 'eraser' | 'sphere' | 'sphereBrush' | 'sphereEraser';
 /**
  * Keyboard event handler type
  */

package/dist/types/Utils/segmentation/tools/DragSliceTool.d.ts

@@ -26,10 +26,6 @@ export declare class DragSliceTool extends BaseTool {
     setShowDragNumberDiv(div: HTMLDivElement): void;
     updateIndex(move: number): void;
     private drawDragSlice;
-    /**
-     * Composite all visible layer canvases to the master display canvas.
-     */
-    private compositeAllLayers;
     private cleanCanvases;
     updateShowNumDiv(contrastNum: number): void;
     updateCurrentContrastSlice(): any;

package/dist/types/Utils/segmentation/tools/SphereBrushTool.d.ts

@@ -0,0 +1,127 @@
+/**
+ * SphereBrushTool — 3D sphere brush and eraser on layer MaskVolume.
+ *
+ * Unlike SphereTool (which uses its own isolated sphereMaskVolume),
+ * this tool writes/erases directly in the active layer's shared MaskVolume —
+ * the same volume used by pencil/brush/eraser tools.
+ *
+ * Two operation modes handled by one class:
+ * - **sphereBrush**: Direct click to paint a 3D sphere of the active channel label.
+ * - **sphereEraser**: Shift+click to erase a 3D sphere (only voxels matching active channel).
+ *
+ * Interaction:
+ * 1. Pointer-down records sphere center, switches wheel to radius mode.
+ * 2. Scroll wheel adjusts sphereBrushRadius [1, 50].
+ * 3. Pointer-up writes/erases sphere to volume, captures grouped undo, refreshes canvas.
+ */
+import { BaseTool } from "./BaseTool";
+import type { ToolContext } from "./BaseTool";
+import type { SphereBrushHostDeps } from "./ToolHost";
+export declare class SphereBrushTool extends BaseTool {
+    private callbacks;
+    /** Recorded sphere center in canvas mm-space */
+    private centerX;
+    private centerY;
+    private centerSlice;
+    /** Whether a sphere placement is in progress */
+    private active;
+    /** Current operation mode for the active placement */
+    private mode;
+    /** Cumulative "before" snapshots for drag-erase undo (z-index → slice data) */
+    private dragBeforeSnapshots;
+    /** Whether a drag-erase has actually moved (vs. simple click-release) */
+    private dragMoved;
+    constructor(ctx: ToolContext, callbacks: SphereBrushHostDeps);
+    setCallbacks(callbacks: SphereBrushHostDeps): void;
+    /**
+     * Convert canvas mm-space coordinates to 3D voxel coordinates.
+     */
+    private canvasToVoxelCenter;
+    /**
+     * Convert mm radius to per-axis voxel radii.
+     */
+    private getVoxelRadii;
+    /**
+     * Compute clamped bounding box for an ellipsoid in voxel space.
+     */
+    private getBoundingBox;
+    /**
+     * Write a 3D sphere of the active channel label into the layer's MaskVolume.
+     */
+    private write3DSphereToBrush;
+    /**
+     * Erase a 3D sphere from the layer's MaskVolume.
+     * Only clears voxels whose current value equals the active channel label.
+     */
+    private erase3DSphereFromVolume;
+    /**
+     * Capture slice snapshots for all Z-slices in the bounding box.
+     * Used before and after the sphere operation to build MaskDelta groups.
+     *
+     * We always capture along the Z axis since the 3D sphere spans Z slices.
+     */
+    private captureSliceSnapshots;
+    /**
+     * Build MaskDelta group from before/after snapshots.
+     */
+    private buildUndoGroup;
+    /**
+     * Draw a preview circle on the sphere canvas during sphere placement.
+     */
+    drawPreview(mouseX: number, mouseY: number, radius: number, isEraser: boolean): void;
+    /**
+     * Clear the sphere preview canvas.
+     */
+    clearPreview(): void;
+    /**
+     * Get the hex color for the active channel from the layer's MaskVolume.
+     */
+    private getActiveChannelColor;
+    /**
+     * Returns a wheel event handler for adjusting sphereBrushRadius.
+     * Used in both sphereBrush and sphereEraser modes.
+     */
+    configSphereBrushWheel(): (e: WheelEvent) => void;
+    /**
+     * Handle pointer-down in sphereBrush mode (direct click, no Shift needed).
+     */
+    onSphereBrushClick(e: MouseEvent): void;
+    /**
+     * Handle pointer-up in sphereBrush mode — write sphere to volume.
+     */
+    onSphereBrushPointerUp(): void;
+    /**
+     * Handle pointer-down in sphereEraser mode.
+     * Initializes drag tracking for cumulative undo.
+     */
+    onSphereEraserClick(e: MouseEvent): void;
+    /**
+     * Handle pointer-move in sphereEraser mode — drag to continuously erase.
+     */
+    onSphereEraserMove(e: MouseEvent): void;
+    /**
+     * Handle pointer-up in sphereEraser mode — finalize erase + push undo group.
+     * Works for both click-release and drag-release.
+     */
+    onSphereEraserPointerUp(): void;
+    /**
+     * Expand cumulative "before" snapshots to cover z range [minZ, maxZ].
+     * Only captures slices not yet in the map (preserves original state).
+     */
+    private expandDragBeforeSnapshots;
+    /** Get minimum Z index from drag snapshots */
+    private dragMinZ;
+    /** Get maximum Z index from drag snapshots */
+    private dragMaxZ;
+    /**
+     * After writing/erasing the sphere in the volume, re-render the current
+     * slice's layer canvas and composite all layers to master.
+     *
+     * @param changedDeltas - If provided, fire onMaskChanged for ALL changed
+     *   slices (not just the current view slice) so the backend receives the
+     *   full 3D sphere data for NII/GLTF export.
+     */
+    private refreshDisplay;
+    /** Whether a sphere placement is currently in progress */
+    get isActive(): boolean;
+}

package/dist/types/Utils/segmentation/tools/ToolHost.d.ts

@@ -40,6 +40,7 @@ export interface ToolHost {
         image: ImageData;
     } | undefined;
     pushUndoDelta(delta: MaskDelta): void;
+    pushUndoGroup(deltas: MaskDelta[]): void;
     getEraserUrls(): string[];
     enableCrosshair(): void;
     setUpSphereOrigins(mouseX: number, mouseY: number, sliceIndex: number): void;
@@ -65,10 +66,12 @@ export type SphereHostDeps = Pick<ToolHost, 'setEmptyCanvasSize' | 'drawImageOnE
 /** DrawingTool host dependencies */
 export type DrawingHostDeps = Pick<ToolHost, 'setCurrentLayer' | 'compositeAllLayers' | 'syncLayerSliceData' | 'filterDrawedImage' | 'getVolumeForLayer' | 'pushUndoDelta' | 'getEraserUrls'>;
 /** DragSliceTool host dependencies */
-export type DragSliceHostDeps = Pick<ToolHost, 'setSyncsliceNum' | 'setIsDrawFalse' | 'flipDisplayImageByAxis' | 'setEmptyCanvasSize' | 'getOrCreateSliceBuffer' | 'renderSliceToCanvas' | 'refreshSphereOverlay'>;
+export type DragSliceHostDeps = Pick<ToolHost, 'setSyncsliceNum' | 'setIsDrawFalse' | 'flipDisplayImageByAxis' | 'setEmptyCanvasSize' | 'getOrCreateSliceBuffer' | 'renderSliceToCanvas' | 'refreshSphereOverlay' | 'compositeAllLayers'>;
 /** LayerChannelManager host dependencies */
 export type LayerChannelHostDeps = Pick<ToolHost, 'reloadMasksFromVolume' | 'getVolumeForLayer' | 'onChannelColorChanged'>;
 /** SliceRenderPipeline host dependencies */
 export type SliceRenderHostDeps = Pick<ToolHost, 'compositeAllLayers' | 'getOrCreateSliceBuffer' | 'renderSliceToCanvas' | 'getVolumeForLayer' | 'refreshSphereOverlay' | 'syncGuiParameterSettings' | 'repraintCurrentContrastSlice' | 'clearUndoHistory' | 'updateShowNumDiv' | 'updateCurrentContrastSlice'>;
 /** DataLoader host dependencies */
 export type DataLoaderHostDeps = Pick<ToolHost, 'invalidateSliceBuffer' | 'setDisplaySlicesBaseOnAxis' | 'afterLoadSlice' | 'setEmptyCanvasSize' | 'syncLayerSliceData' | 'reloadMasksFromVolume' | 'resetZoom'>;
+/** SphereBrushTool host dependencies */
+export type SphereBrushHostDeps = Pick<ToolHost, 'getVolumeForLayer' | 'compositeAllLayers' | 'pushUndoGroup' | 'renderSliceToCanvas' | 'getOrCreateSliceBuffer' | 'setEmptyCanvasSize' | 'reloadMasksFromVolume' | 'getEraserUrls'>;

package/dist/types/Utils/segmentation/tools/index.d.ts

@@ -8,13 +8,14 @@
  */
 export { BaseTool } from "./BaseTool";
 export type { ToolContext } from "./BaseTool";
-export type { ToolHost, ImageStoreHostDeps, PanHostDeps, ContrastHostDeps, ZoomHostDeps, SphereHostDeps, DrawingHostDeps, DragSliceHostDeps, LayerChannelHostDeps, SliceRenderHostDeps, DataLoaderHostDeps, } from "./ToolHost";
+export type { ToolHost, ImageStoreHostDeps, PanHostDeps, ContrastHostDeps, ZoomHostDeps, SphereHostDeps, SphereBrushHostDeps, DrawingHostDeps, DragSliceHostDeps, LayerChannelHostDeps, SliceRenderHostDeps, DataLoaderHostDeps, } from "./ToolHost";
 export { EraserTool } from "./EraserTool";
 export { DrawingTool } from "./DrawingTool";
 export { PanTool } from "./PanTool";
 export { ZoomTool } from "./ZoomTool";
 export { SphereTool, SPHERE_CHANNEL_MAP } from "./SphereTool";
 export type { SphereType } from "./SphereTool";
+export { SphereBrushTool } from "./SphereBrushTool";
 export { CrosshairTool } from "./CrosshairTool";
 export { ContrastTool } from "./ContrastTool";
 export { ImageStoreHelper } from "./ImageStoreHelper";

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ import { createTexture2D_NRRD } from "./Utils/texture2d";
 import { configKiwriousHeart } from "./Utils/kiwrious/configKiwrious";
 import kiwrious from "./Utils/kiwrious/configKiwrious";
 import { NrrdTools } from "./Utils/segmentation/NrrdTools";
+import { GaussianSmoother } from "./Utils/segmentation/core/GaussianSmoother";
 import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls";
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
@@ -24,6 +25,6 @@ import type { ToolMode, IAnnotationCallbacks } from "./Utils/segmentation/core/t
 import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export declare const REVISION = "v3.1.2-beta";
-export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, };
+export declare const REVISION = "v3.2.1-beta";
+export { copperRenderer, copperRendererOnDemond, copperMSceneRenderer, setHDRFilePath, addLabelToScene, convert3DPostoScreenPos, convertScreenPosto3DPos, addBoxHelper, fullScreenListenner, configKiwriousHeart, copperScene, copperSceneOnDemond, copperMScene, CameraViewPoint, kiwrious, NrrdTools, loading, Copper3dTrackballControls, createTexture2D_NRRD, MeshNodeTool, throttle, removeGuiFolderChilden, CHANNEL_COLORS, CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, NrrdState, GuiState, IGuiMeta, ToolMode, IAnnotationCallbacks, LayerId, ChannelValue, };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "copper3d",
   "description": "A 3d visualisation package base on threejs provides multiple scenes and Nrrd image load funtion.",
-  "version": "3.1.2",
+  "version": "3.2.1",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",