iflow-engine-base 3.5.1 → 3.5.2

package/dist/index.d.ts

@@ -2143,6 +2143,7 @@ declare class Grid {
     show(): void;
     hide(): void;
     toggle(): void;
+    getVisible(): boolean;
     update(): void;
     /**
      * 根据三维点计算所在轴网区间。
@@ -2273,6 +2274,7 @@ declare class Ground {
     }>;
     /** 获取当前地面 id */
     getCurrentId(): GroundId;
+    getVisible(): boolean;
     show(): void;
     hide(): void;
     dispose(): void;
@@ -2728,6 +2730,7 @@ declare class Level {
     show(): void;
     hide(): void;
     toggle(): void;
+    getVisible(): boolean;
     update(): void;
     /**
      * 根据点位高度计算所属标高，描述统一输出为“标高X”。
@@ -3068,6 +3071,8 @@ declare class ModelEdge {
     constructor(engine: any);
     active(): void;
     disActive(): void;
+    isEnabled(): boolean;
+    getOpacity(): number;
     private hasPendingModelEdges;
     private loadZipJsonAsync;
     private ensureModelEdgeData;
@@ -4074,86 +4079,93 @@ declare interface SearchResult {
     description?: string;
 }
 
-/** 引擎设置管理器，负责渲染、显示和环境参数的统一管理 */
+/** 寮曟搸璁剧疆绠＄悊鍣紝璐熻矗娓叉煋銆佹樉绀哄拰鐜鍙傛暟鐨勭粺涓€绠＄悊 */
 declare class Setting {
-    /** 引擎实例引用 */
+    /** 寮曟搸瀹炰緥寮曠敤 */
     private engine;
-    /** 当前生效的设置项 */
+    private defaultSettings;
+    /** 褰撳墠鐢熸晥鐨勮缃」 */
     private settings;
-    /** 环境设置的应用版本号，用于防止异步操作的竞态条件 */
+    /** 鐜璁剧疆鐨勫簲鐢ㄧ増鏈彿锛岀敤浜庨槻姝㈠紓姝ユ搷浣滅殑绔炴€佹潯浠?*/
     private environmentApplyVersion;
     constructor(engine: any);
-    /** 初始化（当前为空实现） */
+    /** 鍒濆鍖栵紙褰撳墠涓虹┖瀹炵幇锛?*/
     init(): void;
-    /** 获取当前设置的深拷贝 */
+    /** 鑾峰彇褰撳墠璁剧疆鐨勬繁鎷疯礉 */
     getSettings(): EngineSettings;
-    /** 获取地面、HDR、天空的预设列表 */
+    /** 鑾峰彇鍦伴潰銆丠DR銆佸ぉ绌虹殑棰勮鍒楄〃 */
     getPresetLists(): {
         ground: SettingPresetItem[];
         hdr: SettingPresetItem[];
         sky: SettingPresetItem[];
     };
-    /** 批量更新设置（支持部分更新） */
+    /** 鎵归噺鏇存柊璁剧疆锛堟敮鎸侀儴鍒嗘洿鏂帮級 */
     setSettings(data: Partial<EngineSettings>): Promise<void>;
-    /** 重置所有设置为默认值 */
+    /** 閲嶇疆鎵€鏈夎缃负榛樿鍊?*/
     resetToDefault(): Promise<void>;
-    /** 设置渲染模式（simple: 简易, balance: 均衡, advanced: 高级） */
+    /** 璁剧疆娓叉煋妯″紡锛坰imple: 绠€鏄? balance: 鍧囪　, advanced: 楂樼骇锛?*/
     setRenderMode(mode: RenderMode): void;
-    /** 设置对比度（0~100） */
+    /** 璁剧疆瀵规瘮搴︼紙0~100锛?*/
     setContrast(value: number): void;
-    /** 设置饱和度（0~100） */
+    /** 璁剧疆楗卞拰搴︼紙0~100锛?*/
     setSaturation(value: number): void;
-    /** 设置阴影强度（0~100） */
+    /** 璁剧疆闃村奖寮哄害锛?~100锛?*/
     setShadowIntensity(value: number): void;
-    /** 设置光照强度（0~100），调整环境光亮度 */
+    /** 璁剧疆鍏夌収寮哄害锛?~100锛夛紝璋冩暣鐜鍏変寒搴?*/
     setLightIntensity(value: number): void;
-    /** 设置 GTAO（屏幕空间环境光遮蔽）强度（0~100） */
+    /** 璁剧疆 GTAO锛堝睆骞曠┖闂寸幆澧冨厜閬斀锛夊己搴︼紙0~100锛?*/
     setGTAOIntensity(value: number): void;
-    /** 设置是否显示模型边缘线 */
+    /** 璁剧疆鏄惁鏄剧ず妯″瀷杈圭紭绾?*/
     setShowEdge(show: boolean): void;
-    /** 设置边缘线透明度（0~100） */
+    /** 璁剧疆杈圭紭绾块€忔槑搴︼紙0~100锛?*/
     setEdgeOpacity(value: number): void;
-    /** 设置是否显示网格 */
+    /** 璁剧疆鏄惁鏄剧ず缃戞牸 */
     setShowGrid(show: boolean): void;
-    /** 设置是否显示楼层 */
+    /** 璁剧疆鏄惁鏄剧ず妤煎眰 */
     setShowLevel(show: boolean): void;
-    /** 设置是否显示地面 */
+    /** 璁剧疆鏄惁鏄剧ず鍦伴潰 */
     setShowGround(show: boolean): void;
-    /** 设置当前使用的地面 ID */
+    /** 璁剧疆褰撳墠浣跨敤鐨勫湴闈?ID */
     setGroundId(id: string): void;
-    /** 设置地面高度 */
+    /** 璁剧疆鍦伴潰楂樺害 */
     setGroundHeight(height: number): void;
-    /** 设置环境类型（none: 无, hdr: HDR贴图, sky: 天空） */
+    /** 璁剧疆鐜绫诲瀷锛坣one: 鏃? hdr: HDR璐村浘, sky: 澶╃┖锛?*/
     setEnvironmentType(type: EnvironmentType): Promise<void>;
-    /** 设置 HDR 贴图 ID，当前环境为 hdr 时立即生效 */
+    /** 璁剧疆 HDR 璐村浘 ID锛屽綋鍓嶇幆澧冧负 hdr 鏃剁珛鍗崇敓鏁?*/
     setHdrId(id: string): Promise<void>;
-    /** 设置 HDR 强度（0~100），仅在 hdr 模式下生效 */
+    /** 璁剧疆 HDR 寮哄害锛?~100锛夛紝浠呭湪 hdr 妯″紡涓嬬敓鏁?*/
     setHdrIntensity(value: number): void;
-    /** 设置天空预设方案，当前环境为 sky 时立即生效 */
+    /** 璁剧疆澶╃┖棰勮鏂规锛屽綋鍓嶇幆澧冧负 sky 鏃剁珛鍗崇敓鏁?*/
     setSkyPreset(preset: SkyPresetName): void;
-    /** 设置天空自定义参数，当前环境为 sky 时立即生效 */
+    /** 璁剧疆澶╃┖鑷畾涔夊弬鏁帮紝褰撳墠鐜涓?sky 鏃剁珛鍗崇敓鏁?*/
     setSkyParams(params: SkyParams): void;
-    /** 设置天空亮度（0~100），仅在 sky 模式下生效 */
+    /** 璁剧疆澶╃┖浜害锛?~100锛夛紝浠呭湪 sky 妯″紡涓嬬敓鏁?*/
     setSkyIntensity(value: number): void;
-    /** 直接设置场景中环境光的强度 */
+    /** 鐩存帴璁剧疆鍦烘櫙涓幆澧冨厜鐨勫己搴?*/
     setAmbientLightIntensity(intensity: number): void;
-    /** 一次性应用所有渲染设置 */
+    /** 涓€娆℃€у簲鐢ㄦ墍鏈夋覆鏌撹缃?*/
+    private _syncSettingsFromModules;
+    private _buildDefaultSettingsFromModules;
+    private _readCurrentSettingsFromModules;
+    private _toRenderMode;
+    private _uniformToPercent;
+    private _shadowToPercent;
+    private _exposureToPercent;
+    private _unitToPercent;
+    private _clampPercent;
+    private _getDirectionalLightShadowIntensity;
     private _applyRenderSettings;
-    /** 一次性应用所有显示设置 */
+    /** 涓€娆℃€у簲鐢ㄦ墍鏈夋樉绀鸿缃?*/
     private _applyDisplaySettings;
     /**
-     * 应用环境设置。
-     * 先关闭当前 HDR 和天空，再根据类型重新启用。
-     * 使用版本号机制防止多次异步调用之间的竞态条件。
-     */
+     * 搴旂敤鐜璁剧疆銆?     * 鍏堝叧闂綋鍓?HDR 鍜屽ぉ绌猴紝鍐嶆牴鎹被鍨嬮噸鏂板惎鐢ㄣ€?     * 浣跨敤鐗堟湰鍙锋満鍒堕槻姝㈠娆″紓姝ヨ皟鐢ㄤ箣闂寸殑绔炴€佹潯浠躲€?     */
     private _applyEnvironmentSettings;
-    /** 在场景中查找平行光并执行回调操作 */
     private _updateDirectionalLight;
-    /** 合并环境设置，处理 skyPreset 与 skyParams 的联动关系 */
+    /** 鍚堝苟鐜璁剧疆锛屽鐞?skyPreset 涓?skyParams 鐨勮仈鍔ㄥ叧绯?*/
     private _mergeEnvironmentSettings;
-    /** 将原始数据转换为标准预设项 */
+    /** 灏嗗師濮嬫暟鎹浆鎹负鏍囧噯棰勮椤?*/
     private _toPresetItem;
-    /** 深拷贝工具方法 */
+    /** 娣辨嫹璐濆伐鍏锋柟娉?*/
     private _clone;
 }
 
@@ -4168,6 +4180,7 @@ declare class SkyManager {
     private sky;
     private sun;
     private params;
+    private currentPreset;
     private currentIntensity;
     private currentEnvironmentTarget;
     private readonly skyScale;
@@ -4187,6 +4200,7 @@ declare class SkyManager {
     getParams(): Readonly<Required<SkyParams>>;
     setParams(params: SkyParams): void;
     setPreset(name: SkyPresetName): void;
+    getCurrentPreset(): SkyPresetName;
     getPresetNames(): SkyPresetName[];
     getPresetList(): SkyPresetInfo[];
     setIntensity(intensity: number): void;

package/package.json

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