iflow-engine-base 3.4.3 → 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,13 +1890,19 @@ declare class Ground {
     /** 获取地面列表（id + 名称） */
     getGroundList(): Array<{
         id: string;
-        name: string;
+        names: string[];
     }>;
     /** 获取当前地面 id */
     getCurrentId(): GroundId;
     show(): void;
     hide(): void;
     dispose(): void;
+    /**
+     * 兼容项目内本地 three 渲染器。
+     * 本地渲染器会向 lights uniforms 写入 directional/spot/point 的 shadowMap，
+     * 但 npm Water 使用的 three 版本没有把这些 sampler 挂到 UniformsLib['lights'] 上。
+     */
+    private ensureWaterShadowUniforms;
     private _dispose;
 }
 
@@ -1900,66 +1938,41 @@ declare class Hdr {
     private isVisible;
     private currentIntensity;
     private currentTexture;
+    private currentEnvironmentTexture;
     private skybox;
     private readonly textureCache;
+    private previousBackground;
+    private previousEnvironment;
+    private previousBackgroundIntensity;
+    private previousEnvironmentIntensity;
+    private previousAmbientLightIntensity;
+    private previousToneMapping;
+    private previousToneMappingExposure;
     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 _captureSceneState;
     private _createSkybox;
+    private _updateSkyboxIntensity;
     private _removeSkybox;
     private _clearHdr;
+    private _getAmbientLightIntensity;
+    private _setAmbientLightIntensity;
 }
 
 declare interface HdrItem {
     id: string;
-    name: string;
+    names: string[];
     url?: string;
 }
 
@@ -2637,6 +2650,7 @@ declare class ModelEdge {
     private show;
     getModelEdge(url: string, id: Number): any;
     hideModelEdge(url: string, id: Number): void;
+    setOpacity(opacity: number): void;
     showModelEdge(url: string, id: Number): void;
 }
 
@@ -3264,6 +3278,8 @@ declare class RangeScale {
     private fitCameraToBoundingBox;
 }
 
+declare type RenderMode = 'simple' | 'balance' | 'advanced';
+
 declare class RenderModule {
     private engine;
     renderer: THREE_2.WebGLRenderer | null;
@@ -3605,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 {
@@ -3680,89 +3673,64 @@ declare class SkyManager {
     private sky;
     private sun;
     private params;
+    private currentIntensity;
+    private currentEnvironmentTarget;
     private readonly skyScale;
     private readonly skyName;
-    /** 激活天空前相机的 far，关闭时恢复 */
     private savedCameraFar;
+    private previousBackground;
+    private previousEnvironment;
+    private previousBackgroundIntensity;
+    private previousEnvironmentIntensity;
+    private previousToneMapping;
+    private previousToneMappingExposure;
+    private hasCapturedSceneState;
     constructor(engine: any);
-    /**
-     * 激活天空球：创建 Sky 并加入场景，应用当前参数
-     */
     activate(): void;
-    /**
-     * 关闭天空球：从场景移除并释放，或仅隐藏
-     * @param remove - true 从场景移除并 dispose，false 仅隐藏
-     */
     close(remove?: boolean): void;
-    /**
-     * 是否已激活（天空对象存在且已加入场景）
-     */
     isActive(): boolean;
-    /**
-     * 获取当前参数（副本）
-     */
     getParams(): Readonly<Required<SkyParams>>;
-    /**
-     * 使用对象设置参数（支持部分字段），并立即应用到天空与渲染器
-     */
     setParams(params: SkyParams): void;
-    /**
-     * 应用预设
-     */
     setPreset(name: SkyPresetName): void;
-    /**
-     * 获取所有预设名称
-     */
     getPresetNames(): SkyPresetName[];
-    /**
-     * 更新云层动画时间（每帧调用一次，例如在渲染循环中）
-     * 同时根据当前相机类型（透视/正交）同步曝光，保证切换相机后天空亮度正确。
-     * @param time - 秒，不传则使用 performance.now() * 0.001
-     */
+    getPresetList(): SkyPresetInfo[];
+    setIntensity(intensity: number): void;
+    getIntensity(): number;
     update(time?: number): void;
-    /** 当前相机是否为正交相机 */
     private _isOrthographicCamera;
-    /** 获取当前相机有效曝光（正交相机使用 orthoExposureScale 补偿） */
     private _getEffectiveExposure;
-    /** 扩大相机 far 以容纳天空盒，避免被裁剪成黑屏（支持透视与正交） */
     private _expandCameraFarForSky;
-    /** 关闭天空时恢复相机 far（支持透视与正交） */
     private _restoreCameraFar;
     private _applyParamsToSky;
-    /** Set shader uniform if it exists on current Sky material to avoid runtime errors with stock shader. */
+    private _captureSceneState;
+    private _restoreSceneState;
+    private _refreshEnvironmentMap;
+    private _disposeEnvironmentTarget;
     private _setUniformValue;
 }
 
-/** 天空球参数（与 Three.js Sky 材质 uniform 及曝光对应） */
 declare interface SkyParams {
-    /** 大气浑浊度，0~20，默认 10 */
     turbidity?: number;
-    /** 瑞利散射，0~4，默认 3 */
     rayleigh?: number;
-    /** Mie 系数，0~0.1，默认 0.005 */
     mieCoefficient?: number;
-    /** Mie 方向性，0~1，默认 0.7 */
     mieDirectionalG?: number;
-    /** 太阳仰角（度），0~90，默认 2 */
     elevation?: number;
-    /** 太阳方位角（度），-180~180，默认 180 */
     azimuth?: number;
-    /** 渲染器曝光，0~1，默认 0.5 */
     exposure?: number;
-    /** 正交相机下的曝光倍数，用于补偿正交投影下天空偏暗，默认 1.5 */
     orthoExposureScale?: number;
-    /** 云层覆盖，0~1，默认 0.4 */
     cloudCoverage?: number;
-    /** 云层密度，0~1，默认 0.4 */
     cloudDensity?: number;
-    /** 云层高度感，0~1，默认 0.5 */
     cloudElevation?: number;
-    /** 是否显示日盘，默认 true */
     showSunDisc?: boolean;
 }
 
-/** 预设名称 */
-declare type SkyPresetName = 'default' | 'sunset' | 'overcast' | 'clear' | 'night';
+declare interface SkyPresetInfo {
+    id: SkyPresetName;
+    names: string[];
+    params: SkyParams;
+}
+
+declare type SkyPresetName = 'sunrise_clear' | 'morning_mist' | 'noon_clear' | 'afternoon_cloudy' | 'sunset_glow' | 'blue_hour' | 'overcast_day' | 'storm_rain' | 'snow_day' | 'moonlit_night';
 
 /**
  * 步骤接口

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iflow-engine-base",
-  "version": "3.4.3",
+  "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",