iflow-engine 1.3.2 → 1.3.4

package/dist/{engine/src/locales → locales}/types.d.ts

@@ -28,6 +28,7 @@ export interface TranslationDictionary {
         sectionPlane: string;
         sectionAxis: string;
         sectionBox: string;
+        cameraSwitch: string;
     };
     panel: {
         property: {
@@ -248,17 +249,6 @@ export interface TranslationDictionary {
         };
         /** 边线 */
         edgeLine: string;
-        /** 显示地面 */
-        ground: string;
-        groundSize: string;
-        groundTypes: {
-            none: string;
-            concrete: string;
-            grass: string;
-            tile: string;
-            water: string;
-            wood: string;
-        };
         /** 对比度 */
         contrast: string;
         /** 饱和度 */
@@ -267,14 +257,14 @@ export interface TranslationDictionary {
         lightIntensity: string;
         /** 环境背景 */
         environment: string;
-        environments: {
-            default: string;
-            outdoor: string;
-            indoor: string;
-            night: string;
-            overcast: string;
-            studio: string;
-        };
+        /** 显示背景 */
+        backgroundVisible: string;
+        /** 显示地面 */
+        ground: string;
+        /** 地面高度 */
+        groundElevation: string;
+        /** 地面高度单位 */
+        groundElevationUnit: string;
     };
 }
 /**

package/dist/managers/engine-manager.d.ts

@@ -0,0 +1,46 @@
+import { Engine, EngineOptions, ModelLoadOptions } from '../components/engine';
+import { BaseManager } from '../core/base-manager';
+import { RightKeyManager } from './right-key-manager';
+import { ManagerRegistry } from '../core/manager-registry';
+/**
+ * 3D 引擎管理器
+ * 封装底层 3D 引擎，提供模型加载、渲染控制等公共 API
+ */
+export declare class EngineManager extends BaseManager {
+    /** 容器元素 */
+    private container;
+    /** 引擎组件实例 */
+    private engineInstance;
+    /** 右键菜单管理器 */
+    rightKey: RightKeyManager | null;
+    constructor(container: HTMLElement, registry: ManagerRegistry);
+    /**
+     * 获取 Engine 组件实例
+     * 内部管理器通过此方法直接访问 Engine 组件的全部能力
+     * @returns Engine 组件实例，未初始化时返回 null
+     */
+    getEngineComponent(): Engine | null;
+    /**
+     * 初始化 3D 引擎
+     * @param options 引擎配置选项
+     * @returns 是否初始化成功
+     */
+    initialize(options?: Omit<EngineOptions, 'container'>): boolean;
+    /**
+     * 检查引擎是否已初始化
+     * @returns 是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 加载模型
+     * @param urls 模型 URL 数组
+     * @param options 加载选项
+     */
+    loadModel(urls: string[], options?: ModelLoadOptions): void;
+    /** 暂停渲染 */
+    pauseRendering(): void;
+    /** 恢复渲染 */
+    resumeRendering(): void;
+    /** 销毁引擎管理器 */
+    destroy(): void;
+}

package/dist/{engine/src/managers → managers}/setting-dialog-manager.d.ts

@@ -2,7 +2,7 @@ import { BaseDialogManager } from '../core/base-dialog-manager';
 import { ManagerRegistry } from '../core/manager-registry';
 /**
  * 设置弹窗管理器
- * 管理全局设置面板，包含渲染模式、边线、地面、对比度/饱和度、光照强度、环境背景等设置项
+ * 管理全局设置面板，包含渲染模式、边线、光照/对比度/饱和度、环境背景、地面等设置项
  */
 export declare class SettingDialogManager extends BaseDialogManager {
     protected get dialogId(): string;
@@ -10,25 +10,38 @@ export declare class SettingDialogManager extends BaseDialogManager {
     protected get dialogWidth(): number;
     /** 边线开关状态 */
     private edgeLineEnabled;
-    /** 当前选中的地面类型 */
-    private groundType;
-    /** 地面大小 */
-    private groundSize;
-    /** 对比度（0-200，100为默认值） */
+    /** 对比度（0-100，50为默认值） */
     private contrastValue;
-    /** 饱和度（0-200，100为默认值） */
+    /** 饱和度（0-100，50为默认值） */
     private saturationValue;
-    /** 光照强度（0-200，100为默认值） */
+    /** 光照强度（0-100，50为默认值） */
     private lightIntensityValue;
-    /** 当前选中的环境背景 */
-    private environmentType;
+    /** 环境背景列表（从底层引擎动态获取） */
+    private environmentList;
+    /** 当前选中的环境背景 ID */
+    private environmentId;
+    /** 是否显示背景 */
+    private backgroundVisible;
+    /** 地面列表（从底层引擎动态获取） */
+    private groundList;
+    /** 当前选中的地面 ID */
+    private groundId;
+    /** 地面高度（单位：m） */
+    private groundElevation;
+    /** 保存的对话框位置（用于 hide/show 时保持位置不变） */
+    private savedPosition;
     constructor(registry: ManagerRegistry);
     init(): void;
-    /** 对话框居中显示 */
+    /** 对话框位置：若有保存的位置则恢复，否则居中 */
     protected getDialogPosition(): {
         x: number;
         y: number;
     };
+    /**
+     * 从底层引擎加载当前状态（回显）
+     * 在 createContent() 前调用，保证 UI 和引擎状态同步
+     */
+    private loadEngineState;
     protected createContent(): HTMLElement;
     /** 创建分隔线 */
     private createDivider;
@@ -50,7 +63,7 @@ export declare class SettingDialogManager extends BaseDialogManager {
      * 使用 ::-webkit-slider-thumb / ::-moz-range-thumb 伪元素
      */
     private ensureSliderStyle;
-    /** 创建环境背景下拉选择区 */
+    /** 创建环境背景区 */
     private createEnvironmentSection;
     /** 创建地面设置区 */
     private createGroundSection;
@@ -61,4 +74,11 @@ export declare class SettingDialogManager extends BaseDialogManager {
      * @param onChange 选中变化回调
      */
     private createSelect;
+    /**
+     * 创建一个标签 + 开关的行
+     * @param labelText 标签文本
+     * @param enabled 当前开关状态
+     * @param onChange 状态变化回调
+     */
+    private createToggleRow;
 }

package/dist/{engine/src/managers → managers}/toolbar-manager.d.ts

@@ -53,6 +53,12 @@ export declare class ToolbarManager extends BaseManager {
      * @param active 是否激活
      */
     setBtnActive(id: string, active?: boolean): void;
+    /**
+     * 更新按钮图标
+     * @param id 按钮 ID
+     * @param icon 新的 SVG 图标字符串
+     */
+    updateButtonIcon(id: string, icon: string): void;
     /**
      * 设置工具栏可见性
      * @param visible 是否可见

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "iFlow Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/iflow-engine.umd.js",
   "module": "./dist/iflow-engine.es.js",
@@ -59,7 +59,7 @@
     "vite-plugin-dts": "^4.5.4"
   },
   "dependencies": {
-    "iflow-engine-base": "^2.0.4",
+    "iflow-engine-base": "^2.1.1",
     "three": "^0.182.0"
   }
-}
+}

package/dist/engine/src/managers/engine-manager.d.ts

@@ -1,268 +0,0 @@
-import { EngineOptions, ModelLoadOptions, EngineInfo } from '../components/engine';
-import { BaseManager } from '../core/base-manager';
-import { RightKeyManager } from './right-key-manager';
-import { MeasureMode, ClearHeightDirection, ClearHeightSelectType } from '../types/measure';
-import { MeasureUnit, MeasurePrecision } from '../components/measure-panel/types';
-import { SectionBoxRange } from '../components/section-box-panel/types';
-import { ManagerRegistry } from '../core/manager-registry';
-/**
- * 3D 引擎管理器
- * 封装底层 3D 引擎，提供模型加载、相机控制、测量等功能
- */
-export declare class EngineManager extends BaseManager {
-    /** 容器元素 */
-    private container;
-    /** 引擎实例 */
-    private engineInstance;
-    /** 右键菜单管理器 */
-    rightKey: RightKeyManager | null;
-    constructor(container: HTMLElement, registry: ManagerRegistry);
-    /**
-     * 初始化 3D 引擎
-     * @param options 引擎配置选项
-     * @returns 是否初始化成功
-     */
-    initialize(options?: Omit<EngineOptions, 'container'>): boolean;
-    /**
-     * 检查引擎是否已初始化
-     * @returns 是否已初始化
-     */
-    isInitialized(): boolean;
-    /**
-     * 加载模型
-     * @param urls 模型 URL 数组
-     * @param options 加载选项
-     */
-    loadModel(urls: string[], options?: ModelLoadOptions): void;
-    /**
-     * 获取底层引擎实例
-     * @returns 引擎实例
-     */
-    getEngine(): any;
-    /** 相机回到初始位置 */
-    CameraGoHome(): void;
-    /** 暂停渲染 */
-    pauseRendering(): void;
-    /** 恢复渲染 */
-    resumeRendering(): void;
-    /**
-     * 激活测量模式
-     * @param mode 测量模式
-     */
-    activateMeasure(mode: MeasureMode): void;
-    /** 停用测量模式 */
-    deactivateMeasure(): void;
-    /**
-     * 获取当前测量类型
-     * @returns 当前测量模式
-     */
-    getCurrentMeasureType(): MeasureMode | null;
-    clearAllMeasures(): void;
-    saveMeasureSetting(setting: {
-        unit: MeasureUnit;
-        precision: MeasurePrecision;
-    }): void;
-    /**
-     * 设置净高测量朝向
-     * @param direction 0=朝下，1=朝上
-     */
-    setClearHeightDirection(direction: ClearHeightDirection): void;
-    /**
-     * 设置净高测量选择对象类型
-     * @param selectType 'point'=选择点，'element'=选择构件
-     */
-    setClearHeightSelectType(selectType: ClearHeightSelectType): void;
-    activeSection(mode: 'x' | 'y' | 'z' | 'box' | 'face'): void;
-    /**
-     * 获取当前激活的剖切模式
-     * @returns 当前剖切模式，未激活时返回 null
-     */
-    getCurrentSectionMode(): 'x' | 'y' | 'z' | 'box' | 'face' | null;
-    /**
-     * 停用所有剖切功能
-     * @remarks 关闭剖切对话框时调用
-     */
-    deactivateSection(): void;
-    /**
-     * 设置剖切盒范围
-     * @param range 各轴的剖切范围 (百分比 0-100)
-     * @remarks 仅在 'box' 模式下有效
-     */
-    setSectionBoxRange(range: SectionBoxRange): void;
-    /**
-     * 隐藏剖切面（临时隐藏，可恢复）
-     * @remarks 配合 recoverSection() 使用
-     */
-    hideSection(): void;
-    /**
-     * 恢复剖切面（从隐藏状态恢复）
-     * @remarks 恢复被 hideSection() 隐藏的剖切面
-     */
-    recoverSection(): void;
-    fitSectionBoxToModel(): void;
-    /**
-     * 剖切盒适应（缩放到场景整体包围盒）
-     * @remarks 对接底层 clipping.scaleBox()
-     */
-    scaleSectionBox(): void;
-    /**
-     * 反向剖切
-     * @remarks 对接底层 clipping.reverse()
-     */
-    reverseSection(): void;
-    /** 激活框选放大功能 */
-    activateZoomBox(): void;
-    /** 激活第一人称漫游模式 */
-    activateFirstPersonMode(): void;
-    /** 停用第一人称漫游模式 */
-    deactivateFirstPersonMode(): void;
-    setWalkSpeed(speed: number): void;
-    setWalkGravity(enabled: boolean): void;
-    setWalkCollision(enabled: boolean): void;
-    toggleMiniMap(): void;
-    /**
-     * 获取小地图显示状态
-     * @returns true=显示，false=隐藏
-     */
-    getMiniMapState(): boolean;
-    isFirstPersonModeActive(): boolean;
-    /**
-     * 获取当前选中的构件
-     * @returns 选中构件的 URL 和 ID，未选中时返回 null
-     */
-    getSelectedComponent(): {
-        url: string;
-        id: string;
-    } | null;
-    /**
-     * 获取构件属性
-     * @param url 模型 URL
-     * @param id 构件 ID
-     * @param callback 回调函数，接收属性数据
-     */
-    getComponentProperties(url: string, id: string, callback: (data: any) => void): void;
-    getTypeTreeData(): any[];
-    getLevelTreeData(): any[];
-    getMajorTreeData(): any[];
-    getEngineInfo(): EngineInfo | null;
-    /**
-     * 添加漫游点
-     * 将当前相机位置添加为一个漫游点
-     */
-    pathRoamingAddPoint(): void;
-    /**
-     * 删除指定索引的漫游点
-     * @param index 要删除的漫游点索引
-     */
-    pathRoamingRemovePoint(index: number): void;
-    /**
-     * 清除所有漫游点
-     */
-    pathRoamingClearPoints(): void;
-    /**
-     * 获取所有漫游点
-     * @returns 漫游点数组
-     */
-    pathRoamingGetPoints(): any[];
-    /**
-     * 跳转到指定漫游点
-     * @param index 目标漫游点索引
-     */
-    pathRoamingJumpToPoint(index: number): void;
-    /**
-     * 播放漫游
-     * @param options 播放选项，包含时长、循环、回调等配置
-     */
-    pathRoamingPlay(options?: {
-        duration?: number;
-        loop?: boolean;
-        onComplete?: () => void;
-        onPointComplete?: (pointIndex: number) => void;
-    }): void;
-    /**
-     * 停止漫游
-     */
-    pathRoamingStop(): void;
-    /**
-     * 获取当前高亮(选中)的模型
-     * @returns 高亮模型对象,未选中时返回 null
-     */
-    getHighlightModels(): any;
-    /**
-     * 高亮指定模型构件
-     *
-     * @param models - 要高亮的模型数组，格式: [{ url: string, ids: string[] }]
-     *
-     * @example
-     * manager.highlightModel([
-     *   { url: 'https://xxx/models/xxx/', ids: [350518, 350520] }
-     * ]);
-     */
-    highlightModel(models: {
-        url: string;
-        ids: number[];
-    }[]): void;
-    unhighlightAllModels(): void;
-    viewScaleToModel(models: {
-        url: string;
-        ids: number[];
-    }[]): void;
-    hideModels(models: {
-        url: string;
-        ids: number[];
-    }[]): void;
-    showModel(models: {
-        url: string;
-        ids: number[];
-    }[]): void;
-    /**
-     * 半透明指定模型
-     * @param models 要半透明的模型对象
-     */
-    translucentModels(models: any): void;
-    /**
-     * 取消半透明
-     */
-    unTranslucentModel(): void;
-    /**
-     * 隔离指定模型（隐藏其他）
-     * @param models 要隔离的模型对象
-     */
-    isolateModels(models: any): void;
-    /**
-     * 半透明其他构件
-     * @param models 基准模型对象
-     */
-    translucentOtherModels(models: any): void;
-    /**
-     * 显示所有模型
-     */
-    showAllModels(): void;
-    /**
-     * 批量选择同类模型
-     * @param models 基准模型对象
-     */
-    batchSelectSameTypeModel(models: any): void;
-    /**
-     * 批量选择同层模型
-     * @param models 基准模型对象
-     */
-    batchSelectSameLevelModel(models: any): void;
-    /**
-     * 批量选择同层同类模型
-     * @param models 基准模型对象
-     */
-    batchSelectSameLevelTypeModel(models: any): void;
-    /**
-     * 获取当前渲染模式
-     * @returns 'simple' | 'balance' | 'advanced'
-     */
-    getRenderMode(): string;
-    /**
-     * 设置渲染模式
-     * @param mode 'simple' | 'balance' | 'advanced'
-     */
-    setRenderMode(mode: 'simple' | 'balance' | 'advanced'): void;
-    /** 销毁引擎管理器 */
-    destroy(): void;
-}