copper3d 3.6.2 → 3.6.5

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: string;
 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.5",
   "main": "dist/bundle.umd.js",
   "moudle": "dist/bundle.esm.js",
   "types": "dist/types/index.d.ts",
@@ -32,6 +32,7 @@
   "homepage": "https://github.com/LinkunGao/copper3d_visualisation#readme",
   "devDependencies": {
     "@rollup/plugin-image": "^2.1.1",
+    "@rollup/plugin-replace": "^4.0.0",
     "@rollup/plugin-typescript": "^8.3.2",
     "@types/file-saver": "^2.0.5",
     "postcss": "^8.4.14",