@realsee/dnalogel 4.0.0-webgpu.18 → 4.0.0-webgpu.20

package/dist/types/MeasurePlugin/Controller.d.ts

@@ -20,6 +20,8 @@ export type MeasurePluginEventMap = {
 export declare class MeasureController extends Subscribe<MeasurePluginEventMap> {
     readonly name = "MeasurePlugin";
     currentMeasureMesh?: MeasureMesh | null;
+    /** 双击快速测量结束后，用命中点继续下一段测量（由当前测量会话提供） */
+    protected continueMeasureFrom?: (end: THREE.Vector3) => void;
     private five;
     private group;
     private currentEndReason;
@@ -50,6 +52,11 @@ export declare class MeasureController extends Subscribe<MeasurePluginEventMap>
      * @description Initialize event listeners for all existing meshes
      */
     initEventListeners: () => void;
+    /**
+     * 取消所有测量结果的选中态。
+     * 组内还并存着预览用的临时对象（点 / 线 / 多边形），它们没有选中态，需要跳过。
+     */
+    private unselectAllMeasureMeshes;
     /**
      * @description 开始测量
      */

package/dist/types/MeasurePlugin/utils/MeasureMesh.d.ts

@@ -3,6 +3,11 @@ import { LineWithDotsMesh } from '../../Sculpt/Meshes/LineWithDots.js';
 import { PolygonMesh, PolygonStyle } from '../../Sculpt/Meshes/Polygon.js';
 import { LineMeshStyle } from '../../Sculpt/typings/index.js';
 import type * as THREE from 'three/webgpu';
+/**
+ * 判断对象是否为测量结果。
+ * MeasureGroup 内除测量结果外还并存着预览用的临时对象（点 / 线 / 多边形），它们没有选中态等测量接口。
+ */
+export declare function isMeasureMesh(item: unknown): item is MeasureMesh;
 export declare class MeasureMesh extends IObject3D {
     readonly name = "MeasureMesh";
     readonly isMeasureMesh = true;

package/dist/types/MeasurePluginV2/Controller.d.ts

@@ -21,6 +21,11 @@ export type MeasurePluginV2Config = MeasurePluginConfig & {
      * 传 `false` 可关闭；不传默认开启。
      */
     edgeSnap?: boolean | EdgeSnapOptions;
+    /**
+     * @description 双击快速测量（仅鼠标）：双击起点时沿所在平面的法线测到对面，例如墙到对面墙。
+     * 传 `false` 可关闭；不传默认开启。
+     */
+    quickMeasure?: boolean;
 };
 export declare class MeasureControllerV2 extends MeasureController {
     /** 最近一次查询到的候选边数量，示例页 / 调试用 */
@@ -30,6 +35,8 @@ export declare class MeasureControllerV2 extends MeasureController {
     private v2Attached;
     private readonly edgeSnapOptions;
     private readonly edgeSnapCache;
+    private readonly quickMeasureEnabled;
+    private quickMeasure?;
     constructor(five: Five, config?: MeasurePluginV2Config);
     get edgeSnapEnabled(): boolean;
     /** 运行时开关模型边缘吸附（不需要重开测量） */
@@ -41,6 +48,8 @@ export declare class MeasureControllerV2 extends MeasureController {
     private attachOverlayRenderers;
     private attachMagnifier;
     private attachPointHelper;
+    /** 双击快速测量：只在测量过程中生效，选点链路仍由原 MeasureController 负责 */
+    private attachQuickMeasure;
     /**
      * 模型边缘吸附：每次选点器计算吸附前，按当前落点取附近的模型边界线。
      * 真正的吸附判断（3D 距离 / 屏幕距离）仍在 PointSelector 里，这里只负责供线。

package/dist/types/MeasurePluginV2/Magnifier.d.ts

@@ -1,9 +1,22 @@
 import { Five } from '@realsee/five-webgpu';
 import { PointIntersection } from '../shared-utils/index.js';
 import { Magnifier, MagnifierParameter } from '../shared-utils/three/Magnifier.js';
+export { CLOSEUP_DISTANCE } from './closeupView.js';
+/** 近景取景方式；与 Editor V2 保持同一套语义 */
+export type MeasureCloseupMode = 
+/** 只旋转、不平移：与主视图共用机位，无新增视差；默认 */
+'rotate'
+/** 旧行为：把相机推到落点附近 0.6m，再朝法线偏转；放大倍率高，但会产生视差 */
+ | 'push'
+/** 完全沿用主相机，只放大局部像素 */
+ | 'off';
 export interface MeasureMagnifierOptions extends MagnifierParameter {
     /** 是否绘制坐标轴 / 平面框叠加层，默认 true（关掉后行为与现状 Magnifier 完全一致） */
     overlayEnabled?: boolean;
+    /** 兼容旧参数：false 等价于 closeupMode='off' */
+    closeupEnabled?: boolean;
+    /** 近景取景方式，默认 'rotate' */
+    closeupMode?: MeasureCloseupMode;
 }
 /**
  * 量尺 V2 用的放大镜。
@@ -19,11 +32,31 @@ export declare class MeasureMagnifier extends Magnifier {
     /** 由 PointSelector 的 intersectionUpdate 事件注入 */
     private overlayIntersection;
     private overlayEnabled;
+    private closeupMode;
+    /** 本次渲染实际使用的相机（推近后的副本），叠加层投影必须和它一致 */
+    private overlayCamera;
+    /** 近景视角的平滑状态 */
+    private closeupState;
     constructor(five: Five, options?: MeasureMagnifierOptions);
     /** 每次交点更新时调用；传 null 表示当前没有命中任何模型 */
     setIntersection(intersection: PointIntersection | null): void;
     /** 开关叠加层，用于灰度 / 排查问题 */
     setOverlayEnabled(enabled: boolean): void;
+    /** 开关近景 3D 视角，用于灰度 / 对比；开启时使用默认的 rotate 模式 */
+    setCloseupEnabled(enabled: boolean): void;
+    /** 切换近景取景方式，用于三种模式的对比 */
+    setCloseupMode(mode: MeasureCloseupMode): void;
+    getCloseupMode(): MeasureCloseupMode;
     private renderOverlay;
+    /**
+     * 近景 3D 视角：读像素前把相机推到落点附近，并让视线朝落点所在表面的法线偏一点
+     * （斜向 / 侧向的表面在放大镜里以更接近正面的角度呈现），读完立即还原。
+     * 姿态由主相机绕落点做最小旋转得到：偏转角有上限、画面不翻滚，
+     * 相机始终朝向落点，落点因此仍在画面正中，父类按落点投影取的读取区域依旧对准落点。
+     */
+    private prepareCloseup;
+    private moveCameraCloseup;
+    /** 只记录投影要用的矩阵；Five 的相机 clone() 开销大，也不保证可用 */
+    private snapshotOverlayCamera;
     private getOverlayContext;
 }

package/dist/types/MeasurePluginV2/PointOverlay.d.ts

@@ -53,6 +53,11 @@ export interface MagnifierViewport {
     /** 放大镜 canvas 的宽高（设备像素） */
     canvasWidth: number;
     canvasHeight: number;
+    /**
+     * 叠加层线宽缩放：canvas 设备像素 / CSS 像素。
+     * 高清读回时 canvas 变大，固定线宽需要同步放大，否则轴线和平面框会变细。
+     */
+    lineScale?: number;
 }
 /**
  * 求交点的世界坐标系法线。

package/dist/types/MeasurePluginV2/closeupView.d.ts

@@ -0,0 +1,69 @@
+import * as THREE from 'three/webgpu';
+/**
+ * 放大镜近景视角的取向计算。
+ *
+ * 目标（与 MP 的观感一致）：放大镜不是主视图的简单放大。落点所在表面没有正对相机时，
+ * 视角会朝表面法线偏一点，让斜面 / 侧面在放大镜里以更接近正面的角度呈现；
+ * 同时要保证它始终是「主视图那台相机绕落点转了一点」——不换机位、不翻滚、偏转角有上限。
+ *
+ * 这里只做纯数学，相机怎么临时改、怎么还原由调用方负责。
+ */
+/** 近景相机到落点的距离（米） */
+export declare const CLOSEUP_DISTANCE = 0.6;
+/** 朝表面转正的比例：把「主视线到正对表面」的夹角消掉这么多 */
+export declare const CLOSEUP_NORMAL_BLEND = 0.5;
+/** 近景视角相对主视图的最大偏转角（弧度）。超过就封顶，避免侧视时像换了个机位 */
+export declare const CLOSEUP_MAX_DEVIATION: number;
+/** 判定法线朝向时的滞回区间（点积）：视线接近贴着表面时沿用上一帧朝向，避免来回翻 */
+export declare const CLOSEUP_FLIP_EPSILON = 0.05;
+/** 跨帧状态：目前只用于法线朝向的滞回 */
+export interface CloseupViewState {
+    /** 本帧的视线方向（单位向量） */
+    direction: THREE.Vector3;
+    /** 本帧的落点 */
+    point: THREE.Vector3;
+    /** 本帧法线的朝向：1 = 与传入的法线同向，-1 = 反向，null = 没有法线 */
+    normalSign: 1 | -1 | null;
+}
+export interface CloseupViewOptions {
+    /** 落点（世界坐标） */
+    point: THREE.Vector3;
+    /** 落点所在表面的法线（世界坐标，方向不限）；拿不到时传 null，只推近不偏转 */
+    normal: THREE.Vector3 | null;
+    /** 主相机位置 */
+    cameraPosition: THREE.Vector3;
+    /** 主相机世界四元数；近景姿态由它绕落点做最小旋转得到，因此不会翻滚 */
+    cameraQuaternion: THREE.Quaternion;
+    /** 近景距离，默认 CLOSEUP_DISTANCE；主相机比这更近时保持原距离。translate=false 时忽略 */
+    distance?: number;
+    /**
+     * 是否把相机沿最终视线移动到落点附近。
+     * true = 旧行为（推到 0.6m）；false = 只旋转、不平移，放大镜与主视图共用同一机位，
+     * 不会产生视差，也不会让全景球心偏移导致画面扭曲。
+     */
+    translate?: boolean;
+    /** 朝法线偏转的比例，默认 CLOSEUP_NORMAL_BLEND */
+    blend?: number;
+    /** 最大偏转角（弧度），默认 CLOSEUP_MAX_DEVIATION */
+    maxDeviation?: number;
+    /** 上一帧的状态，只用于法线朝向的滞回；第一帧传 null */
+    previous?: CloseupViewState | null;
+}
+export interface CloseupView {
+    /** 近景相机位置 */
+    position: THREE.Vector3;
+    /** 近景相机视线方向（单位向量） */
+    direction: THREE.Vector3;
+    /** 近景相机世界四元数（视线方向与 direction 一致，roll 由主相机继承） */
+    quaternion: THREE.Quaternion;
+    /** 供下一次调用使用的状态 */
+    state: CloseupViewState;
+}
+/**
+ * 计算近景相机的位姿：
+ * 1. translate=true 时相机落在「落点后方 distance 处、朝向落点」这条线上，落点因此仍在画面正中；
+ *    translate=false 时保持原机位，只改变朝向（放大镜与主视图共用视点，不产生视差）；
+ * 2. 姿态 = 主相机姿态先把视线校正到落点，再朝「正对表面」的方向转一小段（有上限）；
+ * 3. 因为是绕相机的旋转，画面不会翻滚，观感就是「同一台相机微微转了个角度」。
+ */
+export declare function resolveCloseupView(options: CloseupViewOptions): CloseupView | null;

package/dist/types/MeasurePluginV2/normalMeasure.d.ts

@@ -0,0 +1,116 @@
+import * as THREE from 'three/webgpu';
+/**
+ * 双击快速测量：从落点沿所在平面的法线发一条射线，取第一个打到的模型表面作为终点。
+ * 典型场景是双击墙面直接得到墙到对面墙的垂直距离。
+ */
+/** 射线起点离开表面的距离（米），避免射线一出发就打中落点所在的面 */
+export declare const NORMAL_RAY_START_OFFSET = 0.01;
+/** 终点离起点太近（米）视为无效，例如打中了落点旁边的小凸起 */
+export declare const NORMAL_RAY_MIN_DISTANCE = 0.02;
+/** 射线最远距离（米），超过视为没打到 */
+export declare const NORMAL_RAY_MAX_DISTANCE = 100;
+/** 双击判定：两次抬起的最大间隔（毫秒） */
+export declare const DOUBLE_CLICK_INTERVAL = 350;
+/** 双击判定：两次抬起的最大屏幕距离（像素） */
+export declare const DOUBLE_CLICK_MAX_MOVE = 6;
+export interface RaycastHit {
+    point: THREE.Vector3;
+    distance: number;
+    /** 命中面；THREE.Intersection 的 face.normal 已经是世界坐标系法线 */
+    face?: {
+        normal?: THREE.Vector3 | null;
+    } | null;
+}
+/** 法线快速测量的命中结果 */
+export interface NormalMeasureHit {
+    /** 终点 */
+    point: THREE.Vector3;
+    /** 终点所在表面的世界坐标系法线；拿不到时为 null */
+    normal: THREE.Vector3 | null;
+}
+/** 对模型做射线检测，返回按距离排序的命中结果 */
+export type ModelRaycast = (raycaster: THREE.Raycaster) => RaycastHit[];
+/**
+ * 沿法线求快速测量的命中点。
+ * @param point - 起点（双击的落点）
+ * @param normal - 起点所在平面的法线（世界坐标，朝向表面外侧，即朝向相机这一侧）
+ * @returns 命中点及其表面法线；法线无效或没打到模型时返回 null
+ */
+export declare function findNormalMeasureHit(point: THREE.Vector3, normal: THREE.Vector3, raycast: ModelRaycast): NormalMeasureHit | null;
+/** 只要终点时用这个 */
+export declare function findNormalMeasureEnd(point: THREE.Vector3, normal: THREE.Vector3, raycast: ModelRaycast): THREE.Vector3 | null;
+/**
+ * 识别「第二下点在刚打下的点上」的双击。
+ * 只记录上一次抬起的时间和屏幕位置；时间和位置都足够近才算双击，命中后清空，三连击不会触发两次。
+ */
+export declare class DoubleClickDetector {
+    private readonly interval;
+    private readonly maxMove;
+    private last;
+    constructor(interval?: number, maxMove?: number);
+    /** 每次单击抬起时调用；返回 true 表示与上一次构成双击 */
+    hit(x: number, y: number, time: number): boolean;
+    reset(): void;
+}
+/** 双击时第二下离起点的最大屏幕距离（像素）。起点可能被吸附偏离光标几像素，所以比双击判定宽一些 */
+export declare const START_POINT_HIT_RADIUS = 16;
+interface QuickMeasureCamera {
+    position: THREE.Vector3;
+}
+export interface QuickNormalMeasureOptions {
+    /** 当前相机；朝向判断和屏幕投影都用它 */
+    getCamera: () => THREE.Camera & QuickMeasureCamera;
+    /** five 画布，用来把世界坐标换算成屏幕坐标 */
+    getElement: () => HTMLElement | null | undefined;
+    /** 对模型做射线检测 */
+    raycast: ModelRaycast;
+    /** 正在测量的点；不在测量中返回 null */
+    getMeasuringPoints: () => THREE.Vector3[] | null;
+    /**
+     * 打到对面：用起点和终点生成测量。
+     * 返回 true 表示测量会话继续（控制器以终点作为下一段的起点），此时命中面的法线会留作下一段的起始法线。
+     */
+    finish: (start: THREE.Vector3, end: THREE.Vector3) => boolean | void;
+    /** 没打到：撤掉起点，回到未打点状态 */
+    cancelStart: () => void;
+}
+/** 由 PointSelector 的 wantsSelect 事件驱动，返回 false 表示取消这次选点 */
+type WantsSelectHandler = (intersection?: {
+    point?: THREE.Vector3;
+    face?: {
+        normal?: THREE.Vector3 | null;
+    } | null;
+} | null) => boolean | void;
+/**
+ * 双击快速测量（只处理鼠标，触屏不触发）。
+ *
+ * 规则与 MP 一致：
+ * - 第一下单击照常打下起点 A，不延迟；第二下在双击时间内又点在 A 上，就从 A 沿法线测到对面，直接完成这条测量；
+ * - A 已经打下一段时间后，再双击 A 也会快速测量：落在 A 上的单击不会再打一个重合的点；
+ * - 已经开始连线（两个点及以上）时双击按普通单击处理；法线没打到模型时撤掉 A，不生成测量；
+ * - 快速测量完成后不退出选点：控制器以命中点为新一段的起点（finish 返回 true），继续选择下一个点位。
+ */
+export declare class QuickNormalMeasure {
+    private readonly options;
+    private readonly detector;
+    private lastMouseUp;
+    /** 起点 A 所在平面的法线，在打下 A 的那次选点里记下 */
+    private startNormal;
+    private attached;
+    constructor(options: QuickNormalMeasureOptions);
+    attach(pointSelector: {
+        on: (name: 'wantsSelect', callback: WantsSelectHandler) => unknown;
+    }): void;
+    detach(pointSelector: {
+        off: (name: 'wantsSelect', callback: WantsSelectHandler) => unknown;
+    }): void;
+    reset(): void;
+    private onMouseUp;
+    private onWantsSelect;
+    /** 只认刚刚发生的鼠标抬起，用完即清，避免触屏选点误用上一次鼠标的位置 */
+    private consumeMouseUp;
+    private isOnStartPoint;
+    /** 面法线可能朝向表面内侧；射线要往相机这一侧（空的一侧）发 */
+    private orientTowardCamera;
+}
+export {};

package/dist/types/shared-utils/three/Magnifier.d.ts

@@ -18,11 +18,34 @@ interface MagnifierConfig {
 interface MagnifierEvent extends SubscribeEventMap {
     wantsPanGesture: (event: (typeof Hammer)['Input']) => boolean;
 }
+/** 自适应取景窗口参数 */
+export interface AdaptiveReadWindowOptions {
+    /** 放大镜内希望覆盖的世界宽度（米），默认 0.25 */
+    worldSize?: number;
+    /** 最大光学倍率（相对主视图），默认 8 */
+    maxZoom?: number;
+    /** 取景窗口允许的最小像素，避免倍率过高把贴图放大成色块，默认 24 */
+    minWindowPx?: number;
+    /** 窗口变化的平滑系数（0~1），越小越稳，默认 0.25 */
+    smoothing?: number;
+}
 /** 放大镜配置参数 */
 export interface MagnifierParameter extends Partial<MagnifierConfig> {
     width?: number;
     height?: number;
     scale?: number;
+    /**
+     * 读回像素的分辨率倍数（相对 CSS 像素）。
+     * 1 = 旧行为；2 = 按设备像素读回，retina 上不再被浏览器二次放大。
+     * 默认 1，只有显式传入才改变；读回失败会自动降级回 1。
+     */
+    readPixelsPixelRatio?: number;
+    /**
+     * 自适应取景窗口：按落点距离动态缩小取景区域，让放大镜里看到的物体大小
+     * 基本恒定，远点也能得到真正的光学放大。传 true 使用默认参数；
+     * 不传 / false 时保持旧的固定倍率行为。
+     */
+    adaptiveReadWindow?: boolean | AdaptiveReadWindowOptions;
 }
 /** 像素读回并绘制到放大镜 canvas 之后，供插件叠加 2D 内容使用的渲染信息 */
 export interface MagnifierRenderInfo {
@@ -53,8 +76,15 @@ export declare class Magnifier {
     state: {
         enabled: boolean;
     };
+    /** 读回像素的分辨率倍数；运行时可能因读回失败被降级为 1 */
+    readPixelsPixelRatio: number;
     /** 像素绘制完成后的回调（默认不设置，原行为不变） */
     afterRender?: (info: MagnifierRenderInfo) => void;
+    /** 每次读取像素前调整 five 场景；返回的函数在同步渲染提交后立即执行 */
+    beforeRender?: (renderCenter: THREE.Vector3 | {
+        x: number;
+        y: number;
+    }) => (() => void) | void;
     private five;
     private scale;
     private offset;
@@ -68,6 +98,12 @@ export declare class Magnifier {
     private pendingRender?;
     private renderRevision;
     private invalidatedRevision;
+    /** 自适应取景参数 */
+    private adaptiveReadWindow;
+    /** 平滑后的取景窗口（CSS 像素），0 表示还没初始化 */
+    private smoothedReadWindowPx;
+    /** 读回失败后关闭自适应，退回旧的固定窗口 */
+    private adaptiveDisabled;
     constructor(five: Five, options: MagnifierParameter);
     enable(): this;
     disable(): this;
@@ -86,10 +122,29 @@ export declare class Magnifier {
     resetOffset(): void;
     /** 更新放大镜的缩放比例 */
     updateScale(newScale: number): void;
+    /** 更新读回分辨率倍数；V2 用它按设备像素渲染，读回失败的机型会自动降级 */
+    setReadPixelsPixelRatio(ratio: number): void;
+    /** 是否让放大镜强制渲染模型（true）还是沿用主视图的全景 / 模型状态（false） */
+    setSkipPanorama(enabled: boolean): void;
+    /** 运行时开关自适应取景，用于对比新旧行为 */
+    setAdaptiveReadWindow(enabled: boolean | AdaptiveReadWindowOptions): void;
+    getReadPixelsPixelRatio(): number;
     /** 更新放大镜的尺寸 */
     updateSize(newWidth: number, newHeight?: number): void;
     render(): Promise<void>;
     private renderLatest;
+    /** 旧的固定窗口：始终取 width / scale 大小的屏幕区域，倍率恒为 scale */
+    private getBaseReadWindow;
+    private isAdaptiveActive;
+    /**
+     * 按落点距离计算本帧取景窗口：放大镜里始终覆盖固定大小的世界范围，
+     * 远点取景窗口更小、光学倍率更高，近点退化为旧的固定窗口。
+     */
+    private getReadWindow;
+    /** 由取景宽度反推读回倍率，让 canvas 的设备像素尺寸与旧版保持一致 */
+    private frameFromReadWidth;
+    /** 落点到相机的距离；屏幕坐标模式下无法计算，返回 undefined */
+    private getDistanceToCamera;
     private _appendTo;
     private autoFixPCPosition;
     private initStyle;

package/dist/utils.js

@@ -1,6 +1,6 @@
 import { t as e } from "./internal/transformPosition-Cc92Wf0o.js";
 import { t } from "./internal/Subscribe-DLlAl88n.js";
-import { c as n, g as r, r as i } from "./internal/PointHelper-grrf8vu1.js";
+import { c as n, g as r, r as i } from "./internal/PointHelper-G9EgUMWo.js";
 import { a, d as o, f as s, t as c } from "./internal/generatePolygonGeometry-DEr9kX3D.js";
 import { n as l } from "./internal/fiveModelLoad-BUIBYxzp.js";
 import { a as u, i as d, n as f, t as p } from "./internal/util-vGeVT4oo.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realsee/dnalogel",
-  "version": "4.0.0-webgpu.18",
+  "version": "4.0.0-webgpu.20",
   "author": "REALSEE-DEVELOPER",
   "repository": {
     "type": "git",

package/dist/internal/BasePluginWithData-CIQpqYGe.js

@@ -1,7 +0,0 @@
-import { t as e } from "./BasePlugin-Cr_atQUC.js";
-//#region src/base/BasePluginWithData.ts
-var t = class extends e {};
-//#endregion
-export { t };
-
-//# sourceMappingURL=BasePluginWithData-CIQpqYGe.js.map