iflow-engine-base 2.0.3 → 2.0.4

package/dist/index.d.ts

@@ -295,6 +295,8 @@ declare class EngineKernelV2 {
     grid: Grid;
     level: Level;
     text: Text_2;
+    hdr: Hdr;
+    ground: Ground;
     models: any[];
     reactBoundingClientRect: {
         left: number;
@@ -585,6 +587,58 @@ declare interface GridAxisPoint {
     Z: number;
 }
 
+declare class Ground {
+    private engine;
+    private currentId;
+    private readonly groundGroup;
+    private groundMesh;
+    private waterMaterial;
+    private readonly clock;
+    private groundY;
+    private groundList;
+    constructor(engine: any);
+    init(): void;
+    /**
+     * 切换地面类型
+     * @param id  地面 id："0" 无 | "1" 草地 | "2" 混凝土 | "3" 地砖 | "4" 湖面 | "5" 海面
+     */
+    setGround(id: GroundId, config?: GroundConfig): void;
+    /**
+     * 设置地面高度（默认 0）
+     * @param y  世界空间 Y 坐标
+     */
+    setHeight(y: number): void;
+    /** 获取当前地面高度 */
+    getHeight(): number;
+    private _createWaterMaterial;
+    /** 每帧调用，驱动水面动画 */
+    update(): void;
+    /** 获取地面列表（id + 名称） */
+    getGroundList(): Array<{
+        id: string;
+        name: string;
+    }>;
+    /** 获取当前地面 id */
+    getCurrentId(): GroundId;
+    show(): void;
+    hide(): void;
+    dispose(): void;
+    private _dispose;
+}
+
+declare interface GroundConfig {
+    /** 地面尺寸（默认 300） */
+    size?: number;
+    /** 贴图 URL（仅实体地面有效） */
+    textureUrl?: string;
+    /** 阳光方向（默认斜上方） */
+    sunDirection?: THREE.Vector3;
+    /** 水面透明度（默认 0.82） */
+    opacity?: number;
+}
+
+declare type GroundId = "0" | "1" | "2" | "3" | "4" | "5";
+
 /**
  * 行为处理器 - 管理引擎的交互行为（鼠标、键盘事件等）
  * @param engine 引擎实例
@@ -592,6 +646,75 @@ declare interface GridAxisPoint {
  */
 declare function HandelBehaved(engine: any): any;
 
+declare class Hdr {
+    private engine;
+    private currentHdrId;
+    private isVisible;
+    private currentIntensity;
+    private currentTexture;
+    private skybox;
+    private readonly textureCache;
+    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 _createSkybox;
+    private _removeSkybox;
+    private _clearHdr;
+}
+
+declare interface HdrItem {
+    id: string;
+    name: string;
+    url?: string;
+}
+
 declare class HoverHighLight {
     private engine;
     private overlayMaterial;
@@ -896,8 +1019,6 @@ declare class ModelToolModule {
     private highlightMaterial;
     private hideMaterial;
     private translucentMaterial;
-    private cloneModels;
-    private clonetranslucentModels;
     constructor(engine_: any);
     split_merge_model(model: any): void;
     un_split_merge_model(model: any): void;

package/package.json

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