iflow-engine 1.3.2 → 1.3.4

package/README.md

@@ -70,16 +70,18 @@ onMounted(() => {
     bimEngine.initWalkControl();       // 漫游控制
     bimEngine.initMap();               // 地图
 
-    // 加载模型
-    bimEngine.engine?.loadModel({
-      url: '/path/to/your/model.ifc',
-      onProgress: (progress) => {
-        console.log(`加载进度: ${progress}%`);
-      },
-      onComplete: () => {
-        console.log('模型加载完成');
+    // 加载模型（EngineManager 对外公共 API）
+    bimEngine.engine?.loadModel(
+      ['/path/to/your/model.ifc'],
+      {
+        onProgress: (progress) => {
+          console.log(`加载进度: ${progress}%`);
+        },
+        onComplete: () => {
+          console.log('模型加载完成');
+        }
       }
-    });
+    );
   }
 });
 
@@ -179,6 +181,13 @@ BIM Engine SDK 采用 **管理器模式 (Manager Pattern)** 作为核心架构,
 - ✅ 简化集成复杂度
 - ✅ 支持按需加载
 
+> 架构更新（2026-03）
+>
+> - `EngineManager` 已从全量透传层收敛为“外部公共 API + 生命周期编排”
+> - 内部 Manager 统一通过 `BaseManager.engineComponent` 直接访问 `Engine` 组件
+> - 非 Manager 场景通过 `registry.engine3d?.getEngineComponent()?.xxx()` 访问引擎能力
+> - `Engine.getEngine()` 已移除，事件订阅使用 `onRawEvent()/offRawEvent()`
+
 ### 架构分层
 
 ```
@@ -193,7 +202,7 @@ BIM Engine SDK 采用 **管理器模式 (Manager Pattern)** 作为核心架构,
 │          Manager 层 (管理器)             │
 │  - ToolbarManager (工具栏)               │
 │  - DialogManager (对话框)                │
-│  - EngineManager (3D引擎)                │
+│  - EngineManager (外部公共API/生命周期)    │
 │  - MeasureDialogManager (测量)           │
 │  - SectionPlaneDialogManager (剖切)      │
 │  - WalkControlManager (漫游)             │
@@ -333,12 +342,14 @@ class BimEngine {
 每个管理器负责特定功能的生命周期管理:
 
 ```typescript
-// 3D 引擎管理器
-bimEngine.engine?.loadModel({
-  url: '/path/to/model.ifc',
-  onProgress: (progress) => console.log(progress),
-  onComplete: () => console.log('完成')
-});
+// 3D 引擎管理器（对外公共 API）
+bimEngine.engine?.loadModel(
+  ['/path/to/model.ifc'],
+  {
+    onProgress: (progress) => console.log(progress),
+    onComplete: () => console.log('完成')
+  }
+);
 
 // 测量工具管理器
 bimEngine.measure?.show();
@@ -509,6 +520,15 @@ npm run dev
 
 ## 📝 更新日志
 
+### v1.3.2 (2026-03-05)
+
+**架构优化**
+- ✨ EngineManager 瘦身：移除大规模 1:1 透传方法
+- ✨ 新增 `EngineManager.getEngineComponent()` 供内部访问
+- ✨ BaseManager 新增 `engineComponent` 便捷访问器
+- ✨ Manager 内部调用统一迁移为 `this.engineComponent?.xxx()`
+- ✨ 原始事件访问改为 `onRawEvent()/offRawEvent()`，移除 `getEngine()`
+
 ### v1.0.0 (2024-12-26)
 
 **核心功能**

package/dist/{engine/src/components → components}/button-group/index.d.ts

@@ -77,6 +77,12 @@ export declare class BimButtonGroup implements IBimComponent {
     private closeDropdown;
     private updateButtonState;
     private getIcon;
+    /**
+     * 更新指定按钮的图标
+     * @param id 按钮 ID
+     * @param icon 新的 SVG 图标字符串
+     */
+    updateButtonIcon(id: string, icon: string): void;
     updateButtonVisibility(id: string, visible: boolean): void;
     setShowLabel(show: boolean): void;
     private updateLabelsVisibility;

package/dist/components/button-group/toolbar/buttons/camera-switch/index.d.ts

@@ -0,0 +1,3 @@
+import { ButtonConfig } from '../../../index.type';
+import { ManagerRegistry } from '../../../../../core/manager-registry';
+export declare const createCameraSwitchButton: (registry: ManagerRegistry) => ButtonConfig;

package/dist/{engine/src/components → components}/engine/index.d.ts

@@ -77,9 +77,18 @@ export declare class Engine implements IBimComponent {
      */
     CameraGoHome(): void;
     /**
-     * 获取原始 3D 引擎实例
+     * 订阅原始引擎事件
+     * 用于需要访问底层引擎事件的场景（如测量回调、剖切移动等）
+     * @param event 事件名称
+     * @param handler 事件处理函数
      */
-    getEngine(): any;
+    onRawEvent(event: string, handler: (...args: any[]) => void): void;
+    /**
+     * 取消订阅原始引擎事件
+     * @param event 事件名称
+     * @param handler 事件处理函数
+     */
+    offRawEvent(event: string, handler: (...args: any[]) => void): void;
     /**
      * 暂停渲染
      */
@@ -252,6 +261,16 @@ export declare class Engine implements IBimComponent {
      * @remarks 对接底层 `engine.clipping.reverse()`
      */
     reverseSection(): void;
+    /**
+     * 切换相机类型（透视/正交）
+     * @remarks 底层调用 cameraModule.switchCurrentCamera()，保留当前相机位置
+     */
+    switchCamera(): void;
+    /**
+     * 获取当前相机类型
+     * @returns 'perspective' | 'orthographic'
+     */
+    getCameraType(): 'perspective' | 'orthographic';
     /**
      * 获取当前渲染模式
      * @returns 'simple' | 'balance' | 'advanced'
@@ -262,6 +281,71 @@ export declare class Engine implements IBimComponent {
      * @param mode 'simple'(性能模式) | 'balance'(平衡模式) | 'advanced'(效果模式)
      */
     setRenderMode(mode: 'simple' | 'balance' | 'advanced'): void;
+    /** 启用模型边线显示 */
+    activeModelEdge(): void;
+    /** 关闭模型边线显示 */
+    disActiveModelEdge(): void;
+    /** 获取边线显示状态 */
+    getModelEdgeActive(): boolean;
+    /**
+     * 设置环境光照强度
+     * @param intensity 0-100
+     */
+    setAmbientLightIntensity(intensity: number): void;
+    /** 获取当前环境光照强度 */
+    getAmbientLightIntensity(): number;
+    /**
+     * 设置场景对比度
+     * @param contrast 0-100
+     */
+    setSceneContrast(contrast: number): void;
+    /** 获取当前场景对比度 */
+    getSceneContrast(): number;
+    /**
+     * 设置场景饾和度
+     * @param saturation 0-100
+     */
+    setSceneSaturation(saturation: number): void;
+    /** 获取当前场景饾和度 */
+    getSceneSaturation(): number;
+    /** 获取 HDR 背景列表 */
+    getHDRBackgroundList(): {
+        name: string;
+        id: string;
+    }[];
+    /**
+     * 设置当前 HDR 背景
+     * @param id 背景 ID
+     */
+    setHDRBackgroundId(id: string): void;
+    /** 获取当前 HDR 背景 ID */
+    getHDRBackgroundId(): string;
+    /**
+     * 设置 HDR 背景可见性
+     * @param visible 是否可见
+     */
+    setHDRBackgroundVisibility(visible: boolean): void;
+    /** 获取 HDR 背景可见性 */
+    getHDRBackgroundVisibility(): boolean;
+    /** 获取地面列表 */
+    getGroundList(): {
+        name: string;
+        id: string;
+    }[];
+    /**
+     * 设置当前地面类型
+     * @param id 地面 ID
+     */
+    setGroundId(id: string): void;
+    /** 获取当前地面 ID */
+    getGroundId(): string;
+    /**
+     * 设置地面高度（单位：m）
+     * @param elevation 地面高度值
+     */
+    setGroundElevation(elevation: number): void;
+    /** 获取当前地面高度（单位：m） */
+    getGroundElevation(): number;
     /** 漫游模式是否激活 */
     private isWalkModeActive;
     /**

package/dist/{engine/src/core → core}/base-manager.d.ts

@@ -1,5 +1,6 @@
 import { ManagerRegistry } from './manager-registry';
 import { EngineEvents } from '../types/events';
+import { Engine } from '../components/engine';
 /**
  * Manager 抽象基类
  * - 通过构造函数接收 Registry 实例
@@ -11,6 +12,12 @@ export declare abstract class BaseManager {
     /** 事件订阅列表，用于自动清理 */
     private subscriptions;
     constructor(registry: ManagerRegistry);
+    /**
+     * 获取 Engine 组件实例的便捷访问器
+     * 内部管理器通过此 getter 直接访问 Engine 组件的全部能力
+     * 替代原来的 this.registry.engine3d?.xxx() 透传链
+     */
+    protected get engineComponent(): Engine | null;
     /**
      * 订阅事件（自动追踪，destroy 时自动取消）
      * @param event 事件名称