iflow-engine-base 3.4.3 → 3.4.4

package/dist/index.d.ts

@@ -1865,6 +1865,12 @@ declare class Ground {
     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 +1906,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 +2618,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;
 }
 
@@ -3680,89 +3662,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.4",
   "description": "BIM Engine SDK for Vue2, Vue3, React and HTML",
   "main": "./dist/bim-engine-sdk.umd.js",
   "module": "./dist/bim-engine-sdk.es.js",