copper3d 3.0.0 → 3.0.1

package/dist/index.d.ts

@@ -21,6 +21,6 @@ import { IPaintImage, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates }
 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.0.0-beta";
+export declare const REVISION = "v3.0.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, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, LayerId, ChannelValue, };

package/dist/index.js

@@ -20,7 +20,7 @@ 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.0.0-beta";
+export const REVISION = "v3.0.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, };
 //# sourceMappingURL=index.js.map

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

@@ -1,4 +1,4 @@
-import { IProtected, IGUIStates, INrrdStates, ICursorPage, IPaintImage, IPaintImages, IConvertObjType, INewMaskData, IKeyBoardSettings } from "./coreTools/coreType";
+import { IProtected, IGUIStates, INrrdStates, ICursorPage, IConvertObjType, INewMaskData, IKeyBoardSettings } from "./coreTools/coreType";
 import { MaskVolume } from "./core/index";
 export declare class CommToolsData {
     baseCanvasesSize: number;
@@ -71,10 +71,6 @@ export declare class CommToolsData {
      * Rewrite this {clearStoreImages} function under NrrdTools
      */
     clearStoreImages(): void;
-    /**
-     * Rewrite this {createEmptyPaintImage} function under NrrdTools
-     */
-    createEmptyPaintImage(dimensions: Array<number>, paintImages: IPaintImages): void;
     /**
      * Rewrite this {resizePaintArea} function under NrrdTools
      */
@@ -116,15 +112,18 @@ export declare class CommToolsData {
      */
     redrawDisplayCanvas(): void;
     /**
-     * Get a painted mask image (IPaintImage) based on current axis and input slice index.
+     * Get a painted mask image based on current axis and input slice index.
      *
-     * Phase 3: Reads directly from MaskVolume (no caching needed — reads are fast).
+     * Phase 3: Reads directly from MaskVolume.
      *
      * @param axis "x" | "y" | "z"
      * @param sliceIndex number
-     * @returns IPaintImage with the mask for the given slice, or undefined if not found
+     * @returns Object with index and image, or undefined
      */
-    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number): IPaintImage | undefined;
+    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number): {
+        index: number;
+        image: ImageData;
+    } | undefined;
     /**
      * Get or create a reusable ImageData buffer for the given axis.
      *
@@ -139,7 +138,7 @@ export declare class CommToolsData {
     /**
      * Render a layer's slice into a reusable buffer and draw to the target canvas.
      *
-     * Uses MaskVolume.getSliceRawImageDataInto() for zero-allocation rendering.
+     * Uses MaskVolume.renderLabelSliceInto() for zero-allocation rendering.
      * The caller should obtain the buffer via getOrCreateSliceBuffer() and reuse
      * it across multiple layer renders.
      *

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

@@ -1,4 +1,4 @@
-import { IConvertObjType, IDrawingEvents, IContrastEvents, IDrawOpts, IPaintImages } from "./coreTools/coreType";
+import { IConvertObjType, IDrawingEvents, IContrastEvents, IDrawOpts } from "./coreTools/coreType";
 import { CommToolsData } from "./CommToolsData";
 import { EventRouter } from "./eventRouter";
 import { SphereTool } from "./tools/SphereTool";
@@ -70,9 +70,9 @@ export declare class DrawToolCore extends CommToolsData {
     /**
      * Clear mask on current slice canvas.
      *
-     * Phase 2: Clears the MaskVolume slice for all three layers,
-     * re-stores, and notifies external via getMask callback with clearFlag=true.
-     * Phase 6: Also records a MaskDelta for undo support.
+     * Only clears the active layer's MaskVolume slice data.
+     * Other layers are left untouched. After clearing, all layer canvases
+     * are re-rendered from MaskVolume to keep visuals in sync.
      */
     clearPaint(): void;
     /**
@@ -93,9 +93,8 @@ export declare class DrawToolCore extends CommToolsData {
      */
     private applyUndoRedoToCanvas;
     /****************************Store images (delegated to ImageStoreHelper)****************************************************/
-    storeImageToAxis(index: number, paintedImages: IPaintImages, imageData: ImageData, axis?: "x" | "y" | "z"): void;
     storeAllImages(index: number, layer: string): void;
-    storeImageToLayer(index: number, canvas: HTMLCanvasElement, paintedImages: IPaintImages): ImageData;
+    storeImageToLayer(index: number, canvas: HTMLCanvasElement): ImageData;
     storeEachLayerImage(index: number, layer: string): void;
     /******************************** Utils gui related functions (delegated to ContrastTool) ***************************************/
     setupConrastEvents(callback: (step: number, towards: "horizental" | "vertical") => void): void;

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

@@ -197,39 +197,6 @@ export declare class MaskVolume {
      * ```
      */
     setSliceFromImageData(sliceIndex: number, imageData: ImageData, axis?: 'x' | 'y' | 'z', channel?: number): void;
-    /**
-     * Extract a 2D slice as raw RGBA ImageData (lossless round-trip).
-     *
-     * Requires the volume to have **≥ 4 channels** (ch0=R, ch1=G, ch2=B, ch3=A).
-     * Returns the exact pixel data that was stored via `setSliceFromImageData`,
-     * bypassing all render modes.
-     *
-     * @param sliceIndex Index along the specified axis.
-     * @param axis       `'x'`, `'y'`, or `'z'` (default `'z'`).
-     * @returns ImageData with the stored RGBA values.
-     *
-     * @throws {RangeError} If sliceIndex is out of bounds.
-     * @throws {Error}      If the volume has fewer than 4 channels.
-     */
-    getSliceRawImageData(sliceIndex: number, axis?: 'x' | 'y' | 'z'): ImageData;
-    /**
-     * Write slice data into an existing ImageData buffer (zero-allocation).
-     *
-     * Same semantics as {@link getSliceRawImageData} but avoids creating a new
-     * ImageData object on every call.  The caller is responsible for providing
-     * a buffer whose dimensions match the expected slice size.
-     *
-     * All pixels are fully overwritten — no clearing is needed beforehand.
-     *
-     * @param sliceIndex Index along the specified axis.
-     * @param axis       `'x'`, `'y'`, or `'z'` (default `'z'`).
-     * @param target     Pre-allocated ImageData to write into.
-     *
-     * @throws {Error}      If the volume has fewer than 4 channels.
-     * @throws {RangeError} If sliceIndex is out of bounds.
-     * @throws {Error}      If target dimensions don't match the slice.
-     */
-    getSliceRawImageDataInto(sliceIndex: number, axis: "z" | "y" | "x" | undefined, target: ImageData): void;
     /**
     /**
      * Store label data from canvas RGBA ImageData into a 1-channel volume.

package/dist/types/Utils/segmentation/coreTools/coreType.d.ts

@@ -99,8 +99,6 @@ interface IProtected {
     skipSlicesDic: ISkipSlicesDictType;
     currentShowingSlice: any;
     mainPreSlices: any;
-    Is_Shift_Pressed: boolean;
-    Is_Ctrl_Pressed: boolean;
     Is_Draw: boolean;
     axis: "x" | "y" | "z";
     maskData: IMaskData;
@@ -186,7 +184,6 @@ interface INrrdStates {
     ratios: ICommXYZ;
     contrastNum: number;
     showContrast: boolean;
-    enableCursorChoose: boolean;
     isCursorSelect: boolean;
     cursorPageX: number;
     cursorPageY: number;

package/dist/types/Utils/segmentation/coreTools/gui.d.ts

@@ -1,5 +1,5 @@
 import { GUI } from "dat.gui";
-import { IDrawingEvents, IGUIStates, IProtected, INrrdStates, IPaintImages, IPaintImage, IGuiParameterSettings } from "./coreType";
+import { IDrawingEvents, IGUIStates, IProtected, INrrdStates, IGuiParameterSettings } from "./coreType";
 import { DragOperator } from "../DragOperator";
 interface IConfigGUI {
     modeFolder: GUI;
@@ -26,12 +26,15 @@ interface IConfigGUI {
     resetLayerCanvas: () => void;
     redrawDisplayCanvas: () => void;
     flipDisplayImageByAxis: () => void;
-    filterDrawedImage: (axis: "x" | "y" | "z", sliceIndex: number) => IPaintImage | undefined;
+    filterDrawedImage: (axis: "x" | "y" | "z", sliceIndex: number) => {
+        index: number;
+        image: ImageData;
+    } | undefined;
     setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void;
     storeAllImages: (index: number, layer: string) => void;
     drawImageOnEmptyImage: (canvas: HTMLCanvasElement) => void;
     storeEachLayerImage: (index: number, layer: string) => void;
-    storeImageToLayer: (index: number, canvas: HTMLCanvasElement, paintedImages: IPaintImages) => ImageData;
+    storeImageToLayer: (index: number, canvas: HTMLCanvasElement) => ImageData;
     getRestLayer: () => string[];
     setIsDrawFalse: (target: number) => void;
 }

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

@@ -72,6 +72,7 @@ export declare class EventRouter {
     setGuiTool(tool: GuiTool): void;
     /**
      * Toggle crosshair mode.
+     * Blocked when draw or contrast mode is active (mutual exclusion).
      */
     toggleCrosshair(): void;
     /**

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

@@ -8,6 +8,7 @@
  * The new SegmentationManager system has its own tools in manager/tools/.
  */
 import type { INrrdStates, IGUIStates, IProtected, ICursorPage } from "../coreTools/coreType";
+import type { EventRouter } from "../eventRouter/EventRouter";
 /**
  * Shared context injected into every legacy tool.
  * References are shared (not copied), so tools see the same state.
@@ -17,6 +18,8 @@ export interface ToolContext {
     gui_states: IGUIStates;
     protectedData: IProtected;
     cursorPage: ICursorPage;
+    /** EventRouter reference for mode/state queries. Set after initDrawToolCore(). */
+    eventRouter?: EventRouter;
 }
 export declare abstract class BaseTool {
     protected ctx: ToolContext;

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

@@ -4,12 +4,10 @@
  * Extracted from DrawToolCore.ts:
  * - storeAllImages / storeImageToAxis / storeImageToLayer / storeEachLayerImage
  *
- * Phase 2 Day 7: Updated to write/read MaskVolume alongside legacy IPaintImages.
- * Volume is the primary storage; IPaintImages kept for backward compatibility.
+ * Phase 3: MaskVolume is the sole storage backend. All IPaintImages params removed.
  */
 import { BaseTool } from "./BaseTool";
 import type { ToolContext } from "./BaseTool";
-import type { IPaintImage, IPaintImages } from "../coreTools/coreType";
 export interface ImageStoreCallbacks {
     setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void;
     drawImageOnEmptyImage: (canvas: HTMLCanvasElement) => void;
@@ -34,17 +32,18 @@ export declare class ImageStoreHelper extends BaseTool {
      */
     private getCanvasForLayer;
     /**
-     * Phase 3: Simplified to be a no-op.
-     * MaskVolume storage happens in storeAllImages via setSliceFromImageData.
-     * This method kept for backward compatibility with existing call sites.
+     * Phase 3: No-op — MaskVolume storage happens in storeAllImages.
      */
-    storeImageToAxis(_index: number, _paintedImages: IPaintImages, _imageData: ImageData, _axis?: "x" | "y" | "z"): void;
+    storeImageToAxis(_index: number, _imageData: ImageData, _axis?: "x" | "y" | "z"): void;
     /**
      * Retrieve the drawn image for a given axis and slice.
      *
-     * Phase 3: Reads exclusively from MaskVolume (no legacy fallback).
+     * Phase 3: Reads exclusively from MaskVolume.
      */
-    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number, _paintedImages: IPaintImages): IPaintImage | undefined;
+    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number): {
+        index: number;
+        image: ImageData;
+    } | undefined;
     /**
      * Store all layer images for the current slice (cross-axis sync).
      *
@@ -57,9 +56,7 @@ export declare class ImageStoreHelper extends BaseTool {
      */
     storeEachLayerImage(index: number, layer: string): void;
     /**
-     * Phase 3: Simplified - extracts ImageData from canvas but no longer stores to paintImages.
-     * Kept for backward compatibility with existing call sites.
+     * Extract ImageData from canvas (MaskVolume storage is handled in storeAllImages).
      */
-    storeImageToLayer(_index: number, canvas: HTMLCanvasElement, _paintedImages: IPaintImages): ImageData;
-    private hasNonZeroPixels;
+    storeImageToLayer(_index: number, canvas: HTMLCanvasElement): ImageData;
 }

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

@@ -10,15 +10,13 @@
  */
 import { BaseTool } from "./BaseTool";
 import type { ToolContext } from "./BaseTool";
-import type { IPaintImages } from "../coreTools/coreType";
 /**
  * Callbacks that DrawToolCore must provide for sphere operations.
  */
 export interface SphereCallbacks {
     setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void;
     drawImageOnEmptyImage: (canvas: HTMLCanvasElement) => void;
-    storeImageToAxis: (index: number, paintedImages: IPaintImages, imageData: ImageData, axis?: "x" | "y" | "z") => void;
-    createEmptyPaintImage: (dimensions: number[], paintImages: IPaintImages) => void;
+    storeImageToAxis: (index: number, imageData: ImageData, axis?: "x" | "y" | "z") => void;
 }
 export declare class SphereTool extends BaseTool {
     private callbacks;

package/dist/types/index.d.ts

@@ -21,6 +21,6 @@ import { IPaintImage, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates }
 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.0.0-beta";
+export declare const REVISION = "v3.0.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, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, 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.0.0",
+  "version": "3.0.1",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",