iflow-engine-base 2.0.0 → 2.0.2

package/dist/iflow-engine-base.css

@@ -1 +1 @@
-.originRotate{width:10px;height:10px;background-color:red}.versionText{position:absolute;right:10px;color:#86d9ff;z-index:1000;bottom:10px;background:transparent;pointer-events:none}.originDiv{position:absolute;top:100px;left:100px;width:30px;height:30px;border-radius:50%;z-index:1000;pointer-events:none}.catchPoint{pointer-events:none;fill:#00f;stroke:#fff;stroke-width:1}.catchLine{position:absolute;width:10px;height:10px;pointer-events:none;background-color:green}.catchPlane{position:absolute;width:10px;height:10px;pointer-events:none;background-color:#ff0}.ViewCube{position:absolute;width:120px;height:120px;top:0;right:0;z-index:999}.homeViewWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-image:url(/assets/viewcube/home.png);background-size:100% 100%;background-repeat:no-repeat;background-color:#fff0;color:#fff;top:10px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.viewSettingWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-size:100% 100%;background-repeat:no-repeat;font-weight:800;background-color:#fff0;color:#fff;top:30px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:70px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper.show{display:flex}.cameraToggleWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.screenshotWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:20px;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:120px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.screenshotWrapper.show{display:flex}.screenshotWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.fullscreenWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:170px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.fullscreenWrapper.show{display:flex}.fullscreenWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.measure-elevation{position:absolute;pointer-events:none}.measureSvg{position:absolute;width:1920px;height:1080px}.catch-point{position:absolute;width:10px;height:10px;background-color:red;border-radius:50%;pointer-events:none}.annotation-container{position:absolute;pointer-events:none;top:0;left:0}.measureLine{position:absolute;pointer-events:none}.measureBack{cursor:pointer;pointer-events:auto;fill:orange;top:-50px;rx:5;ry:5}.measureLabel{position:absolute;fill:#fff;font-size:14px;font-family:Arial,sans-serif;pointer-events:none}.measurePointer{fill:orange}.Hight{stroke:#fff;stroke-width:2}.allow-select{pointer-events:auto}.disallow-select{pointer-events:none}.angle-annotation{position:absolute;pointer-events:auto}
+.originRotate{width:10px;height:10px;background-color:red}.versionText{position:absolute;right:10px;color:#86d9ff;z-index:1000;bottom:10px;background:transparent;pointer-events:none}.originDiv{position:absolute;top:100px;left:100px;width:30px;height:30px;border-radius:50%;z-index:1000;pointer-events:none}.catchPoint{pointer-events:none;stroke:#08dfd7;fill:transparent;stroke-width:2}.catchLine{position:absolute;width:10px;height:10px;pointer-events:none;background-color:green}.catchPlane{position:absolute;width:10px;height:10px;pointer-events:none;background-color:#ff0}.ViewCube{position:absolute;width:120px;height:120px;top:0;right:0;z-index:999}.homeViewWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-image:url(/assets/viewcube/home.png);background-size:100% 100%;background-repeat:no-repeat;background-color:#fff0;color:#fff;top:10px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.viewSettingWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-size:100% 100%;background-repeat:no-repeat;font-weight:800;background-color:#fff0;color:#fff;top:30px;right:100;width:20px;height:20px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:70px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.cameraToggleWrapper.show{display:flex}.cameraToggleWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.screenshotWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:20px;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:120px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.screenshotWrapper.show{display:flex}.screenshotWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.fullscreenWrapper{position:absolute;cursor:pointer;pointer-events:auto;background-color:#ffffffe6;color:#333;font-size:26px;font-weight:700;display:none;align-items:center;justify-content:center;border-radius:4px;box-shadow:0 2px 4px #0003;transition:all .3s ease;top:170px;right:90px;width:44px;height:44px;z-index:999;user-select:none;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none}.fullscreenWrapper.show{display:flex}.fullscreenWrapper:hover{background-color:#fff;box-shadow:0 3px 6px #0000004d;transform:scale(1.1)}.measure-elevation{position:absolute;pointer-events:none}.measureSvg{position:absolute;width:1920px;height:1080px}.catch-point{position:absolute;width:10px;height:10px;background-color:red;border-radius:50%;pointer-events:none}.annotation-container{position:absolute;pointer-events:none;top:0;left:0}.measureLine{position:absolute;pointer-events:none}.measureBack{cursor:pointer;pointer-events:auto;fill:orange;top:-50px;rx:5;ry:5}.measureLabel{position:absolute;fill:#fff;font-size:14px;font-family:Arial,sans-serif;pointer-events:none}.measurePointer{fill:orange}.Hight{stroke:#fff;stroke-width:2}.allow-select{pointer-events:auto}.disallow-select{pointer-events:none}.angle-annotation{position:absolute;pointer-events:auto}

package/dist/index.d.ts

@@ -279,6 +279,10 @@ declare class EngineKernelV2 {
     ai: AI;
     pathRoaming: PathRoaming;
     hoverHighLight: HoverHighLight;
+    minMap: MiniMap;
+    grid: Grid;
+    level: Level;
+    text: Text_2;
     models: any[];
     reactBoundingClientRect: {
         left: number;
@@ -479,6 +483,58 @@ declare enum EventType {
     SectionMove = "section-move"
 }
 
+declare class Grid {
+    private readonly engine;
+    private rootGroup;
+    private isVisible;
+    private axes;
+    /**
+     * 坐标转换：BIM(X,Y,Z) → Three.js 世界坐标
+     * 默认规则：BIM X=水平, Y=水平深度, Z=高度
+     *         → Three.js X=水平, Y=高度, Z=-深度
+     * 可在外部替换此函数以适配不同坐标系。
+     */
+    coordinateMapper: (p: GridAxisPoint) => THREE.Vector3;
+    constructor(engine: any);
+    /** 传入轴网数据并在场景中构建对象 */
+    setData(data: GridAxisData[]): void;
+    /** 使用内置模拟数据（调试用） */
+    setMockData(): void;
+    /** 显示轴网 */
+    show(): void;
+    /** 隐藏轴网 */
+    hide(): void;
+    /** 切换显示/隐藏 */
+    toggle(): void;
+    /**
+     * 每帧更新（在动画循环中调用）
+     * 根据正交相机缩放动态调整圆圈大小，保持屏幕上视觉尺寸恒定（约 30px）
+     */
+    update(): void;
+    /** 销毁，释放 Three.js 资源 */
+    dispose(): void;
+    private _initRoot;
+    private _clearAxes;
+    private _buildAxis;
+    /**
+     * 创建带文字的圆圈 Sprite
+     * Sprite 默认朝向相机（billboard），depthTest=false 保证始终可见
+     */
+    private _makeCircleSprite;
+}
+
+declare interface GridAxisData {
+    Id: string;
+    Name: string;
+    Points: [GridAxisPoint, GridAxisPoint];
+}
+
+declare interface GridAxisPoint {
+    X: number;
+    Y: number;
+    Z: number;
+}
+
 /**
  * 行为处理器 - 管理引擎的交互行为（鼠标、键盘事件等）
  * @param engine 引擎实例
@@ -559,6 +615,7 @@ declare class InteractionModule {
     handelKeyCtrlDown(): void;
     private hoverOldId;
     handleMouseMove(event: any): void;
+    getCatchMeshs(event: any): any;
     handleMouseClick(event: any): void;
     handleMouseDoubleClick(event: any): void;
     handleMouseClickInstance(raycaster: any): any;
@@ -587,6 +644,45 @@ declare interface IRoamingPoint extends ICameraPose {
     stayTime?: number;
 }
 
+declare class Level {
+    private engine;
+    private isVisible;
+    private levels;
+    private svgContainer;
+    private svgOverlay;
+    private worldToScreen;
+    halfSize: number;
+    private readonly COLOR;
+    private readonly PLANE_OPACITY;
+    constructor(engine: any);
+    private _initSvg;
+    /** 传入标高数据并渲染 */
+    setData(data: LevelData[]): void;
+    /** 使用内置模拟数据（调试用） */
+    setMockData(): void;
+    /** 显示标高 */
+    show(): void;
+    /** 隐藏标高 */
+    hide(): void;
+    /** 切换显示/隐藏 */
+    toggle(): void;
+    /** 每帧刷新（需在动画循环中调用） */
+    update(): void;
+    /** 销毁，释放资源 */
+    dispose(): void;
+    private _initWorldToScreen;
+    private _clearAll;
+    private _buildThreeObject;
+    private _updateSvgLabels;
+    private _makeLabel;
+}
+
+declare interface LevelData {
+    Id: string;
+    Name: string;
+    Elevation: number;
+}
+
 declare class LightModule {
     private engine;
     constructor(engine: any);
@@ -652,15 +748,72 @@ declare interface Message {
     content: string;
 }
 
+declare class MiniMap {
+    private engine;
+    private miniMapCamera;
+    private miniMapRenderer;
+    private miniMapContainer;
+    private overlayCanvas;
+    private overlayCtx;
+    private isVisible;
+    private readonly mapSize;
+    private currentHalfSize;
+    private readonly minHalfSize;
+    private readonly maxHalfSize;
+    private halfSizeInitialized;
+    private camY;
+    private centerX;
+    private centerZ;
+    private dragMode;
+    private lastMouseX;
+    private lastMouseY;
+    constructor(engine: any);
+    getstate(): boolean;
+    private init;
+    /**
+     * 世界坐标 XZ → 小地图像素坐标
+     * 小地图 up=(0,0,-1)：-Z 朝屏幕上方，+X 朝屏幕右方
+     */
+    private worldToPixel;
+    /** 小地图像素坐标 → 世界坐标 XZ */
+    private pixelToWorld;
+    private setupEvents;
+    /** 滚轮缩放小地图视野 */
+    private readonly onWheel;
+    /**
+     * 点击指示器（中心 25px 范围）→ 进入旋转拖拽模式
+     * 点击其他位置 → 计算世界坐标，直接将相机传送过去
+     */
+    private readonly onMouseDown;
+    private readonly onMouseMove;
+    private readonly onMouseUp;
+    /**
+     * 传送：点击小地图空白区域 → 计算世界坐标，将相机和 target 平移过去
+     */
+    private handleTeleport;
+    /**
+     * 旋转：拖动指示器尖端 → 绕 controls.target 旋转主相机水平轨道角
+     */
+    private handleRotate;
+    private drawOverlay;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    update(): void;
+    dispose(): void;
+}
+
 declare class ModelEdge {
     private engine;
     private isActive;
     private groupEdge;
     private material;
+    private modelEdgeLoaded;
     private indexes;
     constructor(engine: any);
     active(): void;
     disActive(): void;
+    private loadModelEdge;
     private show;
     getModelEdge(url: string, id: Number): any;
     hideModelEdge(url: string, id: Number): void;
@@ -1058,6 +1211,12 @@ declare interface Step {
     apiModules: string[];
 }
 
+declare class Text_2 {
+    private engine;
+    constructor(engine: any);
+    update(): void;
+}
+
 declare class ViewCube {
     private engine;
     cubeTool: any;

package/package.json

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