iflow-engine-base 3.11.2 → 3.11.8

package/dist/index.d.ts

@@ -12,7 +12,6 @@ import { Path } from 'fabric';
 import { Rect } from 'fabric';
 import { Resource } from 'cesium';
 import * as THREE from 'three';
-import * as THREE_2 from '../../../three/three.module.js';
 import { Viewer } from 'cesium';
 
 declare class AngleMeasure2d extends BaseMeasureTool2d {
@@ -532,7 +531,15 @@ declare class CadCursorUI {
  */
 declare class Calibration {
     private readonly engine;
+    private static readonly svgNamespace;
+    private static readonly sourceColor;
+    private static readonly targetColor;
     private readonly matrices;
+    private pointCalibrationUrl;
+    private pointCalibrationPoints;
+    private behavior;
+    /** 供 handelBehaved 判断不同工具切换时释放当前鼠标监听。 */
+    readonly type = "point-calibration";
     constructor(engine: any);
     /**
      * 应用模型校准矩阵。
@@ -548,6 +555,33 @@ declare class Calibration {
      * source/target 均使用当前世界坐标；只修正平移和旋转，不引入缩放。
      */
     alignBySegments(options: SegmentCalibrationOptions): boolean;
+    /** 启动四点捕捉校准，后续鼠标点击由 handelBehaved 分发给 handleMouseClick。 */
+    startPointCalibration(options: PointCalibrationOptions): boolean;
+    /** 由 handelBehaved 的鼠标事件监听器回调，采集四个有效捕捉点。 */
+    handleMouseClick(event: any): void;
+    /**
+     * 保留空的鼠标移动回调以启用 handelBehaved 的实时捕捉计算，
+     * 并将已确认点和当前待确认点绘制到 SVG 覆盖层。
+     */
+    handleMouseMove(event: any): void;
+    /** Esc 取消当前四点采集。 */
+    handelKeyEscDown(): void;
+    /** 与测量工具一致：停用时只释放当前行为监听。 */
+    disActive(): void;
+    /** 完成或取消后恢复默认模型交互。 */
+    private finishPointCalibration;
+    /** 将四点校准的已选点与当前捕捉预览渲染成两种颜色的 SVG 点线。 */
+    private drawPointCalibrationOverlay;
+    /** 绘制一组已确认点、已确认线段和到当前捕捉点的虚线预览。 */
+    private drawCalibrationSegment;
+    /** 将世界坐标转换为 catchSvg 使用的屏幕坐标，忽略相机不可见点。 */
+    private toSvgPoint;
+    /** 向捕捉 SVG 追加线段。 */
+    private appendSvgLine;
+    /** 向捕捉 SVG 追加确认点或半透明的当前捕捉预览点。 */
+    private appendSvgPoint;
+    /** 清理四点校准留下的 SVG 覆盖元素。 */
+    private clearPointCalibrationOverlay;
     /**
      * 获取某个 url 当前的校准矩阵。
      */
@@ -564,7 +598,7 @@ declare class Calibration {
 
 declare type CalibrationMatrixInput = THREE.Matrix4 | number[] | ArrayLike<number> | number[][];
 
-declare interface CalibrationOptions {
+export declare interface CalibrationOptions {
     url: string;
     matrix: CalibrationMatrixInput;
 }
@@ -599,6 +633,7 @@ declare class CameraModule {
     private getStableCameraUp;
     private updateComposerCamera;
     private applySwitchedCamera;
+    private resolvePoseReferenceUp;
     private syncControlsAfterPoseRestore;
     private inferTargetFromRestoredCamera;
     switchCurrentCamera(): void;
@@ -1065,7 +1100,27 @@ declare class ComposerModule {
     constructor(engine: any);
     applyClippingToAmbientOcclusionPass(pass: any): void;
     syncAmbientOcclusionClipping(): void;
+    /**
+     * GTAO 会以 normalMaterial 覆盖场景材质来生成法线/深度图，
+     * 透明的剖切范围面也会因此被当作实体参与 AO。仅在该中间渲染阶段
+     * 隐藏剖切范围面与控制器辅助 Mesh，避免它们在模型交叠处制造伪阴影。
+     */
+    private excludeClippingHelpersFromGtao;
+    /** 判断对象或其父级是否已标记为不参与 AO 的剖切辅助对象。 */
+    private isAmbientOcclusionExcluded;
+    /**
+     * 同步 AO 中间渲染目标的深度纹理尺寸，避免 resize 后首次渲染触发 three.js 尺寸校验报错。
+     */
+    private syncRenderTargetDepthTexture;
+    /**
+     * 同步 GTAO/SSAO 内部 normalRenderTarget 的深度纹理尺寸。
+     */
+    private syncAmbientOcclusionDepthTextures;
     resize(width?: number, height?: number): void;
+    /**
+     * 统一从这里触发后处理渲染，确保每次实际 render 前深度纹理尺寸已同步。
+     */
+    render(): void;
     init(): void;
 }
 
@@ -1098,6 +1153,7 @@ declare class ControlModule {
     private handelBehaved;
     private pendingThirdPersonOptions;
     private prevContainerCursor;
+    private roamLookDirection;
     private isDragging;
     private isDown;
     private containerOffset;
@@ -1112,6 +1168,15 @@ declare class ControlModule {
     getApplyCollision(): any;
     setApplyGravity(value: boolean): void;
     getApplyGravity(): any;
+    /**
+     * 设置第一、第三人称漫游的视角拖拽方向；未传入的轴维持当前设置。
+     * @param direction horizontal/vertical 为 1 使用默认方向，-1 反向该轴。
+     */
+    setRoamLookDirection(direction: RoamLookDirection): void;
+    /** 获取当前漫游视角拖拽方向，返回副本以免外部修改内部配置。 */
+    getRoamLookDirection(): Required<RoamLookDirection>;
+    /** 将用户偏好同步给具体控制器，兼容控制器尚未创建的阶段。 */
+    private applyRoamLookDirection;
     toggleMinMap(): void;
     switchFirstPersonMode(): void;
     switchThirdPersonMode(options?: any): void;
@@ -1411,6 +1476,7 @@ declare class DrawingPin {
     private labelIds;
     private offLabelClick;
     private isPickingCapturePoint;
+    private viewModeControlSnapshot;
     constructor(engine: any);
     /**
      * 获取当前视点状态（相机 + 剖切 + 测量 + 批注）
@@ -1446,6 +1512,18 @@ declare class DrawingPin {
      * 清空批注（便捷接口）
      */
     clearAnnotation(): void;
+    /**
+     * 图钉 view 模式下锁定相机控制，避免用户在只读查看阶段继续旋转视图。
+     */
+    private enterViewModeCameraLock;
+    /**
+     * 退出图钉 view 模式时恢复进入前的相机控制状态。
+     */
+    private exitViewModeCameraLock;
+    /**
+     * 兼容旧图钉：历史数据未保存 Orbit origin 时，优先使用 capturePoint 补足旋转中心。
+     */
+    private buildRestoreCameraPose;
     private pickCapturePoint;
     private disableCameraControlsForPick;
     private restoreCameraControlsAfterPick;
@@ -2309,6 +2387,9 @@ declare class EngineKernelV2 {
     private _fpsLastSwitch;
     private _lowFpsCount;
     private _highFpsCount;
+    private readonly _idleFrameInterval;
+    private _lastIdleFrameTime;
+    private readonly _idleFrameRateExemptionReasons;
     private readonly _fpsCheckInterval;
     private readonly _fpsSwitchCooldown;
     private readonly _fpsThreshold;
@@ -2372,6 +2453,8 @@ declare class EngineKernelV2 {
     label: Label;
     annotation3d: Annotation3d;
     calibration: Calibration;
+    /** 管理第三方 GLB 的放置、编辑和场景还原。 */
+    modelPlace: ModelPlace;
     models: any[];
     reactBoundingClientRect: {
         left: number;
@@ -2381,10 +2464,15 @@ declare class EngineKernelV2 {
     private versionEl;
     private container;
     constructor(options: any);
-    changeHandelBehavedMode(): void;
+    changeHandelBehavedMode(mode: string): void;
+    getHandelBehavedMode(): string;
     updateVersionDisplay(): void;
     bindControlEvents(control: any): void;
     requestComposerRender(): void;
+    /**
+     * 为持续交互或动画登记空闲限帧豁免；同一原因可重复设置，多个原因会独立共存。
+     */
+    setIdleFrameRateExempt(reason: string, exempt: boolean): void;
     /**
      * 通过 viewToken 解析 3D 模型地址，再复用现有 loaderModule URL 加载逻辑。
      */
@@ -2397,6 +2485,10 @@ declare class EngineKernelV2 {
      * 通过源线段和目标线段对指定 url 的 3D 模型做平移和旋转校准。
      */
     alignCalibrationBySegments(options: SegmentCalibrationOptions): boolean;
+    /**
+     * 启动模型四点捕捉校准，依次选择源定位点、源方向点、目标定位点和目标方向点。
+     */
+    startPointCalibration(options: PointCalibrationOptions): boolean;
     updateLightPosition(camera: any, directionalLight: any, updataRotate?: boolean): void;
     /**
      * 自适应渲染降级：将渲染模式降低一级
@@ -2421,6 +2513,14 @@ declare class EngineKernelV2 {
     /**
      * 处理窗口大小变化
      */
+    /**
+     * 同步捕捉 SVG 的尺寸和 viewBox，避免窗口变化后出现偏移或裁切。
+     */
+    /**
+     * 统一读取容器当前真实可见尺寸，避免外部传入尺寸与最终显示尺寸不一致。
+     */
+    private getViewportSize;
+    private syncCatchSvgViewport;
     handleWindowResize(width?: number, height?: number): void;
     /**
      * 销毁引擎，释放资源,
@@ -2578,10 +2678,11 @@ declare interface EngineSettings {
 declare class EngineStatus {
     private engine;
     isFree: boolean;
-    editModel: boolean;
+    editorMode: string;
     isForceFree: boolean;
     isDisableContextMenu: boolean;
     disableModelInteractionHighlight: boolean;
+    suppressNextOrbitOriginPick: boolean;
     highlightModels: any[];
     hideModels: any[];
     translucentModels: any[];
@@ -2805,7 +2906,7 @@ declare class EventModuleGIS {
 /**
  * 事件类型枚举
  */
-declare enum EventType {
+export declare enum EventType {
     ModelLoadStart = "model-load-start",
     ModelLoadProgress = "model-load-progress",
     ModelLoaded = "model-loaded",
@@ -2814,6 +2915,7 @@ declare enum EventType {
     HoverChanged = "hover-changed",// data: { id: string | null, point: Vector3 }
     Click = "click",// data: MouseEventData
     MouseMove = "mouse-move",// data: MouseEventData - 鼠标移动事件
+    ModelPlaceSelected = "model-place-selected",
     CameraChanged = "camera-changed",// 相机移动时持续触发
     CameraIdle = "camera-idle",// 相机静止后触发
     ViewportResize = "viewport-resize",// 窗口大小变化
@@ -3065,6 +3167,7 @@ declare interface FabricDrawActionHandlers {
     onConfirm?: (data: Record<string, any>) => void;
     onCancel?: () => void;
     onPickPoint?: () => void;
+    onClose?: () => void;
 }
 
 declare type FabricDrawMode = 'view' | 'edit';
@@ -3659,9 +3762,11 @@ declare class HoverHighLight {
      */
     clearHighlight(): void;
     /**
-     * 每帧更新动画 — 由���擎 animate 循环调用
+     * 每帧更新动画 — 由引擎 animate 循环调用
      */
     update(): void;
+    /** 仅在悬浮高亮动画实际进行时解除空闲限帧。 */
+    private setAnimationFrameRateExempt;
     /** 从场景中移除所有覆盖层（不 dispose geometry，因为与原始 mesh 共享） */
     private removeOverlayMeshes;
     /** 缓出二次方 */
@@ -3698,6 +3803,21 @@ declare interface ICameraPose {
         y: number;
         z: number;
     };
+    origin?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    referenceUp?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    viewRight?: {
+        x: number;
+        y: number;
+        z: number;
+    };
     zoom?: number;
     orthographicHeight?: number;
 }
@@ -3814,6 +3934,9 @@ declare class InteractionModule {
     private keepHighlightedModels;
     private removeModelsFromHighlightState;
     private getNodeWorldBox;
+    /**
+     * 获取 hover 用的构件网格；普通构件的缓存 mesh 未挂场景，需补齐模型根组变换。
+     */
     private getNodeCatchMeshes;
     private createInstanceCatchMesh;
     private getInstanceWorldBox;
@@ -5357,6 +5480,136 @@ declare class ModelMapperBatch {
     getModelsWithMajor(major: string, callback: any): any[];
 }
 
+/** 管理独立于 BIM 主模型的第三方 GLB 摆放、编辑与场景持久化。 */
+declare class ModelPlace {
+    private readonly engine;
+    private readonly loader;
+    private readonly modelList;
+    private readonly modelTransforms;
+    private transformControl;
+    private transformHelper;
+    private selectedModelId;
+    private copiedModelData;
+    private editingEnabled;
+    private isRestoring;
+    private isUndoing;
+    private isPasting;
+    private readonly pendingModelIds;
+    private bimHighlightDisabledBeforeEditing;
+    private selectionPointerDown;
+    private readonly onPointerDown;
+    private readonly onPointerUp;
+    private readonly onKeyDown;
+    constructor(engine: any);
+    /** 释放控制柄、事件和已加载模型；引擎销毁时应调用。 */
+    dispose(): void;
+    /** 每帧同步相机切换后的控制柄相机与尺寸，避免透视模式仍按正交投影显示。 */
+    update(): void;
+    /**
+     * 加载 GLB 并放入场景。未指定 position 时，调用方需在开启捕捉的视图中单击确认落点。
+     */
+    placeModel(options: ModelPlaceOptions): Promise<SceneModelData>;
+    /** 以预览方式放置已准备好的模型数据；预览未确认前不会写入模型列表或历史。 */
+    private placePreparedModel;
+    /** 选中模型并显示指定模式的操作柄；未传模式时沿用移动模式。 */
+    editModel(modelId: string, mode?: ModelTransformMode): void;
+    /** 结束编辑并隐藏操作柄，不改变当前模型数据。 */
+    endEdit(): void;
+    /** 获取当前显示操作柄的模型 ID；没有选中模型时返回 null。 */
+    getSelectedModelId(): string | null;
+    /** 复制当前显示操作柄的模型配置，供 Ctrl/Command+V 或 pasteModel 使用。 */
+    copySelectedModel(): boolean;
+    /** 将已复制模型作为捕捉预览粘贴；确认落点后生成具有新 ID 的独立模型。 */
+    pasteModel(): Promise<SceneModelData | null>;
+    /** 按材质槽位或精确名称替换贴图；同名材质会一并替换并持久化。 */
+    replaceMaterial(modelId: string, materialTarget: number | string, textureUrl: string): Promise<void>;
+    /** 获取模型可替换的材质槽位和名称，供业务层按名称替换前查询。 */
+    getModelMaterials(modelId: string): Array<{
+        materialIndex: number;
+        materialName: string;
+    }>;
+    /** 删除模型及其场景对象。 */
+    deleteModel(modelId: string): void;
+    /** 清空场景中的全部第三方模型并释放资源；该操作可通过 undo 撤回。 */
+    clearModels(): void;
+    /** 隐藏指定模型，并保留它以支持后续显示和场景还原。 */
+    hideModel(modelId: string): void;
+    /** 显示当前管理器中的所有第三方模型。 */
+    showAllModels(): void;
+    /** 获取可 JSON 序列化的第三方模型场景状态。 */
+    getSceneModels(): SceneModelData[];
+    /** 清空现有第三方模型后，重新加载并恢复已导出的场景状态。 */
+    restoreSceneModels(sceneModels: SceneModelData[]): Promise<SceneModelData[]>;
+    /** 撤回最近一次会改变模型状态的操作。 */
+    undo(): Promise<boolean>;
+    private loadRecord;
+    /** 加载模型资源并创建记录，调用方可决定何时正式加入模型列表。 */
+    private createRecord;
+    /** 将已加载对象登记为正式模型，使其可被选中、导出和撤回。 */
+    private addRecord;
+    private applyTexture;
+    private ensureTransformControl;
+    /** 透视相机使用更小的屏幕尺寸系数，正交相机维持原有尺寸。 */
+    private syncTransformControlCamera;
+    /** 使用引擎统一的捕捉器等待用户单击，并在取消或完成后恢复常规交互。 */
+    private pickPlacementPoint;
+    /** 将捕捉点转换为最终放置点：沿世界法线外移 1mm，防止 GLB 与 BIM 面片重叠。 */
+    private getPlacementPoint;
+    private handlePointerDown;
+    /** 仅把未拖动的点击视为选中/取消选中，避免旋转视图时隐藏操作柄。 */
+    private handlePointerUp;
+    /** 处理第三方模型编辑快捷键：复制粘贴、删除、Tab 切换、Esc 和 Ctrl/Command+Z。 */
+    private handleKeyDown;
+    /** Ctrl+Z / Command+Z 仅在非文本输入焦点且存在历史时接管，避免影响表单编辑。 */
+    private isUndoShortcut;
+    /** Ctrl/Command+C 仅复制当前操作柄所属的第三方模型。 */
+    private isCopyShortcut;
+    /** Ctrl/Command+V 以捕捉预览方式粘贴，避免新旧模型直接重叠。 */
+    private isPasteShortcut;
+    /** Delete 键删除当前操作模型；文本输入焦点保留原生删除行为。 */
+    private isDeleteShortcut;
+    /** 判断是否正处于表单输入，避免劫持浏览器原生编辑快捷键。 */
+    private isTextInputTarget;
+    /** 仅在操作柄实际显示且非文本输入焦点时接管 Tab，避免破坏常规表单焦点导航。 */
+    private isTransformModeShortcut;
+    /** 按移动、旋转、缩放顺序循环切换；Shift+Tab 可反向切换。 */
+    private switchTransformMode;
+    /** 隐藏当前操作柄，但不关闭编辑模式。 */
+    private clearSelection;
+    /** 进入第三方模型编辑模式时，屏蔽 BIM 构件的悬浮和点击高亮，避免射线穿透。 */
+    private enableModelEditing;
+    /** 恢复进入编辑模式前的 BIM 构件交互高亮配置。 */
+    private disableModelEditing;
+    private syncSelectedTransform;
+    private saveHistory;
+    private requireRecord;
+    private getMaterials;
+    /** 将数值槽位或材质名称转换为实际材质索引；同名材质应保持同一替换结果。 */
+    private getMaterialIndices;
+    private normalizeData;
+    private cloneData;
+    private createId;
+    private removeObject;
+    private requestRender;
+}
+
+export declare interface ModelPlaceOptions {
+    id?: string;
+    url: string;
+    name?: string;
+    position?: THREE.Vector3Tuple;
+    rotation?: THREE.EulerTuple;
+    scale?: THREE.Vector3Tuple;
+    visible?: boolean;
+}
+
+/** 第三方 GLB 被选中后，通过 EventType.ModelPlaceSelected 发出的事件数据。 */
+export declare interface ModelPlaceSelectionEvent {
+    modelId: string;
+    data: SceneModelData;
+    object: THREE.Object3D;
+}
+
 declare class ModelProperties {
     private engine;
     extended‌: Map<string, any>;
@@ -5505,6 +5758,8 @@ declare class ModelToolModule2d {
     private isHoverableModel;
 }
 
+export declare type ModelTransformMode = 'translate' | 'rotate' | 'scale';
+
 declare class ModelTree {
     private engine;
     constructor(engine: any);
@@ -6092,6 +6347,11 @@ declare interface PerformanceStats {
     memoryUsage?: number;
 }
 
+/** 启动四点捕捉校准所需参数。 */
+export declare interface PointCalibrationOptions {
+    url: string;
+}
+
 /**
  * RangeScale - 范围缩放工具
  *
@@ -6238,10 +6498,10 @@ declare type RenderMode = 'simple' | 'balance' | 'advanced';
 
 declare class RenderModule {
     private engine;
-    renderer: THREE_2.WebGLRenderer | null;
+    renderer: THREE.WebGLRenderer | null;
     private watermark;
     constructor(engine: any);
-    createRenderer(): any;
+    createRenderer(): THREE.WebGLRenderer;
     disposeRenderer(): void;
     /**
      * 在最终渲染结果上追加 canvas 内嵌水印。
@@ -6466,6 +6726,23 @@ declare class RenderModuleGaussian {
  */
 export declare function resolveSdkAsset(path: string, moduleUrl?: string): string;
 
+/** 漫游视角拖拽方向：1 为默认方向，-1 为反向。 */
+export declare interface RoamLookDirection {
+    horizontal?: 1 | -1;
+    vertical?: 1 | -1;
+}
+
+export declare interface SceneModelData extends Required<Omit<ModelPlaceOptions, 'id'>> {
+    id: string;
+    materials: SceneModelMaterial[];
+}
+
+export declare interface SceneModelMaterial {
+    materialIndex: number;
+    materialName?: string;
+    mapUrl?: string;
+}
+
 declare class SceneModule {
     private engine;
     scene: THREE.Scene | null;
@@ -6751,7 +7028,7 @@ export declare interface SearchResult3d {
 
 export declare type SearchTheme3d = 'light' | 'dark';
 
-declare interface SegmentCalibrationOptions {
+export declare interface SegmentCalibrationOptions {
     url: string;
     source: CalibrationSegmentInput;
     target: CalibrationSegmentInput;

package/dist2d/dwg-preview.es.js

@@ -9188,7 +9188,7 @@ class to {
     this.unsubscribe(), this.el.remove();
   }
 }
-const ro = "3.11.2", io = {
+const ro = "3.11.3", io = {
   version: ro
 }, Mt = io.version;
 function hi() {