copper3d 3.0.1 → 3.0.2

package/dist/Utils/segmentation/tools/PanTool.js

@@ -0,0 +1,90 @@
+/**
+ * PanTool - Right-click pan/drag navigation
+ *
+ * Extracted from DrawToolCore.paintOnCanvas() closure.
+ * Handles right-click drag to reposition the canvas view.
+ */
+import { BaseTool } from "./BaseTool";
+export class PanTool extends BaseTool {
+    constructor(ctx, callbacks) {
+        super(ctx);
+        /** Right mouse button currently held */
+        this.rightClicked = false;
+        /** Pan drag offset X (clientX − canvas.offsetLeft at drag start) */
+        this.panMoveInnerX = 0;
+        /** Pan drag offset Y (clientY − canvas.offsetTop at drag start) */
+        this.panMoveInnerY = 0;
+        /**
+         * Bound handler reference for pointermove so we can add/remove it.
+         * Arrow function preserves `this` binding.
+         */
+        this.boundPointerMove = (e) => {
+            this.handlePointerMove(e);
+        };
+        this.callbacks = callbacks;
+    }
+    /** Whether a pan drag is currently active */
+    get isActive() {
+        return this.rightClicked;
+    }
+    /**
+     * Called on right-click pointerdown.
+     * Captures initial offsets and registers pointermove listener.
+     */
+    onPointerDown(e) {
+        this.rightClicked = true;
+        const offsetX = this.ctx.protectedData.canvases.drawingCanvas.offsetLeft;
+        const offsetY = this.ctx.protectedData.canvases.drawingCanvas.offsetTop;
+        this.panMoveInnerX = e.clientX - offsetX;
+        this.panMoveInnerY = e.clientY - offsetY;
+        this.ctx.protectedData.canvases.drawingCanvas.style.cursor = "grab";
+        this.ctx.protectedData.canvases.drawingCanvas.addEventListener("pointermove", this.boundPointerMove);
+    }
+    /**
+     * Called on pointerup (button === 2).
+     * Cleans up listeners and restores cursor.
+     */
+    onPointerUp(e, defaultCursor) {
+        this.rightClicked = false;
+        this.ctx.protectedData.canvases.drawingCanvas.style.cursor = "grab";
+        setTimeout(() => {
+            this.ctx.protectedData.canvases.drawingCanvas.style.cursor = defaultCursor;
+        }, 2000);
+        this.ctx.protectedData.canvases.drawingCanvas.removeEventListener("pointermove", this.boundPointerMove);
+        if (this.ctx.gui_states.mode.sphere) {
+            this.callbacks.zoomActionAfterDrawSphere();
+        }
+    }
+    /**
+     * Called on pointerleave while pan is active.
+     * Resets state and removes listener.
+     */
+    onPointerLeave() {
+        if (!this.rightClicked)
+            return;
+        this.rightClicked = false;
+        this.ctx.protectedData.canvases.drawingCanvas.style.cursor = "grab";
+        this.ctx.protectedData.canvases.drawingCanvas.removeEventListener("pointermove", this.boundPointerMove);
+    }
+    /** Reset pan state (called when paintOnCanvas re-initializes) */
+    reset() {
+        this.rightClicked = false;
+        this.panMoveInnerX = 0;
+        this.panMoveInnerY = 0;
+    }
+    /**
+     * Pointermove handler — updates canvas position during drag.
+     */
+    handlePointerMove(e) {
+        this.ctx.protectedData.canvases.drawingCanvas.style.cursor = "grabbing";
+        this.ctx.nrrd_states.view.previousPanelL = e.clientX - this.panMoveInnerX;
+        this.ctx.nrrd_states.view.previousPanelT = e.clientY - this.panMoveInnerY;
+        this.ctx.protectedData.canvases.displayCanvas.style.left =
+            this.ctx.protectedData.canvases.drawingCanvas.style.left =
+                this.ctx.nrrd_states.view.previousPanelL + "px";
+        this.ctx.protectedData.canvases.displayCanvas.style.top =
+            this.ctx.protectedData.canvases.drawingCanvas.style.top =
+                this.ctx.nrrd_states.view.previousPanelT + "px";
+    }
+}
+//# sourceMappingURL=PanTool.js.map

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

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

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

@@ -1,6 +1,43 @@
 /**
  * SphereTool - Sphere drawing and calculator sphere operations
  *
+ * Provides 3D sphere placement across multiple slice views.
+ * Supports 4 sphere types: tumour, skin, nipple, ribcage.
+ * Each type maps to a specific layer and channel for future MaskVolume integration.
+ *
+ * ## Interaction Flow
+ * 1. Sphere mode activated (gui_states.sphere = true)
+ *    - Draw mode (Shift key) is disabled
+ *    - Crosshair toggle is disabled
+ * 2. Left-click down: record sphere center (mouseX, mouseY, sliceIndex)
+ *    - Remove zoom/slice wheel event
+ *    - Bind sphere wheel event
+ *    - Draw preview circle on sphereCanvas
+ * 3. While holding left-click, scroll wheel adjusts sphereRadius [1, 50]
+ * 4. Left-click up:
+ *    - Fire getSphere / getCalculateSpherePositions callbacks
+ *    - (Plan B) Draw 3D sphere across x/y/z axes into sphereMaskVolume
+ *    - Remove sphere wheel event
+ *    - Restore zoom/slice wheel event
+ *
+ * ## Channel Mapping
+ * Each sphere type defaults to layer1 with a specific channel:
+ * - tumour  → layer1, channel 1
+ * - ribcage → layer1, channel 3
+ * - skin    → layer1, channel 4
+ * - nipple  → layer1, channel 5
+ *
+ * ## SphereMaskVolume
+ * Sphere 3D data is stored in a dedicated MaskVolume (nrrd_states.sphereMaskVolume)
+ * separate from the layer draw mask volumes, to avoid polluting layer1's draw data.
+ * This volume is created in setAllSlices() and cleared in reset().
+ *
+ * ## Future: Writing to Layer MaskVolume
+ * Currently sphere data does NOT write to layer1's MaskVolume.
+ * The channel mapping and interfaces are reserved for future integration.
+ * When enabled, use SPHERE_CHANNEL_MAP to determine the target layer & channel,
+ * then call volume.setVoxel() or similar to persist sphere data.
+ *
  * Extracted from DrawToolCore.ts:
  * - drawSphere / drawSphereCore / clearSphereCanvas
  * - drawSphereOnEachViews / drawCalculatorSphereOnEachViews
@@ -10,27 +47,197 @@
  */
 import { BaseTool } from "./BaseTool";
 import type { ToolContext } from "./BaseTool";
+/** The 4 supported sphere marker types. */
+export type SphereType = 'tumour' | 'skin' | 'nipple' | 'ribcage';
+/**
+ * Default layer and channel for each sphere type.
+ *
+ * This mapping is used to:
+ * 1. Determine the color for sphere preview rendering
+ * 2. (Future) Write sphere data into the corresponding layer's MaskVolume channel
+ *
+ * @example
+ * ```ts
+ * const { layer, channel } = SPHERE_CHANNEL_MAP['tumour'];
+ * // layer = 'layer1', channel = 1
+ * ```
+ */
+export declare const SPHERE_CHANNEL_MAP: Record<SphereType, {
+    layer: string;
+    channel: number;
+}>;
+/**
+ * Label values for sphere types stored in sphereMaskVolume.
+ * Regular sphere mode uses SPHERE_LABEL (1).
+ * Calculator mode uses type-specific labels (1-4).
+ */
+export declare const SPHERE_LABELS: Record<SphereType | 'default', number>;
 /**
  * Callbacks that DrawToolCore must provide for sphere operations.
+ * These are internal canvas manipulation callbacks, NOT external data callbacks.
+ *
+ * External data output uses:
+ * - annotationCallbacks.onSphereChanged(origin, radius) — sphere mode
+ * - annotationCallbacks.onCalculatorPositionsChanged(...) — calculator mode
  */
 export interface SphereCallbacks {
     setEmptyCanvasSize: (axis?: "x" | "y" | "z") => void;
     drawImageOnEmptyImage: (canvas: HTMLCanvasElement) => void;
-    storeImageToAxis: (index: number, imageData: ImageData, axis?: "x" | "y" | "z") => void;
 }
 export declare class SphereTool extends BaseTool {
     private callbacks;
     constructor(ctx: ToolContext, callbacks: SphereCallbacks);
     setCallbacks(callbacks: SphereCallbacks): void;
+    /**
+     * Get the channel number for a sphere type.
+     *
+     * @param type - Sphere type ('tumour', 'skin', 'ribcage', 'nipple')
+     * @returns Channel number (1-8) mapped to this sphere type
+     *
+     * @example
+     * ```ts
+     * sphereTool.getChannelForSphereType('tumour');  // → 1
+     * sphereTool.getChannelForSphereType('skin');    // → 4
+     * ```
+     */
+    getChannelForSphereType(type: SphereType): number;
+    /**
+     * Get the default layer for a sphere type.
+     *
+     * @param type - Sphere type
+     * @returns Layer ID (e.g. 'layer1')
+     */
+    getLayerForSphereType(type: SphereType): string;
+    /**
+     * Get the preview color for a sphere type.
+     *
+     * If a volume is available for the target layer, uses the volume's
+     * custom color map (respects per-layer color customization).
+     * Otherwise falls back to SPHERE_COLORS (derived from CHANNEL_HEX_COLORS).
+     *
+     * @param type - Sphere type
+     * @returns CSS color string (hex)
+     */
+    getColorForSphereType(type: SphereType): string;
     setSphereCanvasSize(axis?: "x" | "y" | "z"): void;
+    /**
+     * Draw a filled circle on the given context.
+     *
+     * @param ctx - Canvas 2D context
+     * @param x - Center X coordinate
+     * @param y - Center Y coordinate
+     * @param radius - Circle radius in pixels
+     * @param color - Fill color (CSS string)
+     */
     drawSphereCore(ctx: CanvasRenderingContext2D, x: number, y: number, radius: number, color: string): void;
     clearSphereCanvas(): [HTMLCanvasElement, CanvasRenderingContext2D];
+    /**
+     * Draw a sphere preview circle on the sphere canvas using the current
+     * gui_states.fillColor. Called during sphere mode pointer-down.
+     *
+     * NOTE: Does NOT composite to master canvas — the start() render loop
+     * draws the sphere canvas directly to drawingCtx for proper layering.
+     */
     drawSphere(mouseX: number, mouseY: number, radius: number): void;
+    /**
+     * Returns a wheel event handler that adjusts sphere radius while the user
+     * holds left-click in sphere mode.
+     *
+     * Radius is clamped to [1, 50].
+     */
     configMouseSphereWheel(): (e: WheelEvent) => void;
+    /**
+     * Store sphere slice image into SphereMaskVolume.
+     *
+     * Currently a no-op — sphere slice data is rendered as overlay only.
+     *
+     * TODO: Future — write sphere circle data into nrrd_states.sphereMaskVolume
+     * at the specified slice index and axis. Use SPHERE_CHANNEL_MAP to determine
+     * the target channel when integrating with layer MaskVolume.
+     */
     private storeSphereImages;
+    /**
+     * Draw a sphere cross-section at a given decay distance from center,
+     * for a specific axis view.
+     *
+     * Called for each decay value [0..sphereRadius] for all 3 axes,
+     * creating the 3D sphere effect.
+     *
+     * The sphere circle radius at each slice = sphereRadius - decay (linear decay).
+     *
+     * @param decay - Distance from sphere center slice
+     * @param axis - Axis to render on ('x', 'y', 'z')
+     */
     drawSphereOnEachViews(decay: number, axis: "x" | "y" | "z"): void;
     private getSpherePosition;
+    /**
+     * Draw all 4 calculator sphere types on each view axis.
+     *
+     * Groups sphere positions by their slice index so that spheres on the
+     * same slice are drawn together before storing.
+     *
+     * Uses SPHERE_COLORS for each sphere type instead of nrrd_states.*Color.
+     */
     drawCalculatorSphereOnEachViews(axis: "x" | "y" | "z"): void;
+    /**
+     * Draw all placed calculator spheres on the current slice.
+     *
+     * Called every frame to show existing sphere markers on the current view.
+     * Uses SPHERE_COLORS for consistent type-based coloring.
+     *
+     * @param radius - Sphere radius to draw
+     */
     drawCalculatorSphere(radius: number): void;
+    /**
+     * Clear sphere overlay images.
+     *
+     * No-op in current implementation — sphere data is rendered as overlay
+     * and stored in the dedicated sphereMaskVolume (not in layer volumes).
+     */
     clearSpherePrintStoreImages(): void;
+    /**
+     * Convert canvas (mm-space) coordinates to 3D voxel coordinates.
+     *
+     * @param canvasX - X position in canvas mm-space
+     * @param canvasY - Y position in canvas mm-space
+     * @param sliceIndex - Slice index along the viewing axis
+     * @param axis - Viewing axis where the sphere was placed
+     * @returns 3D voxel coordinates { x, y, z }
+     */
+    canvasToVoxelCenter(canvasX: number, canvasY: number, sliceIndex: number, axis: "x" | "y" | "z"): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /**
+     * Write a 3D solid sphere to sphereMaskVolume.
+     *
+     * Converts the sphere center from canvas mm-space to voxel coordinates,
+     * then iterates over a bounding box and sets voxels within the sphere.
+     * The sphere is an ellipsoid in voxel space to appear circular in
+     * physical (mm) space on all axis views.
+     *
+     * @param label - Label value to write (1-4, default 1)
+     */
+    write3DSphereToVolume(label?: number): void;
+    /**
+     * Write a calculator sphere type to sphereMaskVolume.
+     * Uses the stored origin for the specified sphere type.
+     *
+     * @param type - Sphere type ('tumour', 'skin', 'nipple', 'ribcage')
+     */
+    writeCalculatorSphereToVolume(type: SphereType): void;
+    /**
+     * Write all placed calculator spheres to the volume.
+     * Clears the volume first, then writes each placed sphere type.
+     */
+    writeAllCalculatorSpheresToVolume(): void;
+    /**
+     * Render the current slice of sphereMaskVolume to drawingSphereCanvas.
+     *
+     * Called after any operation that changes the view (slice, axis, zoom)
+     * to keep the sphere overlay visible. Uses the same render pipeline as
+     * layer masks (emptyCanvas → sphere canvas at display scale).
+     */
+    refreshSphereCanvas(): void;
 }