copper3d 3.0.1 → 3.1.0

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

@@ -6,15 +6,11 @@
  */
 import { BaseTool } from "./BaseTool";
 import type { ToolContext } from "./BaseTool";
-export interface ZoomCallbacks {
-    resetPaintAreaUIPosition: (l?: number, t?: number) => void;
-    resizePaintArea: (moveDistance: number) => void;
-    setIsDrawFalse: (target: number) => void;
-}
+import type { ZoomHostDeps } from "./ToolHost";
 export declare class ZoomTool extends BaseTool {
     private container;
     private mainAreaContainer;
     private callbacks;
-    constructor(ctx: ToolContext, container: HTMLElement, mainAreaContainer: HTMLDivElement, callbacks: ZoomCallbacks);
+    constructor(ctx: ToolContext, container: HTMLElement, mainAreaContainer: HTMLDivElement, callbacks: ZoomHostDeps);
     configMouseZoomWheel(): (e: WheelEvent) => void;
 }

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

@@ -8,15 +8,17 @@
  */
 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 { EraserTool } from "./EraserTool";
+export { DrawingTool } from "./DrawingTool";
+export { PanTool } from "./PanTool";
 export { ZoomTool } from "./ZoomTool";
-export type { ZoomCallbacks } from "./ZoomTool";
-export { SphereTool } from "./SphereTool";
-export type { SphereCallbacks } from "./SphereTool";
+export { SphereTool, SPHERE_CHANNEL_MAP } from "./SphereTool";
+export type { SphereType } from "./SphereTool";
 export { CrosshairTool } from "./CrosshairTool";
 export { ContrastTool } from "./ContrastTool";
-export type { ContrastCallbacks } from "./ContrastTool";
 export { ImageStoreHelper } from "./ImageStoreHelper";
-export type { ImageStoreCallbacks } from "./ImageStoreHelper";
 export { DragSliceTool } from "./DragSliceTool";
-export type { DragSliceCallbacks } from "./DragSliceTool";
+export { LayerChannelManager } from "./LayerChannelManager";
+export { SliceRenderPipeline } from "./SliceRenderPipeline";
+export { DataLoader } from "./DataLoader";

package/dist/types/Utils/workers/reformatSaveDataWorker.d.ts

@@ -1,4 +1,4 @@
-import { IPaintImage } from "../segmentation/coreTools/coreType";
+import { IPaintImage } from "../segmentation/core/types";
 declare function pruningData(originArr: IPaintImage[]): Uint8ClampedArray[];
 declare function restructData(originArr: IPaintImage[], len: number, width: number, height: number): {
     sliceIndex: number;

package/dist/types/index.d.ts

@@ -17,10 +17,13 @@ import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls"
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
 import { nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, exportPaintImageType, IOptVTKLoader } from "./types/types";
-import { IPaintImage, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates } from "./Utils/segmentation/coreTools/coreType";
+import { IPaintImage, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, IGuiMeta } from "./Utils/segmentation/core/types";
+import { NrrdState } from "./Utils/segmentation/coreTools/NrrdState";
+import { GuiState } from "./Utils/segmentation/coreTools/GuiState";
+import type { ToolMode, IAnnotationCallbacks } from "./Utils/segmentation/core/types";
 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.1-beta";
+export declare const REVISION = "v3.1.0-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, };
+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.0.1",
+  "version": "3.1.0",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",

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

@@ -1,177 +0,0 @@
-import { IProtected, IGUIStates, INrrdStates, ICursorPage, IConvertObjType, INewMaskData, IKeyBoardSettings } from "./coreTools/coreType";
-import { MaskVolume } from "./core/index";
-export declare class CommToolsData {
-    baseCanvasesSize: number;
-    private _reusableSliceBuffer;
-    private _reusableBufferWidth;
-    private _reusableBufferHeight;
-    /** Whether the keyboard-config dialog is open (suppresses all shortcuts). */
-    protected _configKeyBoard: boolean;
-    /** Active keyboard shortcut bindings. */
-    protected _keyboardSettings: IKeyBoardSettings;
-    nrrd_states: INrrdStates;
-    cursorPage: ICursorPage;
-    gui_states: IGUIStates;
-    protectedData: IProtected;
-    constructor(container: HTMLElement, mainAreaContainer: HTMLElement, options?: {
-        layers?: string[];
-    });
-    /**
-     * Get MaskVolume for a specific layer
-     *
-     * @param layer - Layer name: "layer1", "layer2", or "layer3"
-     * @returns MaskVolume instance for the specified layer
-     *
-     * @example
-     * ```ts
-     * const volume = this.getVolumeForLayer("layer1");
-     * volume.setVoxel(x, y, z, 255);
-     * ```
-     */
-    getVolumeForLayer(layer: string): MaskVolume;
-    /**
-     * Get MaskVolume for the currently active layer
-     *
-     * @returns MaskVolume instance for the current layer
-     *
-     * @example
-     * ```ts
-     * const volume = this.getCurrentVolume();
-     * const slice = volume.getSliceImageData(50, 'z');
-     * ```
-     */
-    getCurrentVolume(): MaskVolume;
-    /**
-     * Get all three MaskVolume instances
-     *
-     * @returns Object containing all three layer volumes
-     *
-     * @example
-     * ```ts
-     * const { layer1, layer2, layer3 } = this.getAllVolumes();
-     * layer1.clear();
-     * ```
-     */
-    getAllVolumes(): INewMaskData;
-    private generateSystemCanvases;
-    private generateLayerTargets;
-    /**
-     * Rewrite this {clearPaint} function under DrawToolCore
-     */
-    clearPaint(): void;
-    /**
-     * Rewrite this {undoLastPainting} function under DrawToolCore
-     */
-    undoLastPainting(): void;
-    /**
-     * Rewrite this {redoLastPainting} function under DrawToolCore
-     */
-    redoLastPainting(): void;
-    /**
-     * Rewrite this {clearStoreImages} function under NrrdTools
-     */
-    clearStoreImages(): void;
-    /**
-     * Rewrite this {resizePaintArea} function under NrrdTools
-     */
-    resizePaintArea(factor: number): void;
-    /**
-     * Rewrite this {setIsDrawFalse} function under NrrdTools
-     */
-    setIsDrawFalse(target: number): void;
-    /**
-     * Rewrite this {updateOriginAndChangedWH} function under NrrdTools
-     */
-    updateOriginAndChangedWH(): void;
-    /**
-     * Rewrite this {flipDisplayImageByAxis} function under NrrdTools
-     */
-    flipDisplayImageByAxis(): void;
-    /**
-     * Rewrite this {resetPaintAreaUIPosition} function under NrrdTools
-     */
-    resetPaintAreaUIPosition(l?: number, t?: number): void;
-    /**
-     * Rewrite this {resetPaintAreaUIPosition} function under NrrdTools
-     */
-    setEmptyCanvasSize(axis?: "x" | "y" | "z"): void;
-    /**
-     * Rewrite this {convertCursorPoint} function under NrrdTools
-     */
-    convertCursorPoint(from: "x" | "y" | "z", to: "x" | "y" | "z", cursorNumX: number, cursorNumY: number, currentSliceIndex: number): IConvertObjType | undefined;
-    /**
-     * Rewrite this {resetLayerCanvas} function under NrrdTools
-     */
-    resetLayerCanvas(): void;
-    /**
-     * Rewrite this {setSyncsliceNum} function under NrrdTools
-     */
-    setSyncsliceNum(): void;
-    /**
-     * Rewrite this {redrawDisplayCanvas} function under NrrdTools
-     */
-    redrawDisplayCanvas(): void;
-    /**
-     * Get a painted mask image based on current axis and input slice index.
-     *
-     * Phase 3: Reads directly from MaskVolume.
-     *
-     * @param axis "x" | "y" | "z"
-     * @param sliceIndex number
-     * @returns Object with index and image, or undefined
-     */
-    filterDrawedImage(axis: "x" | "y" | "z", sliceIndex: number): {
-        index: number;
-        image: ImageData;
-    } | undefined;
-    /**
-     * Get or create a reusable ImageData buffer for the given axis.
-     *
-     * Reuses the same buffer across multiple slice renders to avoid
-     * allocating a new ImageData per layer per slice switch.
-     * The buffer is only reallocated when slice dimensions change (axis switch).
-     *
-     * @param axis - Axis: "x", "y", or "z"
-     * @returns Reusable ImageData buffer with correct dimensions
-     */
-    getOrCreateSliceBuffer(axis: "x" | "y" | "z"): ImageData | null;
-    /**
-     * Render a layer's slice into a reusable buffer and draw to the target canvas.
-     *
-     * Uses MaskVolume.renderLabelSliceInto() for zero-allocation rendering.
-     * The caller should obtain the buffer via getOrCreateSliceBuffer() and reuse
-     * it across multiple layer renders.
-     *
-     * @param layer - Layer name: "layer1", "layer2", or "layer3"
-     * @param axis - Axis: "x", "y", or "z"
-     * @param sliceIndex - Slice index
-     * @param buffer - Reusable ImageData buffer (from getOrCreateSliceBuffer)
-     * @param targetCtx - Canvas context to draw the result onto
-     * @param scaledWidth - Target display width
-     * @param scaledHeight - Target display height
-     */
-    renderSliceToCanvas(layer: string, axis: "x" | "y" | "z", sliceIndex: number, buffer: ImageData, targetCtx: CanvasRenderingContext2D, scaledWidth: number, scaledHeight: number): void;
-    /**
-     * Invalidate the reusable buffer (e.g. when switching datasets).
-     * The buffer will be lazily recreated on next use.
-     */
-    invalidateSliceBuffer(): void;
-    /**
-     * Apply the same flip transform used by flipDisplayImageByAxis() to any
-     * canvas context.  This ensures mask overlays align with the flipped CT image.
-     *
-     * The flip is its own inverse (applying twice = identity), so it works for
-     * both directions: volume→display (rendering) and display→volume (storing).
-     *
-     * @param ctx    Target 2D context (must be wrapped in save/restore by caller).
-     * @param width  Canvas width in pixels.
-     * @param height Canvas height in pixels.
-     * @param axis   Current viewing axis.
-     */
-    applyMaskFlipForAxis(ctx: CanvasRenderingContext2D, width: number, height: number, axis: "x" | "y" | "z"): void;
-    /**
-     * Composite all layer canvases to the master display canvas.
-     * Only draws layers whose visibility is enabled.
-     */
-    compositeAllLayers(): void;
-}