copper3d 3.6.2 → 3.6.4

package/dist/index.d.ts

@@ -28,6 +28,6 @@ import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_
 import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import type { AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult } from "./Utils/segmentation/tools/AiAssistTool";
 import "./css/style.css";
-export declare const REVISION = "v3.6.2-beta";
+export declare const REVISION = "v3.6.4-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, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, SurfaceAnnotator, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, aligned4DSurfaceType, aligned4DOptsType, Aligned4DController, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, NrrdState, GuiState, IGuiMeta, ToolMode, IAnnotationCallbacks, LayerId, ChannelValue, AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult, SurfaceAnnotatorOptions, Annotation, AnnotationMode, ExportOptions, };

package/dist/index.js

@@ -22,7 +22,7 @@ import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
 import { SurfaceAnnotator } from "./Utils/surfaceAnnotation";
 import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 import "./css/style.css";
-export const REVISION = "v3.6.2-beta";
+export const REVISION = "v3.6.4-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, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, SurfaceAnnotator, };
 //# sourceMappingURL=index.js.map

package/dist/lib/three-vignette.js

@@ -1,6 +1,12 @@
 import { Color, DoubleSide, Mesh, PlaneGeometry, RawShaderMaterial, Vector2, } from "three";
-import vert from "./three-vignette.vert";
-import frag from "./three-vignette.frag";
+// Loaded as raw strings (?raw). The original copper3d build compiled these via
+// rollup-plugin-glslify; this app has no GLSL/glslify handler, so importing them as modules
+// makes Vite try to parse GLSL as JS ("Unexpected identifier 'vec3'") and the bundle dies.
+// The vignette background is only built for non-alpha scenes and this app always uses
+// alpha:true, so these shaders are never compiled/used — loading them as inert strings is
+// enough to keep the module importable.
+import vert from "./three-vignette.vert?raw";
+import frag from "./three-vignette.frag?raw";
 function createBackground(opt) {
     opt = opt || {};
     let geometry = opt.geometry || new PlaneGeometry(2, 2, 1);

package/dist/lib/three-vignette.js.map

@@ -1 +1 @@
-{"version":3,"file":"three-vignette.js","sourceRoot":"","sources":["../../src/lib/three-vignette.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"three-vignette.js","sourceRoot":"","sources":["../../src/lib/three-vignette.ts"],"names":[],"mappings":"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"}

package/dist/types/Scene/copperScene.d.ts

@@ -24,13 +24,13 @@ export declare class copperScene extends baseScene {
     }): void;
     loadVtk(url: string): void;
     /**
-     * 在给定模型表面创建标注器(画 contour / 放点 / 导出坐标)。
-     * target 可为单个 Mesh,或 Group/Object3D(自动选顶点数最多的 mesh)。
-     * 复用本 scene 的 camera / container / controls;几何非索引时内部自动焊接索引化。
+     * Create an annotator on the surface of a given model (draw contours / place points / export coordinates).
+     * target can be a single Mesh, or a Group/Object3D (the mesh with the most vertices is chosen automatically).
+     * Reuses this scene's camera / container / controls; non-indexed geometry is welded and indexed automatically.
      */
     createSurfaceAnnotator(target: THREE.Mesh | THREE.Object3D, opts?: Omit<SurfaceAnnotatorOptions, "scene" | "camera" | "container" | "controls" | "mesh">): SurfaceAnnotator;
     private pickAnnotatableMesh;
-    /** 释放本 scene 创建的所有标注器(移除事件监听与标注对象)。 */
+    /** Dispose all annotators created on this scene (removes event listeners and annotation objects). */
     disposeSurfaceAnnotators(): void;
     loadVtks(models: Array<vtkModels>): void;
     /**

package/dist/types/Utils/surfaceAnnotation/MeshGraph.d.ts

@@ -1,13 +1,15 @@
 import * as THREE from "three";
 /**
- * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
- * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+ * Build a vertex adjacency graph from a BufferGeometry's index, used for the shortest path in
+ * mode B (geodesic). Vertex coordinates are stored in local space; query points must be converted
+ * to local first (mesh.worldToLocal).
  *
- * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
- * 保证同一表面位置共享顶点,邻接图才连通。
+ * Note: the geometry must be indexed. modelLoader welds duplicate vertices with mergeVertices so
+ * that vertices at the same surface position are shared, otherwise the adjacency graph won't be connected.
  *
- * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
- * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+ * Performance: O(V²) Dijkstra + O(V) nearest-vertex lookup. Acceptable for a single click on tens
+ * of thousands of vertices; if too large it can later be sped up with a binary heap + spatial grid
+ * (left as a future upgrade).
  */
 export declare class MeshGraph {
     private positions;
@@ -18,16 +20,16 @@ export declare class MeshGraph {
     private px;
     private py;
     private pz;
-    /** 最近顶点(传入 local 坐标)。 */
+    /** Nearest vertex (pass in local coordinates). */
     nearestVertex(localPoint: THREE.Vector3): number;
     /**
-     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
-     * 不连通时返回 [start,end] 兜底。
+     * Shortest path between two vertices (sequence of vertex indices including endpoints).
+     * Binary-heap Dijkstra, O(E log V). Falls back to [start,end] when disconnected.
      */
     shortestPath(startV: number, endV: number): number[];
     vertexWorld(i: number, matrixWorld: THREE.Matrix4): THREE.Vector3;
     vertexNormalWorld(i: number, mesh: THREE.Mesh): THREE.Vector3;
-    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+    /** Vertex local coordinates + local normal (the graph geometry is already local space). */
     vertexLocal(i: number): {
         x: number;
         y: number;

package/dist/types/Utils/surfaceAnnotation/SurfaceAnnotator.d.ts

@@ -9,26 +9,34 @@ export interface SurfaceAnnotatorOptions {
         enabled: boolean;
     };
     mesh: THREE.Mesh;
-    /** 缺省时从 mesh 几何包围盒对角线自算。 */
+    /** Computed from the mesh geometry's bounding-box diagonal when omitted. */
     bboxDiagonal?: number;
-    /** 自由手绘 contour 颜色,默认 #e5006e。 */
+    /**
+     * Outward offset of the annotation line from the surface (world units), defaults to bboxDiagonal*0.002.
+     * Providing it separately decouples it from the sampling spacing (minGap/maxJump, still derived from
+     * bboxDiagonal) — useful on bumpy/voxel surfaces where a larger offset is needed to float the line
+     * above the relief without also coarsening the sampling.
+     */
+    epsilon?: number;
+    /** Freehand contour color, defaults to #e5006e. */
     freehandColor?: string;
-    /** 测地线 contour 颜色,默认 #ffa24e。 */
+    /** Geodesic contour color, defaults to #ffa24e. */
     geodesicColor?: string;
-    /** 放点标记颜色,默认 #ffd166。 */
+    /** Point-marker color, defaults to #ffd166. */
     pointColor?: string;
-    /** 线宽(像素),默认 3。 */
+    /** Line width (pixels), defaults to 3. */
     lineWidth?: number;
-    /** 标记小球半径,默认 bboxDiagonal*0.006。 */
+    /** Marker sphere radius, defaults to bboxDiagonal*0.006. */
     markerRadius?: number;
     onModeChange?: (m: AnnotationMode) => void;
-    /** 标注列表变化回调(增删/撤销/清空)。 */
+    /** Callback when the annotation list changes (add/remove/undo/clear). */
     onChange?: (annotations: Annotation[]) => void;
 }
 /**
- * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
- * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
- * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+ * Main surface-annotation controller (Phase 4): four modes navigate / freehand / geodesic / point,
+ * Enter closes the loop, and data is managed by AnnotationStore (multiple color-labeled strips,
+ * undo/delete/clear, export).
+ * The render layer reconciles the scene against store.list(); undo/delete automatically add/remove three objects.
  */
 export declare class SurfaceAnnotator {
     private o;
@@ -56,7 +64,7 @@ export declare class SurfaceAnnotator {
     private hoveredGeoMarker;
     private _projV;
     constructor(opts: SurfaceAnnotatorOptions);
-    /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+    /** Update the pixel resolution of all fat lines on window resize, otherwise line width distorts. */
     private onResize;
     private get freehandColor();
     private get geodesicColor();
@@ -64,13 +72,13 @@ export declare class SurfaceAnnotator {
     getMode(): AnnotationMode;
     setMode(m: AnnotationMode): void;
     getStore(): AnnotationStore;
-    /** 当前标注列表快照。 */
+    /** Snapshot of the current annotation list. */
     getAnnotations(): Annotation[];
     undo(): void;
     clearAll(): void;
     deleteAnnotation(id: string): void;
     selectAnnotation(id: string | null): void;
-    /** 颜色变更后重画对应 three 对象。 */
+    /** Redraw the corresponding three object after a color change. */
     refreshAnnotation(id: string): void;
     exportJSON(modelName: string, opts?: ExportOptions): {
         model: string;
@@ -87,42 +95,54 @@ export declare class SurfaceAnnotator {
         }[];
     };
     private applyCameraGating;
-    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+    /** Reconcile the scene against store.list(): add missing objects, remove deleted ones (no dispose, kept for undo restore). */
     private reconcile;
     private applySelection;
     private disposeObject;
     private nextId;
     private hit;
     /**
-     * 事件目标是否是容器内的 WebGL canvas。
-     * 仅认 canvas:面板(GUIDE / 控制面板 / 标注列表的 ✕ 按钮)都是 container 的子元素,
-     * 若只判断 contains 会把面板上的点击也当成在模型上作画 —— 这会"穿透"删除按钮、
-     * 让 ✕ 难以点中。只响应 canvas 上的指针事件即可彻底隔离 UI 与画布。
+     * Whether the event target is the WebGL canvas inside the container.
+     * Only accept the canvas: panels (GUIDE / control panel / the ✕ buttons in the annotation list)
+     * are all children of the container, so checking contains alone would treat clicks on the panels
+     * as drawing on the model — which "leaks through" the delete buttons and makes ✕ hard to click.
+     * Responding only to pointer events on the canvas fully isolates the UI from the drawing surface.
      */
     private insideContainer;
     private onPointerDown;
-    /** 射线拾取进行中的锚点小球,返回锚点下标;未命中返回 -1。 */
+    /**
+     * Pick an in-progress anchor: return the index of the nearest anchor (screen pixel distance <
+     * tolerance), or -1 on a miss.
+     *
+     * Uses "screen-space pixel distance" instead of ray/sphere intersection: the anchor spheres are
+     * tiny, so strict ray/sphere hits require pixel-perfect aiming and most clicks miss — and a miss
+     * falls through to the "add anchor" branch, so trying to delete a point ends up adding one. That
+     * was the root cause of the old "deleting a point takes several clicks, must hit the sphere dead
+     * center" problem. Projecting each anchor to the screen and taking the nearest within tolerance
+     * makes deletion stable and reliable. The tolerance is enlarged relative to the sphere's screen
+     * radius to make it easy to hit.
+     */
     private pickGeoMarker;
-    /** 设置当前悬停的锚点(-1 = 无):更新高亮缩放、光标与"✕(可取消)"悬浮标。 */
+    /** Set the currently hovered anchor (-1 = none): update highlight scale, cursor, and the "✕ (cancel)" floating badge. */
     private setGeoHover;
-    /** 懒创建悬浮 ✕ 标(挂在 container 内,pointer-events:none 不挡点击)。 */
+    /** Lazily create the floating ✕ badge (appended inside the container, pointer-events:none so it doesn't block clicks). */
     private ensureGeoBadge;
-    /** 把 ✕ 标定位到锚点投影到屏幕的位置(正中心,即光标悬停处,避免歧义)。 */
+    /** Position the ✕ badge at the anchor's screen projection (dead center, i.e. where the cursor hovers, to avoid ambiguity). */
     private positionGeoBadge;
-    /** 据当前锚点重建可见的锚点小球(锚点比放点稍大,便于看见与点中取消)。 */
+    /** Rebuild the visible anchor spheres from the current anchors (slightly larger than placed points, so they're easy to see and click to cancel). */
     private rebuildGeoMarkers;
-    /** 据当前锚点重画进行中的测地线(不闭合);不足两点时移除线。 */
+    /** Redraw the in-progress geodesic from the current anchors (not closed); remove the line when fewer than two points. */
     private redrawGeoLine;
-    /** 丢弃进行中的测地线:移除并 dispose 线与全部锚点。 */
+    /** Discard the in-progress geodesic: remove and dispose the line and all anchors. */
     private clearActiveGeo;
-    /** 移除进行中测地线的全部锚点小球(落定后调用:只留下线)。 */
+    /** Remove all anchor spheres of the in-progress geodesic (called after committing: only the line remains). */
     private removeGeoMarkers;
     private onPointerMove;
     private onPointerUp;
     private closeLastContour;
-    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+    /** Compute the geodesic path a→b along the mesh surface (local vertices), dropping the first point that coincides with a. a/b are already local. */
     private surfacePathBetween;
-    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+    /** Finish the current geodesic: close it into a ring and commit it as one contour. */
     private finishGeodesic;
     private isTypingTarget;
     private onKeyDown;

package/dist/types/Utils/surfaceAnnotation/annotationStore.d.ts

@@ -1,9 +1,9 @@
 import * as THREE from "three";
 import type { Annotation, ExportOptions } from "./types";
 /**
- * 标注数据模型 + 撤销栈 + 导出。纯数据,无 three / DOM 依赖。
- * 撤销只记录 add / remove 两类原子操作(满足"撤销最近添加 / 恢复删除")。
- * 通过 subscribe 通知 UI 与渲染层(后者据 list() 做场景对账)。
+ * Annotation data model + undo stack + export. Pure data, no three / DOM dependencies.
+ * Undo only records two atomic operations, add / remove (enough for "undo last add / restore delete").
+ * Notifies the UI and render layer via subscribe (the latter reconciles the scene against list()).
  */
 export declare class AnnotationStore {
     private items;
@@ -14,7 +14,7 @@ export declare class AnnotationStore {
     add(a: Annotation): void;
     remove(id: string): Annotation | undefined;
     undo(): void;
-    /** 清空,返回被清掉的项(供渲染层 dispose three 对象)。 */
+    /** Clear all, returning the removed items (so the render layer can dispose three objects). */
     clear(): Annotation[];
     list(): Annotation[];
     get(id: string): Annotation | undefined;

package/dist/types/Utils/surfaceAnnotation/contourRender.d.ts

@@ -3,5 +3,5 @@ import { Line2 } from "three/examples/jsm/lines/Line2";
 import type { AnnotationVertex } from "./types";
 export declare function makeContourLine(verts: AnnotationVertex[], color: string, closed: boolean, container: HTMLElement, epsilon: number, mesh: THREE.Mesh): Line2;
 export declare function updateContourLine(line: Line2, verts: AnnotationVertex[], closed: boolean, epsilon: number, mesh: THREE.Mesh): void;
-/** 改变已有 contour 线的颜色。 */
+/** Change the color of an existing contour line. */
 export declare function setContourColor(line: Line2, color: string): void;

package/dist/types/Utils/surfaceAnnotation/geodesicContour.d.ts

@@ -2,8 +2,9 @@ import * as THREE from "three";
 import type { AnnotationVertex } from "./types";
 import { MeshGraph } from "./MeshGraph";
 /**
- * 模式 B(测地线)状态机:逐次点击锚点,相邻锚点之间用 MeshGraph 求最短路径,
- * 拼成一条贴合表面的折线。Enter 结束并可闭合(首尾再求一段)。
+ * State machine for mode B (geodesic): click anchors one by one, find the shortest path between
+ * adjacent anchors with MeshGraph, and stitch them into a polyline that hugs the surface.
+ * Enter finishes and can close the loop (computing one more segment between first and last).
  */
 export declare class GeodesicContour {
     private graph;
@@ -12,21 +13,21 @@ export declare class GeodesicContour {
     private segments;
     private history;
     constructor(graph: MeshGraph, mesh: THREE.Mesh);
-    /** 任何改动锚点前先存一份快照(顶点索引数组很小,快照成本可忽略)。 */
+    /** Save a snapshot before any anchor change (the vertex-index array is tiny, so snapshot cost is negligible). */
     private snapshot;
-    /** 传入 local 命中点,snap 到最近顶点并对上一锚点求路径。 */
+    /** Given a local hit point, snap to the nearest vertex and compute the path to the previous anchor. */
     addAnchor(localHitPoint: THREE.Vector3): void;
-    /** 删除指定下标的锚点,重算相邻段(支持取消中间任意一点)。 */
+    /** Remove the anchor at the given index and recompute adjacent segments (allows canceling any middle point). */
     removeAnchorAt(index: number): void;
-    /** 是否还有可撤销的编辑(加点/删点)。 */
+    /** Whether there is still an editable change to undo (add/remove point). */
     canUndo(): boolean;
-    /** 撤销上一次锚点编辑(加点 → 删回去;删点 → 恢复)。无历史返回 false。 */
+    /** Undo the last anchor edit (add → remove it; remove → restore it). Returns false when no history. */
     undoEdit(): boolean;
-    /** 据当前锚点序列整体重算所有相邻段路径。 */
+    /** Recompute all adjacent-segment paths from the current anchor sequence. */
     private rebuildSegments;
-    /** 各锚点的 local 顶点(用于绘制可见的锚点标记)。 */
+    /** Local vertex of each anchor (used to draw visible anchor markers). */
     getAnchorLocals(): AnnotationVertex[];
     get anchorCount(): number;
-    /** 把所有路径顶点(world)+ 法线 拼成折线;closed 时补一段首尾路径。 */
+    /** Stitch all path vertices (world) + normals into a polyline; when closed, add one first-to-last segment. */
     buildVertices(closed: boolean): AnnotationVertex[];
 }

package/dist/types/Utils/surfaceAnnotation/pointMarkers.d.ts

@@ -1,7 +1,8 @@
 import * as THREE from "three";
 import type { AnnotationVertex } from "./types";
 /**
- * 在 local 顶点处生成一个标记小球(fiducial)。local→world 后沿 world 法线略外移,
- * 避免一半埋进表面。radius 由调用方按模型 bbox 缩放传入。
+ * Create a marker sphere (fiducial) at a local vertex. After local→world, nudge it
+ * outward along the world normal so it doesn't sink halfway into the surface.
+ * radius is passed in by the caller, scaled to the model bbox.
  */
 export declare function makePointMarker(v: AnnotationVertex, mesh: THREE.Mesh, color: string, radius: number): THREE.Mesh;

package/dist/types/Utils/surfaceAnnotation/raycastSurface.d.ts

@@ -1,7 +1,8 @@
 import * as THREE from "three";
 import type { SurfaceHit } from "./types";
 /**
- * 把屏幕坐标(clientX/Y)投射到 mesh 表面,返回命中点、world-space 法线与 faceIndex。
- * 未命中返回 null。本地实现,不依赖 Copper3D 未导出的 raycast 内部函数。
+ * Project screen coordinates (clientX/Y) onto the mesh surface, returning the hit point,
+ * world-space normal, and faceIndex. Returns null on a miss. Local implementation that does not
+ * depend on Copper3D's unexported raycast internals.
  */
 export declare function raycastSurface(camera: THREE.PerspectiveCamera, container: HTMLElement, mesh: THREE.Mesh, clientX: number, clientY: number): SurfaceHit | null;

package/dist/types/Utils/surfaceAnnotation/strokeContour.d.ts

@@ -1,9 +1,10 @@
 import * as THREE from "three";
 import type { AnnotationVertex, SurfaceHit } from "./types";
 /**
- * 模式 A(自由手绘)一笔的状态机。
- * pointermove 时不断 addSample;与上一采样点世界距离 < minGap 的样本丢弃,避免过密。
- * 顶点以 local 存(由 mesh 把世界命中点转 local)。
+ * State machine for one stroke in mode A (freehand).
+ * On pointermove it keeps calling addSample; samples whose world distance from the previous
+ * sample is < minGap are dropped to avoid over-density.
+ * Vertices are stored in local space (the mesh converts the world hit point to local).
  */
 export declare class StrokeContour {
     private minGap;
@@ -14,9 +15,11 @@ export declare class StrokeContour {
     private lastNormal;
     private has;
     /**
-     * @param minGap  采样最小间距(世界系),去抖
-     * @param maxJump 跳变阈值(世界系):距离 > maxJump 且法线大幅翻转时丢弃该样本,
-     *                避免笔触掠过沟缝/轮廓边时相邻点落在不同深度、直线段横穿模型。
+     * @param minGap  minimum sample spacing (world space), debounce
+     * @param maxJump jump threshold (world space): drop the sample when distance > maxJump and the
+     *                normal flips sharply, to prevent adjacent points landing at different depths
+     *                (and the straight segment cutting through the model) when the stroke grazes a
+     *                groove or contour edge.
      */
     constructor(minGap: number, maxJump: number, mesh: THREE.Mesh);
     begin(): void;

package/dist/types/Utils/surfaceAnnotation/types.d.ts

@@ -5,7 +5,7 @@ export interface SurfaceHit {
     normal: THREE.Vector3;
     faceIndex: number;
 }
-/** 标注顶点:位置与法线均为 **模型 local 空间**(单一真源,不受相机/摆放影响)。 */
+/** Annotation vertex: position and normal are both in **model local space** (single source of truth, unaffected by camera/placement). */
 export interface AnnotationVertex {
     x: number;
     y: number;
@@ -26,14 +26,14 @@ export interface Annotation {
     object3D: THREE.Object3D | null;
 }
 export interface ExportOptions {
-    /** 导出坐标空间,默认 "local"(模型空间,可复现、不受相机/摆放影响)。 */
+    /** Export coordinate space, defaults to "local" (model space, reproducible and unaffected by camera/placement). */
     space?: "local" | "world";
-    /** 是否在每个点附带法线 [x,y,z,nx,ny,nz]。 */
+    /** Whether to attach a normal to each point [x,y,z,nx,ny,nz]. */
     includeNormals?: boolean;
 }
-/** 世界系命中点 → local 顶点(位置 worldToLocal,法线用逆变换)。 */
+/** World-space hit point → local vertex (position via worldToLocal, normal via inverse transform). */
 export declare function worldHitToLocalVertex(h: SurfaceHit, mesh: THREE.Mesh): AnnotationVertex;
-/** local 顶点 → world 位置 + world 法线(供渲染)。 */
+/** Local vertex → world position + world normal (for rendering). */
 export declare function localVertexToWorld(v: AnnotationVertex, mesh: THREE.Mesh): {
     p: THREE.Vector3;
     n: THREE.Vector3;

package/dist/types/index.d.ts

@@ -28,6 +28,6 @@ import { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_
 import type { LayerId, ChannelValue } from "./Utils/segmentation/core/index";
 import type { AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult } from "./Utils/segmentation/tools/AiAssistTool";
 import "./css/style.css";
-export declare const REVISION = "v3.6.2-beta";
+export declare const REVISION = "v3.6.4-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, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss, GaussianSmoother, SurfaceAnnotator, };
 export type { positionType, screenPosType, optsType, nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, IPaintImage, exportPaintImageType, IOptVTKLoader, aligned4DSurfaceType, aligned4DOptsType, Aligned4DController, ICommXYZ, IGUIStates, IGuiParameterSettings, INrrdStates, NrrdState, GuiState, IGuiMeta, ToolMode, IAnnotationCallbacks, LayerId, ChannelValue, AiPromptTool, AiPromptPoint, AiPromptPayload, AiMaskResult, SurfaceAnnotatorOptions, Annotation, AnnotationMode, ExportOptions, };

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.6.2",
+  "version": "3.6.4",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",