iflow-engine-base 3.4.4 → 3.4.5

package/dist/index.d.ts

@@ -552,6 +552,8 @@ declare class ComposerModule {
     outputPass: any;
     fxaaPass: any;
     constructor(engine: any);
+    applyClippingToAmbientOcclusionPass(pass: any): void;
+    syncAmbientOcclusionClipping(): void;
     resize(width?: number, height?: number): void;
     init(): void;
 }
@@ -1472,6 +1474,34 @@ declare class EngineModelModule {
     setGTAOIntensity(value: number): void;
 }
 
+declare interface EngineSettings {
+    render: {
+        mode: RenderMode;
+        contrast: number;
+        saturation: number;
+        shadowIntensity: number;
+        lightIntensity: number;
+        gtaoIntensity: number;
+    };
+    display: {
+        showEdge: boolean;
+        edgeOpacity: number;
+        showGrid: boolean;
+        showLevel: boolean;
+        showGround: boolean;
+        groundId: string;
+        groundHeight: number;
+    };
+    environment: {
+        type: EnvironmentType;
+        hdrId: string;
+        hdrIntensity: number;
+        skyPreset: SkyPresetName;
+        skyParams: SkyParams;
+        skyIntensity: number;
+    };
+}
+
 declare class EngineStatus {
     private engine;
     isFree: boolean;
@@ -1502,6 +1532,8 @@ declare class EngineStatus2d {
  */
 declare type EntityType = 'LINE' | 'POLYLINE' | 'CIRCLE' | 'HATCH' | 'INSERT' | 'MTEXT' | 'DIMENSIONLINEAR';
 
+declare type EnvironmentType = 'none' | 'hdr' | 'sky';
+
 /**
  * 事件监听器函数类型
  */
@@ -1858,7 +1890,7 @@ declare class Ground {
     /** 获取地面列表（id + 名称） */
     getGroundList(): Array<{
         id: string;
-        name: string;
+        names: string[];
     }>;
     /** 获取当前地面 id */
     getCurrentId(): GroundId;
@@ -3246,6 +3278,8 @@ declare class RangeScale {
     private fitCameraToBoundingBox;
 }
 
+declare type RenderMode = 'simple' | 'balance' | 'advanced';
+
 declare class RenderModule {
     private engine;
     renderer: THREE_2.WebGLRenderer | null;
@@ -3587,74 +3621,51 @@ declare interface SearchResult {
 
 declare class Setting {
     private engine;
-    private ground;
+    private settings;
+    private environmentApplyVersion;
     constructor(engine: any);
     init(): void;
-    /**
-     * 隐藏或显示性能监视器
-     * @param visible - true显示，false隐藏
-     */
-    setStatsVisible(visible: boolean): void;
-    /**
-     * 设置环境光照强度
-     * @param intensity - 光照强度，默认范围 0-5
-     */
+    getSettings(): EngineSettings;
+    getPresetLists(): {
+        ground: SettingPresetItem[];
+        hdr: SettingPresetItem[];
+        sky: SettingPresetItem[];
+    };
+    setSettings(data: Partial<EngineSettings>): Promise<void>;
+    resetToDefault(): Promise<void>;
+    setRenderMode(mode: RenderMode): void;
+    setContrast(value: number): void;
+    setSaturation(value: number): void;
+    setShadowIntensity(value: number): void;
+    setLightIntensity(value: number): void;
+    setGTAOIntensity(value: number): void;
+    setShowEdge(show: boolean): void;
+    setEdgeOpacity(value: number): void;
+    setShowGrid(show: boolean): void;
+    setShowLevel(show: boolean): void;
+    setShowGround(show: boolean): void;
+    setGroundId(id: string): void;
+    setGroundHeight(height: number): void;
+    setEnvironmentType(type: EnvironmentType): Promise<void>;
+    setHdrId(id: string): Promise<void>;
+    setHdrIntensity(value: number): void;
+    setSkyPreset(preset: SkyPresetName): void;
+    setSkyParams(params: SkyParams): void;
+    setSkyIntensity(value: number): void;
     setAmbientLightIntensity(intensity: number): void;
-    /**
-     * 设置环境光照颜色
-     * @param color - 颜色，可以是十六进制数字 (0xffffff) 或字符串 ('#ffffff')
-     */
-    setAmbientLightColor(color: number | string): void;
-    /**
-     * 设置定向光源强度
-     * @param intensity - 光照强度，默认范围 0-5
-     */
-    setDirectionalLightIntensity(intensity: number): void;
-    /**
-     * 设置定向光源颜色
-     * @param color - 颜色，可以是十六进制数字 (0xffffff) 或字符串 ('#ffffff')
-     */
-    setDirectionalLightColor(color: number | string): void;
-    /**
-     * 设置阴影精细度（阴影贴图分辨率）
-     * @param quality - 质量等级：'low' (1024), 'medium' (2048), 'high' (4096), 'ultra' (8192)
-     */
-    setShadowQuality(quality: 'low' | 'medium' | 'high' | 'ultra'): void;
-    /**
-     * 设置是否开启定向光阴影
-     * @param enabled - true开启，false关闭
-     */
-    setDirectionalLightShadow(enabled: boolean): void;
-    /**
-     * 设置是否开启GTAO阴影（环境光遮蔽）
-     * @param enabled - true开启，false关闭
-     */
-    setGTAOEnabled(enabled: boolean): void;
-    /**
-     * 设置场景饱和度
-     * @param saturation - 饱和度值，1.0为正常，>1增强，<1降低，推荐范围 0.5-2.0
-     */
-    setSceneSaturation(saturation: number): void;
-    /**
-     * 设置场景对比度
-     * @param contrast - 对比度值，1.0为正常，>1增强，<1降低，推荐范围 0.5-2.0
-     */
-    setSceneContrast(contrast: number): void;
-    /**
-     * 设置是否开启地面
-     * @param enabled - true开启，false关闭
-     * @param options - 地面配置选项
-     */
-    setGroundEnabled(enabled: boolean, options?: {
-        size?: number;
-        color?: number | string;
-        opacity?: number;
-    }): void;
-    /**
-     * 设置HDR背景
-     * @param hdrTexture - HDR环境贴图（THREE.Texture），传入null则移除背景
-     */
-    setHDRBackground(hdrTexture: THREE.Texture | null): void;
+    private _applyRenderSettings;
+    private _applyDisplaySettings;
+    private _applyEnvironmentSettings;
+    private _updateDirectionalLight;
+    private _mergeEnvironmentSettings;
+    private _toPresetItem;
+    private _clone;
+}
+
+declare interface SettingPresetItem {
+    id: string;
+    name: string;
+    names: string[];
 }
 
 declare class SkyManager {

package/package.json

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