copper3d 3.0.2 → 3.1.0

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

@@ -1,389 +0,0 @@
-/** Tool mode types for segmentation tools */
-type ToolMode = "pencil" | "brush" | "eraser" | "sphere" | "calculator";
-/** Metadata for a GUI slider/control — used by Vue components to configure slider UI */
-interface IGuiMeta {
-    min: number;
-    max: number;
-    step: number;
-    value: number;
-}
-/** Callbacks for external notification of annotation data changes */
-interface IAnnotationCallbacks {
-    onMaskChanged(sliceData: Uint8Array, layerId: string, channelId: number, sliceIndex: number, axis: "x" | "y" | "z", width: number, height: number, clearFlag: boolean): void;
-    onSphereChanged(sphereOrigin: number[], sphereRadius: number): void;
-    onCalculatorPositionsChanged(tumour: ICommXYZ | null, skin: ICommXYZ | null, rib: ICommXYZ | null, nipple: ICommXYZ | null, axis: "x" | "y" | "z"): void;
-    onLayerVolumeCleared(layerId: string): void;
-    onChannelColorChanged(layerId: string, channel: number, color: {
-        r: number;
-        g: number;
-        b: number;
-        a: number;
-    }): void;
-}
-interface ICommXYZ {
-    x: any;
-    y: any;
-    z: any;
-}
-interface ICommXY {
-    x: any;
-    y: any;
-}
-interface ISkipSlicesDictType {
-    [key: string]: any;
-}
-interface IDownloadImageConfig {
-    axis: "x" | "y" | "z";
-    currentSliceIndex: number;
-    drawingCanvas: HTMLCanvasElement;
-    originWidth: number;
-    originHeight: number;
-}
-interface IConvertObjType {
-    currentNewSliceIndex: number;
-    preSliceIndex: number;
-    convertCursorNumX: number;
-    convertCursorNumY: number;
-}
-interface IDragPrameters {
-    move: number;
-    y: number;
-    h: number;
-    sensivity: number;
-    handleOnDragMouseUp: (ev: MouseEvent) => void;
-    handleOnDragMouseDown: (ev: MouseEvent) => void;
-    handleOnDragMouseMove: (ev: MouseEvent) => void;
-}
-interface IDrawingEvents {
-    handleOnDrawingMouseDown: (ev: MouseEvent) => void;
-    handleOnDrawingMouseMove: (ev: MouseEvent) => void;
-    handleOnPanMouseMove: (ev: MouseEvent) => void;
-    handleOnDrawingMouseUp: (ev: MouseEvent) => void;
-    handleOnDrawingMouseLeave: (ev: MouseEvent) => void;
-    handleOnDrawingBrushCricleMove: (ev: MouseEvent) => void;
-    handleMouseZoomSliceWheel: (e: WheelEvent) => void;
-    handleSphereWheel: (e: WheelEvent) => void;
-}
-interface IContrastEvents {
-    move_x: number;
-    move_y: number;
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    handleOnContrastMouseDown: (ev: MouseEvent) => void;
-    handleOnContrastMouseMove: (ev: MouseEvent) => void;
-    handleOnContrastMouseUp: (ev: MouseEvent) => void;
-    handleOnContrastMouseLeave: (ev: MouseEvent) => void;
-}
-interface IPaintImages {
-    x: Array<IPaintImage>;
-    y: Array<IPaintImage>;
-    z: Array<IPaintImage>;
-}
-interface IPaintImage {
-    index: number;
-    image: ImageData;
-}
-/**
- * Import MaskVolume from core module
- * (imported where needed, not here to avoid circular deps)
- */
-type MaskVolume = any;
-/**
- * New mask data structure using MaskVolume for true 3D storage.
- * Dynamic N-layer support: keyed by layer id (e.g. 'layer1', 'layer2', ...).
- */
-type INewMaskData = Record<string, MaskVolume>;
-/**
- * A paired canvas + 2D context for a single annotation layer.
- * Stored atomically in IProtected.layerTargets to prevent canvas/ctx desync.
- */
-interface ILayerRenderTarget {
-    canvas: HTMLCanvasElement;
-    ctx: CanvasRenderingContext2D;
-}
-/**
- * Mask data storage using volumetric MaskVolume (Phase 3)
- *
- * Phase 2 legacy ImageData storage has been removed.
- * All mask data now stored in 3D volumes for memory efficiency.
- */
-type IMaskData = {
-    volumes: INewMaskData;
-};
-interface IProtected {
-    container: HTMLElement;
-    mainAreaContainer: HTMLElement;
-    allSlicesArray: Array<ICommXYZ>;
-    displaySlices: Array<any>;
-    backUpDisplaySlices: Array<any>;
-    skipSlicesDic: ISkipSlicesDictType;
-    currentShowingSlice: any;
-    mainPreSlices: any;
-    isDrawing: boolean;
-    axis: "x" | "y" | "z";
-    maskData: IMaskData;
-    /** Dynamic per-layer canvas+ctx pairs. Replaces hardcoded LayerOne/Two/Three fields. */
-    layerTargets: Map<string, ILayerRenderTarget>;
-    canvases: {
-        originCanvas: HTMLCanvasElement | any;
-        drawingCanvas: HTMLCanvasElement;
-        displayCanvas: HTMLCanvasElement;
-        drawingCanvasLayerMaster: HTMLCanvasElement;
-        drawingSphereCanvas: HTMLCanvasElement;
-        emptyCanvas: HTMLCanvasElement;
-    };
-    ctxes: {
-        displayCtx: CanvasRenderingContext2D;
-        drawingCtx: CanvasRenderingContext2D;
-        emptyCtx: CanvasRenderingContext2D;
-        drawingSphereCtx: CanvasRenderingContext2D;
-        drawingLayerMasterCtx: CanvasRenderingContext2D;
-    };
-}
-/** Tool mode flags — which tool is currently active */
-interface IToolModeState {
-    pencil: boolean;
-    eraser: boolean;
-    sphere: boolean;
-    activeSphereType: "tumour" | "skin" | "nipple" | "ribcage";
-}
-/** Drawing configuration — brush/pencil appearance and behavior */
-interface IDrawingConfig {
-    globalAlpha: number;
-    lineWidth: number;
-    color: string;
-    fillColor: string;
-    brushColor: string;
-    brushAndEraserSize: number;
-}
-/** View configuration — UI layout and interaction parameters */
-interface IViewConfig {
-    mainAreaSize: number;
-    dragSensitivity: number;
-    cursor: string;
-    defaultPaintCursor: string;
-    max_sensitive: number;
-    readyToUpdate: boolean;
-}
-/** Layer/channel state — active layer, channel, and visibility */
-interface ILayerChannelState {
-    layer: string;
-    /** Currently active channel (1-8). Channel 0 is transparent/erased. */
-    activeChannel: number;
-    /** Layer visibility state: { layer1: true, layer2: true, layer3: true } */
-    layerVisibility: Record<string, boolean>;
-    /** Per-layer channel visibility: { layer1: { 1: true, ..., 8: true }, ... } */
-    channelVisibility: Record<string, Record<number, boolean>>;
-}
-interface IGUIStates extends IToolModeState, IDrawingConfig, IViewConfig, ILayerChannelState {
-}
-interface IKeyBoardSettings {
-    draw: string;
-    undo: string;
-    redo: string;
-    contrast: string[];
-    crosshair: string;
-    sphere: string;
-    mouseWheel: "Scroll:Zoom" | "Scroll:Slice";
-}
-/** Image metadata — set once during NRRD loading, read-only at runtime */
-interface IImageMetadata {
-    originWidth: number;
-    originHeight: number;
-    nrrd_x_mm: number;
-    nrrd_y_mm: number;
-    nrrd_z_mm: number;
-    nrrd_x_pixel: number;
-    nrrd_y_pixel: number;
-    nrrd_z_pixel: number;
-    dimensions: number[];
-    voxelSpacing: number[];
-    spaceOrigin: number[];
-    RSARatio: number;
-    ratios: ICommXYZ;
-    layers: string[];
-}
-/** View state — runtime display/navigation state */
-interface IViewState {
-    changedWidth: number;
-    changedHeight: number;
-    currentSliceIndex: number;
-    preSliceIndex: number;
-    maxIndex: number;
-    minIndex: number;
-    contrastNum: number;
-    sizeFactor: number;
-    showContrast: boolean;
-    switchSliceFlag: boolean;
-    previousPanelL: number;
-    previousPanelT: number;
-}
-/** Interaction state — mouse/cursor tracking */
-interface IInteractionState {
-    mouseOverX: number;
-    mouseOverY: number;
-    mouseOver: boolean;
-    cursorPageX: number;
-    cursorPageY: number;
-    isCursorSelect: boolean;
-    drawStartPos: ICommXY;
-}
-/** Sphere state — SphereTool-specific data */
-interface ISphereState {
-    sphereOrigin: ICommXYZ;
-    tumourSphereOrigin: ICommXYZ | null;
-    skinSphereOrigin: ICommXYZ | null;
-    ribSphereOrigin: ICommXYZ | null;
-    nippleSphereOrigin: ICommXYZ | null;
-    /** Dedicated MaskVolume for SphereTool 3D sphere data. Type is `any` to avoid circular deps. */
-    sphereMaskVolume: any;
-    sphereRadius: number;
-}
-/** Internal flags — transient operational flags */
-interface IInternalFlags {
-    stepClear: number;
-    clearAllFlag: boolean;
-    loadingMaskData: boolean;
-}
-/** Legacy flat interface — kept for backward compatibility during migration */
-interface INrrdStates extends IImageMetadata, IViewState, IInteractionState, ISphereState, IInternalFlags {
-}
-interface IDragOpts {
-    showNumber?: boolean;
-    getSliceNum?: (index: number, contrastNum: number) => void;
-}
-interface IDrawOpts {
-    getMaskData?: (sliceData: Uint8Array, layerId: string, channelId: number, sliceIndex: number, axis: "x" | "y" | "z", width: number, height: number, clearFlag?: boolean) => void;
-    onClearLayerVolume?: (layerId: string) => void;
-    getSphereData?: (sphereOrigin: number[], sphereRadius: number) => void;
-    getCalculateSpherePositionsData?: (tumourSphereOrigin: ICommXYZ | null, skinSphereOrigin: ICommXYZ | null, ribSphereOrigin: ICommXYZ | null, nippleSphereOrigin: ICommXYZ | null, aixs: "x" | "y" | "z") => void;
-}
-interface ICursorPage {
-    x: {
-        cursorPageX: number;
-        cursorPageY: number;
-        index: number;
-        updated: boolean;
-    };
-    y: {
-        cursorPageX: number;
-        cursorPageY: number;
-        index: number;
-        updated: boolean;
-    };
-    z: {
-        cursorPageX: number;
-        cursorPageY: number;
-        index: number;
-        updated: boolean;
-    };
-}
-interface IGuiParameterSettings {
-    globalAlpha: {
-        name: "Opacity";
-        min: number;
-        max: number;
-        step: number;
-    };
-    pencil: {
-        name: "Pencil";
-        onChange: () => void;
-    };
-    sphere: {
-        name: "Sphere";
-        onChange: () => void;
-    };
-    brushAndEraserSize: {
-        name: "BrushAndEraserSize";
-        min: number;
-        max: number;
-        step: number;
-        onChange: () => void;
-    };
-    eraser: {
-        name: "Eraser";
-        onChange: () => void;
-    };
-    activeSphereType: {
-        name: "CalculatorDistance";
-        onChange: (val: "tumour" | "skin" | "ribcage" | "nipple") => void;
-    };
-    clear: {
-        name: "Clear";
-    };
-    clearAll: {
-        name: "ClearAll";
-    };
-    undo: {
-        name: "Undo";
-    };
-    redo: {
-        name: "Redo";
-    };
-    resetZoom: {
-        name: "ResetZoom";
-    };
-    windowHigh: {
-        name: "ImageContrast";
-        value: null;
-        min: number;
-        max: number;
-        step: number;
-        onChange: (value: number) => void;
-        onFinished: () => void;
-    };
-    windowLow: {
-        name: "WindowLow";
-        value: null;
-        min: number;
-        max: number;
-        step: number;
-        onChange: (value: number) => void;
-        onFinished: () => void;
-    };
-    advance: {
-        layer: {
-            name: "Layer";
-            value: string[];
-        };
-        cursor: {
-            name: "CursorIcon";
-            value: ["crosshair", "pencil", "dot"];
-        };
-        mainAreaSize: {
-            name: "Zoom";
-            min: number;
-            max: number;
-            step: number;
-            onFinished: null;
-        };
-        dragSensitivity: {
-            name: "DragSensitivity";
-            min: number;
-            max: number;
-            step: number;
-        };
-        pencilSettings: {
-            lineWidth: {
-                name: "OuterLineWidth";
-                min: number;
-                max: number;
-                step: number;
-            };
-            color: {
-                name: "Color";
-            };
-            fillColor: {
-                name: "FillColor";
-            };
-        };
-        BrushSettings: {
-            brushColor: {
-                name: "BrushColor";
-            };
-        };
-    };
-}
-export { ToolMode, IGuiMeta, IAnnotationCallbacks, ICommXYZ, ICommXY, IDownloadImageConfig, IConvertObjType, IDragPrameters, IDrawingEvents, IContrastEvents, IProtected, IGUIStates, IToolModeState, IDrawingConfig, IViewConfig, ILayerChannelState, IDragOpts, IDrawOpts, INrrdStates, IImageMetadata, IViewState, IInteractionState, ISphereState, IInternalFlags, IPaintImage, IPaintImages, ISkipSlicesDictType, IMaskData, INewMaskData, ILayerRenderTarget, ICursorPage, IGuiParameterSettings, IKeyBoardSettings };

package/dist/Utils/segmentation/coreTools/coreType.js

@@ -1,3 +0,0 @@
-;
-export {};
-//# sourceMappingURL=coreType.js.map

package/dist/Utils/segmentation/coreTools/coreType.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"coreType.js","sourceRoot":"","sources":["../../../../src/Utils/segmentation/coreTools/coreType.ts"],"names":[],"mappings":"AA2aC,CAAC"}

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

@@ -1,192 +0,0 @@
-import { IProtected, ICursorPage, IConvertObjType, INewMaskData, IKeyBoardSettings, IAnnotationCallbacks } from "./coreTools/coreType";
-import { NrrdState } from "./coreTools/NrrdState";
-import { GuiState } from "./coreTools/GuiState";
-import { MaskVolume } from "./core/index";
-export declare class CommToolsData {
-    baseCanvasesSize: number;
-    private _reusableSliceBuffer;
-    private _reusableBufferWidth;
-    private _reusableBufferHeight;
-    /** External annotation callbacks — set via draw() options */
-    protected annotationCallbacks: IAnnotationCallbacks;
-    /** Whether the keyboard-config dialog is open (suppresses all shortcuts). */
-    protected _configKeyBoard: boolean;
-    /** Active keyboard shortcut bindings. */
-    protected _keyboardSettings: IKeyBoardSettings;
-    protected nrrd_states: NrrdState;
-    protected cursorPage: ICursorPage;
-    protected gui_states: GuiState;
-    protected 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 {clearActiveSlice} function under DrawToolCore
-     */
-    clearActiveSlice(): void;
-    /**
-     * Rewrite this {undoLastPainting} function under DrawToolCore
-     */
-    undoLastPainting(): void;
-    /**
-     * Rewrite this {redoLastPainting} function under DrawToolCore
-     */
-    redoLastPainting(): void;
-    /**
-     * Rewrite this {clearActiveLayer} function under NrrdTools
-     */
-    clearActiveLayer(): 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;
-    /**
-     * Enter sphere mode: clear all layer canvases (not MaskVolume),
-     * hide all mask data so sphere overlay is the only visible annotation.
-     * Rewrite this under NrrdTools.
-     */
-    enterSphereMode(): void;
-    /**
-     * Exit sphere mode: clear sphere canvas overlay, reload all layer
-     * MaskVolume data back onto canvases. Rewrite this under NrrdTools.
-     */
-    exitSphereMode(): 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;
-}