copper3d 3.4.9 → 3.6.0

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

@@ -0,0 +1,7 @@
+import * as THREE from "three";
+import type { SurfaceHit } from "./types";
+/**
+ * 把屏幕坐标(clientX/Y)投射到 mesh 表面,返回命中点、world-space 法线与 faceIndex。
+ * 未命中返回 null。本地实现,不依赖 Copper3D 未导出的 raycast 内部函数。
+ */
+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

@@ -0,0 +1,19 @@
+import * as THREE from "three";
+import type { AnnotationVertex, SurfaceHit } from "./types";
+/**
+ * 模式 A(自由手绘)一笔的状态机。
+ * pointermove 时不断 addSample;与上一采样点世界距离 < minGap 的样本丢弃,避免过密。
+ * 顶点以 local 存(由 mesh 把世界命中点转 local)。
+ */
+export declare class StrokeContour {
+    private minGap;
+    private mesh;
+    private verts;
+    private last;
+    private has;
+    constructor(minGap: number, mesh: THREE.Mesh);
+    begin(): void;
+    addSample(hit: SurfaceHit): void;
+    get vertices(): AnnotationVertex[];
+    end(): AnnotationVertex[];
+}

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

@@ -0,0 +1,40 @@
+import * as THREE from "three";
+export type AnnotationMode = "navigate" | "freehand" | "geodesic" | "point";
+export interface SurfaceHit {
+    point: THREE.Vector3;
+    normal: THREE.Vector3;
+    faceIndex: number;
+}
+/** 标注顶点:位置与法线均为 **模型 local 空间**(单一真源,不受相机/摆放影响)。 */
+export interface AnnotationVertex {
+    x: number;
+    y: number;
+    z: number;
+    nx: number;
+    ny: number;
+    nz: number;
+    faceIndex: number;
+}
+export interface Annotation {
+    id: string;
+    type: "contour" | "points";
+    mode: "freehand" | "geodesic" | null;
+    label: string;
+    color: string;
+    closed: boolean;
+    vertices: AnnotationVertex[];
+    object3D: THREE.Object3D | null;
+}
+export interface ExportOptions {
+    /** 导出坐标空间,默认 "local"(模型空间,可复现、不受相机/摆放影响)。 */
+    space?: "local" | "world";
+    /** 是否在每个点附带法线 [x,y,z,nx,ny,nz]。 */
+    includeNormals?: boolean;
+}
+/** 世界系命中点 → local 顶点(位置 worldToLocal,法线用逆变换)。 */
+export declare function worldHitToLocalVertex(h: SurfaceHit, mesh: THREE.Mesh): AnnotationVertex;
+/** local 顶点 → world 位置 + world 法线(供渲染)。 */
+export declare function localVertexToWorld(v: AnnotationVertex, mesh: THREE.Mesh): {
+    p: THREE.Vector3;
+    n: THREE.Vector3;
+};

package/dist/types/index.d.ts

@@ -17,14 +17,17 @@ import { GaussianSmoother } from "./Utils/segmentation/core/GaussianSmoother";
 import { Copper3dTrackballControls } from "./Controls/Copper3dTrackballControls";
 import { MeshNodeTool } from "./Utils/MeshNodeTool";
 import { removeGuiFolderChilden } from "./Utils/segmentation/coreTools/gui";
+import { SurfaceAnnotator } from "./Utils/surfaceAnnotation";
+import type { SurfaceAnnotatorOptions, Annotation, AnnotationMode, ExportOptions } from "./Utils/surfaceAnnotation";
 import { nrrdMeshesType, nrrdSliceType, SensorDecodedValue_kiwrious, SensorReadResult_kiwrious, HeartRateResult_kiwrious, loadingBarType, exportPaintImageType, IOptVTKLoader, aligned4DSurfaceType, aligned4DOptsType, Aligned4DController } from "./types/types";
 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 { CHANNEL_COLORS, CHANNEL_HEX_COLORS, AI_MASK_CHANNEL_COLORS, AI_CHANNEL_HEX_COLORS, rgbaToHex, rgbaToCss } from "./Utils/segmentation/core/index";
 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.4.9-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, GaussianSmoother, };
-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, };
+export declare const REVISION = "v3.6.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, 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.4.9",
+  "version": "3.6.0",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",