iflow-engine-base 2.0.2 → 2.0.4

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;
@@ -283,15 +295,27 @@ declare class EngineKernelV2 {
     grid: Grid;
     level: Level;
     text: Text_2;
+    hdr: Hdr;
+    ground: Ground;
     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;
     /**
      * 暂停渲染循环
      */
@@ -325,7 +349,9 @@ declare class EngineKernelV2 {
 declare class EngineModelModule {
     private engine;
     private currentMode;
+    private isManualMode;
     private gtaoPass;
+    private ssaoPass;
     private saturationPass;
     private outputPass;
     private fxaaPass;
@@ -335,7 +361,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;
@@ -347,7 +391,7 @@ declare class EngineModelModule {
      * 缓存 Pass 引用
      */
     private cachePassReferences;
-    private switchModel;
+    private applyMode;
     /**
      * 设置阴影开关
      */
@@ -356,6 +400,10 @@ declare class EngineModelModule {
      * 设置环境光遮蔽 (GTAO) 开关
      */
     private setGTAO;
+    /**
+     * 设置环境光遮蔽 (SSAO) 开关
+     */
+    private setSSAO;
     /**
      * 设置饱和度 Pass 开关
      */
@@ -377,9 +425,13 @@ declare class EngineModelModule {
      */
     setBalancedMode(): void;
     /**
-     * 设置效果模式
+     * 设置效果模式（SSAO）
      */
     setQualityMode(): void;
+    /**
+     * 设置超高级模式（GTAO，最高质量）
+     */
+    setSuperQualityMode(): void;
     /**
      * 设置阴影质量
      * @param quality - "low"(1024) | "medium"(2048) | "high"(4096)
@@ -535,6 +587,58 @@ declare interface GridAxisPoint {
     Z: number;
 }
 
+declare class Ground {
+    private engine;
+    private currentId;
+    private readonly groundGroup;
+    private groundMesh;
+    private waterMaterial;
+    private readonly clock;
+    private groundY;
+    private groundList;
+    constructor(engine: any);
+    init(): void;
+    /**
+     * 切换地面类型
+     * @param id  地面 id："0" 无 | "1" 草地 | "2" 混凝土 | "3" 地砖 | "4" 湖面 | "5" 海面
+     */
+    setGround(id: GroundId, config?: GroundConfig): void;
+    /**
+     * 设置地面高度（默认 0）
+     * @param y  世界空间 Y 坐标
+     */
+    setHeight(y: number): void;
+    /** 获取当前地面高度 */
+    getHeight(): number;
+    private _createWaterMaterial;
+    /** 每帧调用，驱动水面动画 */
+    update(): void;
+    /** 获取地面列表（id + 名称） */
+    getGroundList(): Array<{
+        id: string;
+        name: string;
+    }>;
+    /** 获取当前地面 id */
+    getCurrentId(): GroundId;
+    show(): void;
+    hide(): void;
+    dispose(): void;
+    private _dispose;
+}
+
+declare interface GroundConfig {
+    /** 地面尺寸（默认 300） */
+    size?: number;
+    /** 贴图 URL（仅实体地面有效） */
+    textureUrl?: string;
+    /** 阳光方向（默认斜上方） */
+    sunDirection?: THREE.Vector3;
+    /** 水面透明度（默认 0.82） */
+    opacity?: number;
+}
+
+declare type GroundId = "0" | "1" | "2" | "3" | "4" | "5";
+
 /**
  * 行为处理器 - 管理引擎的交互行为（鼠标、键盘事件等）
  * @param engine 引擎实例
@@ -542,6 +646,75 @@ declare interface GridAxisPoint {
  */
 declare function HandelBehaved(engine: any): any;
 
+declare class Hdr {
+    private engine;
+    private currentHdrId;
+    private isVisible;
+    private currentIntensity;
+    private currentTexture;
+    private skybox;
+    private readonly textureCache;
+    private readonly hdrList;
+    constructor(engine: any);
+    /**
+     * 获取 HDR 列表
+     */
+    getHdrList(): HdrItem[];
+    /**
+     * 切换 HDR 背景
+     * @param id - HDR id，"0" 表示清除 HDR
+     */
+    setHdr(id: string): Promise<void>;
+    /**
+     * 设置 HDR 天空球可见性（不影响环境光照）
+     * @param visible - true 显示，false 隐藏
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 获取当前 HDR id
+     */
+    getCurrentHdrId(): string;
+    /**
+     * 获取 HDR 背景是否可见
+     */
+    getVisible(): boolean;
+    /**
+     * 设置 HDR 整体亮度
+     * @param intensity - 亮度倍率，1 为原始亮度，推荐范围 0.1 ~ 3
+     */
+    setIntensity(intensity: number): void;
+    /**
+     * 获取当前 HDR 亮度
+     */
+    getIntensity(): number;
+    /**
+     * 动态添加自定义 HDR 条目（用于外部扩展）
+     */
+    addHdrItem(item: HdrItem): void;
+    /**
+     * 释放所有缓存纹理
+     */
+    dispose(): void;
+    private _loadHdr;
+    private _applyTexture;
+    /**
+     * 创建超大天空球，兼容正交/透视两种相机
+     * - radius 5000：远超任何场景对象，确保始终在背景层
+     * - BackSide：从内部观察球面
+     * - depthWrite false + renderOrder -1：不写入深度缓冲，始终渲染在最底层
+     * - frustumCulled false：防止大球被裁剪掉
+     */
+    private _createSkybox;
+    private _removeSkybox;
+    private _clearHdr;
+}
+
+declare interface HdrItem {
+    id: string;
+    name: string;
+    url?: string;
+}
+
 declare class HoverHighLight {
     private engine;
     private overlayMaterial;
@@ -846,8 +1019,6 @@ declare class ModelToolModule {
     private highlightMaterial;
     private hideMaterial;
     private translucentMaterial;
-    private cloneModels;
-    private clonetranslucentModels;
     constructor(engine_: any);
     split_merge_model(model: any): void;
     un_split_merge_model(model: any): void;

package/package.json

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