copper3d 3.4.9 → 3.6.0

package/dist/Utils/surfaceAnnotation/MeshGraph.js

@@ -0,0 +1,198 @@
+import * as THREE from "three";
+/**
+ * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
+ * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+ *
+ * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
+ * 保证同一表面位置共享顶点,邻接图才连通。
+ *
+ * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
+ * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+ */
+export class MeshGraph {
+    constructor(geometry) {
+        this.adj = [];
+        const pos = geometry.getAttribute("position");
+        this.positions = pos.array;
+        const nrm = geometry.getAttribute("normal");
+        this.normals = nrm ? nrm.array : null;
+        this.vertexCount = pos.count;
+        for (let i = 0; i < this.vertexCount; i++)
+            this.adj.push(new Set());
+        const addEdge = (a, b) => {
+            this.adj[a].add(b);
+            this.adj[b].add(a);
+        };
+        const index = geometry.getIndex();
+        if (index) {
+            for (let i = 0; i < index.count; i += 3) {
+                const a = index.getX(i);
+                const b = index.getX(i + 1);
+                const c = index.getX(i + 2);
+                addEdge(a, b);
+                addEdge(b, c);
+                addEdge(c, a);
+            }
+        }
+        else {
+            // 非索引兜底(连通性差,仅避免崩溃)。
+            for (let i = 0; i + 2 < this.vertexCount; i += 3) {
+                addEdge(i, i + 1);
+                addEdge(i + 1, i + 2);
+                addEdge(i + 2, i);
+            }
+        }
+    }
+    px(i) {
+        return this.positions[i * 3];
+    }
+    py(i) {
+        return this.positions[i * 3 + 1];
+    }
+    pz(i) {
+        return this.positions[i * 3 + 2];
+    }
+    /** 最近顶点(传入 local 坐标)。 */
+    nearestVertex(localPoint) {
+        let best = -1;
+        let bestD = Infinity;
+        for (let i = 0; i < this.vertexCount; i++) {
+            const dx = this.px(i) - localPoint.x;
+            const dy = this.py(i) - localPoint.y;
+            const dz = this.pz(i) - localPoint.z;
+            const d = dx * dx + dy * dy + dz * dz;
+            if (d < bestD) {
+                bestD = d;
+                best = i;
+            }
+        }
+        return best;
+    }
+    /**
+     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
+     * 不连通时返回 [start,end] 兜底。
+     */
+    shortestPath(startV, endV) {
+        if (startV === endV)
+            return [startV];
+        const dist = new Float64Array(this.vertexCount).fill(Infinity);
+        const prev = new Int32Array(this.vertexCount).fill(-1);
+        const done = new Uint8Array(this.vertexCount);
+        dist[startV] = 0;
+        const heap = new MinHeap();
+        heap.push(startV, 0);
+        while (heap.size > 0) {
+            const u = heap.pop();
+            if (done[u])
+                continue;
+            done[u] = 1;
+            if (u === endV)
+                break;
+            const ud = dist[u];
+            const ux = this.px(u);
+            const uy = this.py(u);
+            const uz = this.pz(u);
+            for (const w of this.adj[u]) {
+                if (done[w])
+                    continue;
+                const dx = this.px(w) - ux;
+                const dy = this.py(w) - uy;
+                const dz = this.pz(w) - uz;
+                const nd = ud + Math.sqrt(dx * dx + dy * dy + dz * dz);
+                if (nd < dist[w]) {
+                    dist[w] = nd;
+                    prev[w] = u;
+                    heap.push(w, nd);
+                }
+            }
+        }
+        if (prev[endV] === -1 && startV !== endV)
+            return [startV, endV];
+        const path = [];
+        for (let c = endV; c !== -1; c = prev[c]) {
+            path.push(c);
+            if (c === startV)
+                break;
+        }
+        return path.reverse();
+    }
+    vertexWorld(i, matrixWorld) {
+        return new THREE.Vector3(this.px(i), this.py(i), this.pz(i)).applyMatrix4(matrixWorld);
+    }
+    vertexNormalWorld(i, mesh) {
+        const n = new THREE.Vector3(0, 0, 1);
+        if (this.normals) {
+            n.set(this.normals[i * 3], this.normals[i * 3 + 1], this.normals[i * 3 + 2]);
+        }
+        const nm = new THREE.Matrix3().getNormalMatrix(mesh.matrixWorld);
+        return n.applyMatrix3(nm).normalize();
+    }
+    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+    vertexLocal(i) {
+        return {
+            x: this.px(i),
+            y: this.py(i),
+            z: this.pz(i),
+            nx: this.normals ? this.normals[i * 3] : 0,
+            ny: this.normals ? this.normals[i * 3 + 1] : 0,
+            nz: this.normals ? this.normals[i * 3 + 2] : 1,
+            faceIndex: -1,
+        };
+    }
+}
+/** 极简二叉最小堆(按 priority 排序,存顶点索引)。用于 Dijkstra。 */
+class MinHeap {
+    constructor() {
+        this.ids = [];
+        this.prio = [];
+    }
+    get size() {
+        return this.ids.length;
+    }
+    push(id, priority) {
+        this.ids.push(id);
+        this.prio.push(priority);
+        let i = this.ids.length - 1;
+        while (i > 0) {
+            const parent = (i - 1) >> 1;
+            if (this.prio[parent] <= this.prio[i])
+                break;
+            this.swap(i, parent);
+            i = parent;
+        }
+    }
+    pop() {
+        const topId = this.ids[0];
+        const lastId = this.ids.pop();
+        const lastPrio = this.prio.pop();
+        if (this.ids.length > 0) {
+            this.ids[0] = lastId;
+            this.prio[0] = lastPrio;
+            let i = 0;
+            const n = this.ids.length;
+            for (;;) {
+                const l = 2 * i + 1;
+                const r = 2 * i + 2;
+                let smallest = i;
+                if (l < n && this.prio[l] < this.prio[smallest])
+                    smallest = l;
+                if (r < n && this.prio[r] < this.prio[smallest])
+                    smallest = r;
+                if (smallest === i)
+                    break;
+                this.swap(i, smallest);
+                i = smallest;
+            }
+        }
+        return topId;
+    }
+    swap(a, b) {
+        const ti = this.ids[a];
+        this.ids[a] = this.ids[b];
+        this.ids[b] = ti;
+        const tp = this.prio[a];
+        this.prio[a] = this.prio[b];
+        this.prio[b] = tp;
+    }
+}
+//# sourceMappingURL=MeshGraph.js.map

package/dist/Utils/surfaceAnnotation/MeshGraph.js.map

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

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

@@ -0,0 +1,103 @@
+import * as THREE from "three";
+import type { Annotation, AnnotationMode, ExportOptions } from "./types";
+import { AnnotationStore } from "./annotationStore";
+export interface SurfaceAnnotatorOptions {
+    scene: THREE.Scene;
+    camera: THREE.PerspectiveCamera;
+    container: HTMLElement;
+    controls: {
+        enabled: boolean;
+    };
+    mesh: THREE.Mesh;
+    /** 缺省时从 mesh 几何包围盒对角线自算。 */
+    bboxDiagonal?: number;
+    /** 自由手绘 contour 颜色,默认 #e5006e。 */
+    freehandColor?: string;
+    /** 测地线 contour 颜色,默认 #ffa24e。 */
+    geodesicColor?: string;
+    /** 放点标记颜色,默认 #ffd166。 */
+    pointColor?: string;
+    /** 线宽(像素),默认 3。 */
+    lineWidth?: number;
+    /** 标记小球半径,默认 bboxDiagonal*0.006。 */
+    markerRadius?: number;
+    onModeChange?: (m: AnnotationMode) => void;
+    /** 标注列表变化回调(增删/撤销/清空)。 */
+    onChange?: (annotations: Annotation[]) => void;
+}
+/**
+ * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
+ * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
+ * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+ */
+export declare class SurfaceAnnotator {
+    private o;
+    private mode;
+    private spaceHeld;
+    private pointerDown;
+    private readonly markerRadius;
+    private readonly epsilon;
+    private readonly minGap;
+    private graph;
+    private store;
+    private managed;
+    private seq;
+    private selectedId;
+    private activeStroke?;
+    private activeLine?;
+    private lastFreehand?;
+    private activeGeo?;
+    private activeGeoLine?;
+    constructor(opts: SurfaceAnnotatorOptions);
+    /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+    private onResize;
+    private get freehandColor();
+    private get geodesicColor();
+    private get pointColorVal();
+    getMode(): AnnotationMode;
+    setMode(m: AnnotationMode): void;
+    getStore(): AnnotationStore;
+    /** 当前标注列表快照。 */
+    getAnnotations(): Annotation[];
+    undo(): void;
+    clearAll(): void;
+    deleteAnnotation(id: string): void;
+    selectAnnotation(id: string | null): void;
+    /** 颜色变更后重画对应 three 对象。 */
+    refreshAnnotation(id: string): void;
+    exportJSON(modelName: string, opts?: ExportOptions): {
+        model: string;
+        exportedAt: string;
+        space: "local" | "world";
+        annotations: {
+            id: string;
+            type: "contour" | "points";
+            mode: "freehand" | "geodesic" | null;
+            label: string;
+            color: string;
+            closed: boolean;
+            points: number[][];
+        }[];
+    };
+    private applyCameraGating;
+    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+    private reconcile;
+    private applySelection;
+    private disposeObject;
+    private nextId;
+    private hit;
+    /** 事件目标是否落在标注容器内(排除面板/页面其它区域的点击)。 */
+    private insideContainer;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
+    private closeLastContour;
+    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+    private surfacePathBetween;
+    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+    private finishGeodesic;
+    private isTypingTarget;
+    private onKeyDown;
+    private onKeyUp;
+    dispose(): void;
+}