iflow-engine-base 2.0.1 → 2.0.3

package/dist/iflow-engine-base.css

@@ -1 +1 @@
-.originRotate{width:10px;height:10px;background-color:red}.versionText{position:absolute;right:10px;color:#86d9ff;z-index:1000;bottom:10px;background:transparent;pointer-events:none}.originDiv{position:absolute;top:100px;left:100px;width:30px;height:30px;border-radius:50%;z-index:1000;pointer-events:none}.catchPoint{pointer-events:none;stroke:#08dfd7;fill:transparent;stroke-width:2}.catchLine{position:absolute;width:10px;height:10px;pointer-events:none;background-color:green}.catchPlane{position:absolute;width:10px;height:10px;pointer-events:none;background-color:#ff0}.ViewCube{position:absolute;width:120px;height:120px;top:0;right:0;z-index:999}.homeViewWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-image:url(/assets/viewcube/home.png);background-size:100% 100%;background-repeat:no-repeat;background-color:#fff0;color:#fff;top:10px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.viewSettingWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-size:100% 100%;background-repeat:no-repeat;font-weight:800;background-color:#fff0;color:#fff;top:30px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:70px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper.show{display:flex}.cameraToggleWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.screenshotWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:20px;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:120px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.screenshotWrapper.show{display:flex}.screenshotWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.fullscreenWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:170px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.fullscreenWrapper.show{display:flex}.fullscreenWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.measure-elevation{position:absolute;pointer-events:none}.measureSvg{position:absolute;width:1920px;height:1080px}.catch-point{position:absolute;width:10px;height:10px;background-color:red;border-radius:50%;pointer-events:none}.annotation-container{position:absolute;pointer-events:none;top:0;left:0}.measureLine{position:absolute;pointer-events:none}.measureBack{cursor:pointer;pointer-events:auto;fill:orange;top:-50px;rx:5;ry:5}.measureLabel{position:absolute;fill:#fff;font-size:14px;font-family:Arial,sans-serif;pointer-events:none}.measurePointer{fill:orange}.Hight{stroke:#fff;stroke-width:2}.allow-select{pointer-events:auto}.disallow-select{pointer-events:none}.angle-annotation{position:absolute;pointer-events:auto}
+.originRotate{width:10px;height:10px;background-color:red}.versionText{position:absolute;right:10px;color:#86d9ff;z-index:1000;bottom:0;font-size:10px;background:transparent;pointer-events:none}.originDiv{position:absolute;top:100px;left:100px;width:30px;height:30px;border-radius:50%;z-index:1000;pointer-events:none}.catchPoint{pointer-events:none;stroke:#08dfd7;fill:transparent;stroke-width:2}.catchLine{position:absolute;width:10px;height:10px;pointer-events:none;background-color:green}.catchPlane{position:absolute;width:10px;height:10px;pointer-events:none;background-color:#ff0}.ViewCube{position:absolute;width:120px;height:120px;top:0;right:0;z-index:999}.homeViewWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-image:url(/assets/viewcube/home.png);background-size:100% 100%;background-repeat:no-repeat;background-color:#fff0;color:#fff;top:10px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.viewSettingWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-size:100% 100%;background-repeat:no-repeat;font-weight:800;background-color:#fff0;color:#fff;top:30px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:70px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper.show{display:flex}.cameraToggleWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.screenshotWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:20px;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:120px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.screenshotWrapper.show{display:flex}.screenshotWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.fullscreenWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:170px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.fullscreenWrapper.show{display:flex}.fullscreenWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.measure-elevation{position:absolute;pointer-events:none}.measureSvg{position:absolute;width:1920px;height:1080px}.catch-point{position:absolute;width:10px;height:10px;background-color:red;border-radius:50%;pointer-events:none}.annotation-container{position:absolute;pointer-events:none;top:0;left:0}.measureLine{position:absolute;pointer-events:none}.measureBack{cursor:pointer;pointer-events:auto;fill:orange;top:-50px;rx:5;ry:5}.measureLabel{position:absolute;fill:#fff;font-size:14px;font-family:Arial,sans-serif;pointer-events:none}.measurePointer{fill:orange}.Hight{stroke:#fff;stroke-width:2}.allow-select{pointer-events:auto}.disallow-select{pointer-events:none}.angle-annotation{position:absolute;pointer-events:auto}

package/dist/index.d.ts

@@ -143,6 +143,7 @@ declare class ComposerModule {
     private engine;
     composer: any;
     private saturationPass;
+    private ssaoPass;
     constructor(engine: any);
     resize(width?: number, height?: number): void;
     init(): void;
@@ -242,6 +243,17 @@ declare class EngineKernelV2 {
     private controlsEnabledBeforePause;
     private animate;
     private onWindowResize;
+    private _fpsFrameCount;
+    private _fpsLastCheck;
+    private _fpsLastSwitch;
+    private _lowFpsCount;
+    private _highFpsCount;
+    private readonly _fpsCheckInterval;
+    private readonly _fpsSwitchCooldown;
+    private readonly _fpsThreshold;
+    private readonly _fpsUpgradeThreshold;
+    private readonly _lowFpsRequired;
+    private readonly _highFpsRequired;
     isMouseDown: boolean;
     isWheeling: boolean;
     scene: THREE.Scene | null;
@@ -279,15 +291,29 @@ declare class EngineKernelV2 {
     ai: AI;
     pathRoaming: PathRoaming;
     hoverHighLight: HoverHighLight;
+    minMap: MiniMap;
+    grid: Grid;
+    level: Level;
+    text: Text_2;
     models: any[];
     reactBoundingClientRect: {
         left: number;
         top: number;
     };
     version: string;
+    private versionEl;
     private container;
     constructor(options: any);
+    updateVersionDisplay(): void;
     updateLightPosition(camera: any, directionalLight: any): void;
+    /**
+     * 自适应渲染降级：将渲染模式降低一级
+     */
+    private _adaptiveRenderingDowngrade;
+    /**
+     * 自适应渲染升级：将渲染模式提升一级
+     */
+    private _adaptiveRenderingUpgrade;
     /**
      * 暂停渲染循环
      */
@@ -321,7 +347,9 @@ declare class EngineKernelV2 {
 declare class EngineModelModule {
     private engine;
     private currentMode;
+    private isManualMode;
     private gtaoPass;
+    private ssaoPass;
     private saturationPass;
     private outputPass;
     private fxaaPass;
@@ -331,7 +359,25 @@ declare class EngineModelModule {
      */
     init(): void;
     /**
-     * 设置模式（公共接口，供 engine 调用）
+     * 手动切换渲染模式（用户调用），锁定自动适配
+     * @param model - "simple"(性能) | "balance"(平衡) | "advanced"(效果)
+     */
+    switchModel(model: string): void;
+    /**
+     * 自动切换渲染模式（引擎内部调用），若已手动设置则跳过
+     * @param model - "simple"(性能) | "balance"(平衡) | "advanced"(效果)
+     */
+    autoSwitch(model: string): void;
+    /**
+     * 恢复自动适配模式（解除手动锁定）
+     */
+    enableAutoMode(): void;
+    /**
+     * 是否处于手动锁定模式
+     */
+    get isManual(): boolean;
+    /**
+     * 设置模式（内部初始化使用，不影响手动锁定状态）
      * @param model - "simple"(性能) | "balance"(平衡) | "advanced"(效果)
      */
     setMode(model: string): void;
@@ -343,7 +389,7 @@ declare class EngineModelModule {
      * 缓存 Pass 引用
      */
     private cachePassReferences;
-    private switchModel;
+    private applyMode;
     /**
      * 设置阴影开关
      */
@@ -352,6 +398,10 @@ declare class EngineModelModule {
      * 设置环境光遮蔽 (GTAO) 开关
      */
     private setGTAO;
+    /**
+     * 设置环境光遮蔽 (SSAO) 开关
+     */
+    private setSSAO;
     /**
      * 设置饱和度 Pass 开关
      */
@@ -373,9 +423,13 @@ declare class EngineModelModule {
      */
     setBalancedMode(): void;
     /**
-     * 设置效果模式
+     * 设置效果模式（SSAO）
      */
     setQualityMode(): void;
+    /**
+     * 设置超高级模式（GTAO，最高质量）
+     */
+    setSuperQualityMode(): void;
     /**
      * 设置阴影质量
      * @param quality - "low"(1024) | "medium"(2048) | "high"(4096)
@@ -479,6 +533,58 @@ declare enum EventType {
     SectionMove = "section-move"
 }
 
+declare class Grid {
+    private readonly engine;
+    private rootGroup;
+    private isVisible;
+    private axes;
+    /**
+     * 坐标转换：BIM(X,Y,Z) → Three.js 世界坐标
+     * 默认规则：BIM X=水平, Y=水平深度, Z=高度
+     *         → Three.js X=水平, Y=高度, Z=-深度
+     * 可在外部替换此函数以适配不同坐标系。
+     */
+    coordinateMapper: (p: GridAxisPoint) => THREE.Vector3;
+    constructor(engine: any);
+    /** 传入轴网数据并在场景中构建对象 */
+    setData(data: GridAxisData[]): void;
+    /** 使用内置模拟数据（调试用） */
+    setMockData(): void;
+    /** 显示轴网 */
+    show(): void;
+    /** 隐藏轴网 */
+    hide(): void;
+    /** 切换显示/隐藏 */
+    toggle(): void;
+    /**
+     * 每帧更新（在动画循环中调用）
+     * 根据正交相机缩放动态调整圆圈大小，保持屏幕上视觉尺寸恒定（约 30px）
+     */
+    update(): void;
+    /** 销毁，释放 Three.js 资源 */
+    dispose(): void;
+    private _initRoot;
+    private _clearAxes;
+    private _buildAxis;
+    /**
+     * 创建带文字的圆圈 Sprite
+     * Sprite 默认朝向相机（billboard），depthTest=false 保证始终可见
+     */
+    private _makeCircleSprite;
+}
+
+declare interface GridAxisData {
+    Id: string;
+    Name: string;
+    Points: [GridAxisPoint, GridAxisPoint];
+}
+
+declare interface GridAxisPoint {
+    X: number;
+    Y: number;
+    Z: number;
+}
+
 /**
  * 行为处理器 - 管理引擎的交互行为（鼠标、键盘事件等）
  * @param engine 引擎实例
@@ -588,6 +694,45 @@ declare interface IRoamingPoint extends ICameraPose {
     stayTime?: number;
 }
 
+declare class Level {
+    private engine;
+    private isVisible;
+    private levels;
+    private svgContainer;
+    private svgOverlay;
+    private worldToScreen;
+    halfSize: number;
+    private readonly COLOR;
+    private readonly PLANE_OPACITY;
+    constructor(engine: any);
+    private _initSvg;
+    /** 传入标高数据并渲染 */
+    setData(data: LevelData[]): void;
+    /** 使用内置模拟数据（调试用） */
+    setMockData(): void;
+    /** 显示标高 */
+    show(): void;
+    /** 隐藏标高 */
+    hide(): void;
+    /** 切换显示/隐藏 */
+    toggle(): void;
+    /** 每帧刷新（需在动画循环中调用） */
+    update(): void;
+    /** 销毁，释放资源 */
+    dispose(): void;
+    private _initWorldToScreen;
+    private _clearAll;
+    private _buildThreeObject;
+    private _updateSvgLabels;
+    private _makeLabel;
+}
+
+declare interface LevelData {
+    Id: string;
+    Name: string;
+    Elevation: number;
+}
+
 declare class LightModule {
     private engine;
     constructor(engine: any);
@@ -653,6 +798,61 @@ declare interface Message {
     content: string;
 }
 
+declare class MiniMap {
+    private engine;
+    private miniMapCamera;
+    private miniMapRenderer;
+    private miniMapContainer;
+    private overlayCanvas;
+    private overlayCtx;
+    private isVisible;
+    private readonly mapSize;
+    private currentHalfSize;
+    private readonly minHalfSize;
+    private readonly maxHalfSize;
+    private halfSizeInitialized;
+    private camY;
+    private centerX;
+    private centerZ;
+    private dragMode;
+    private lastMouseX;
+    private lastMouseY;
+    constructor(engine: any);
+    getstate(): boolean;
+    private init;
+    /**
+     * 世界坐标 XZ → 小地图像素坐标
+     * 小地图 up=(0,0,-1)：-Z 朝屏幕上方，+X 朝屏幕右方
+     */
+    private worldToPixel;
+    /** 小地图像素坐标 → 世界坐标 XZ */
+    private pixelToWorld;
+    private setupEvents;
+    /** 滚轮缩放小地图视野 */
+    private readonly onWheel;
+    /**
+     * 点击指示器（中心 25px 范围）→ 进入旋转拖拽模式
+     * 点击其他位置 → 计算世界坐标，直接将相机传送过去
+     */
+    private readonly onMouseDown;
+    private readonly onMouseMove;
+    private readonly onMouseUp;
+    /**
+     * 传送：点击小地图空白区域 → 计算世界坐标，将相机和 target 平移过去
+     */
+    private handleTeleport;
+    /**
+     * 旋转：拖动指示器尖端 → 绕 controls.target 旋转主相机水平轨道角
+     */
+    private handleRotate;
+    private drawOverlay;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    update(): void;
+    dispose(): void;
+}
+
 declare class ModelEdge {
     private engine;
     private isActive;
@@ -1061,6 +1261,12 @@ declare interface Step {
     apiModules: string[];
 }
 
+declare class Text_2 {
+    private engine;
+    constructor(engine: any);
+    update(): void;
+}
+
 declare class ViewCube {
     private engine;
     cubeTool: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine-base",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "BIM Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/bim-engine-sdk.umd.js",
   "module": "./dist/bim-engine-sdk.es.js",