@xtctwins/tctwins-bimx-engine 0.3.11 → 0.3.13

package/types/store/toolbars.d.ts

@@ -1,4 +1,4 @@
-export type ComponentName = "StructureTree" | "InspectorTool" | "HiddenTool" | "RoamTool" | "CameraViewTool" | "MeasureTool" | "SectionTool" | "CommentTool" | "AnnotationTool" | "ScreenShotTool" | "SettingTool" | "NavigateTool" | "BCFTool" | "MouseTool";
+export type ComponentName = "StructureTree" | "InspectorTool" | "HiddenTool" | "RoamTool" | "CameraViewTool" | "MeasureTool" | "SectionTool" | "CommentTool" | "AnnotationTool" | "ScreenShotTool" | "SettingTool" | "NavigateTool" | "BCFTool" | "MouseTool" | "OperateTool";
 export type Tool = {
     id: number;
     key: string;
@@ -17,6 +17,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
     mTools: Tool[];
     visibleToolIds: number[];
     readyToolIds: number[];
+    sectionMode: "plane" | "box" | null;
 }, {
     tools: (state: {
         isPc: boolean;
@@ -46,12 +47,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => {
         id: number;
         key: string;
@@ -92,12 +95,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => Tool[];
     readyTools: (state: {
         isPc: boolean;
@@ -127,12 +132,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => number[];
     visibleComponents: (state: {
         isPc: boolean;
@@ -162,12 +169,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => ("" | ComponentName)[];
     getKeyById: (state: {
         isPc: boolean;
@@ -197,12 +206,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (toolId: number) => string | undefined;
     getToolById: (state: {
         isPc: boolean;
@@ -232,12 +243,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (toolId: number) => Tool | undefined;
     getToolByKey: (state: {
         isPc: boolean;
@@ -267,12 +280,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => Tool | undefined;
     hasActiveState: (state: {
         isPc: boolean;
@@ -302,12 +317,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolEnable: (state: {
         isPc: boolean;
@@ -337,12 +354,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolEnableBykey: (state: {
         isPc: boolean;
@@ -372,12 +391,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => boolean;
     isToolActive: (state: {
         isPc: boolean;
@@ -407,12 +428,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolActiveBykey: (state: {
         isPc: boolean;
@@ -442,12 +465,14 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => boolean;
 }, {
     setDevice(type: string): void;
@@ -456,6 +481,7 @@ export declare const useToolbarStore: import('pinia').StoreDefinition<"toolbar",
     setEnableToolsByKey(keys: string[]): void;
     setToolActiveStatus(toolId: number, isOpen?: boolean): void;
     setToolActiveStatusBykey(key: string, isOpen?: boolean): void;
+    setSectionMode(mode: "plane" | "box" | null): void;
     setAllToolClose(extraTool?: number[]): void;
     setReadyById(toolId: number): void;
     ifToolAllReady(): boolean;
@@ -467,6 +493,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
     mTools: Tool[];
     visibleToolIds: number[];
     readyToolIds: number[];
+    sectionMode: "plane" | "box" | null;
 }, {
     tools: (state: {
         isPc: boolean;
@@ -496,12 +523,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => {
         id: number;
         key: string;
@@ -542,12 +571,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => Tool[];
     readyTools: (state: {
         isPc: boolean;
@@ -577,12 +608,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => number[];
     visibleComponents: (state: {
         isPc: boolean;
@@ -612,12 +645,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => ("" | ComponentName)[];
     getKeyById: (state: {
         isPc: boolean;
@@ -647,12 +682,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (toolId: number) => string | undefined;
     getToolById: (state: {
         isPc: boolean;
@@ -682,12 +719,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (toolId: number) => Tool | undefined;
     getToolByKey: (state: {
         isPc: boolean;
@@ -717,12 +756,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => Tool | undefined;
     hasActiveState: (state: {
         isPc: boolean;
@@ -752,12 +793,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolEnable: (state: {
         isPc: boolean;
@@ -787,12 +830,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolEnableBykey: (state: {
         isPc: boolean;
@@ -822,12 +867,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => boolean;
     isToolActive: (state: {
         isPc: boolean;
@@ -857,12 +904,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (id: number) => boolean;
     isToolActiveBykey: (state: {
         isPc: boolean;
@@ -892,12 +941,14 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
         }[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     } & import('pinia').PiniaCustomStateProperties<{
         isPc: boolean;
         pTools: Tool[];
         mTools: Tool[];
         visibleToolIds: number[];
         readyToolIds: number[];
+        sectionMode: "plane" | "box" | null;
     }>) => (key: string) => boolean;
 }, {
     setDevice(type: string): void;
@@ -906,6 +957,7 @@ export declare function getToolbarStore(): import('pinia').Store<"toolbar", {
     setEnableToolsByKey(keys: string[]): void;
     setToolActiveStatus(toolId: number, isOpen?: boolean): void;
     setToolActiveStatusBykey(key: string, isOpen?: boolean): void;
+    setSectionMode(mode: "plane" | "box" | null): void;
     setAllToolClose(extraTool?: number[]): void;
     setReadyById(toolId: number): void;
     ifToolAllReady(): boolean;

package/types/utils/OSSHelper.d.ts

@@ -1,5 +1,7 @@
 export default class OSSHelper {
     static getBuffer(filePath: string, done: Function, error?: Function): Promise<void>;
+    /** 下载单个文件并返回 ArrayBuffer（Promise 风格，便于并发） */
+    static fetchBuffer(filePath: string): Promise<ArrayBuffer>;
     static requestFileFromOSS(filePath: string, isFile: boolean, done: Function, error: Function): Promise<void>;
     static downloadFile(filePath: string): Promise<ArrayBuffer>;
 }

package/types/utils/eventBus.d.ts

@@ -16,7 +16,10 @@ export declare let EventMemory: {
 };
 export type AnnoType = "file" | "image" | "record" | "text" | "video";
 export type RoamEvent = "goUp" | "goDown" | "goLeft" | "goRight" | "goForward" | "goBackward" | "stop";
-export type MeasureTool = "distance" | "angle";
+/** 应用层开放的五个测量模式（viewer 还支持 faceArea 面面积，应用层先不放出来） */
+export type MeasureProMode = "pointDistance" | "pointAngle" | "edgeLength" | "edgeDistance" | "edgeAngle" | "circleRadius" | "elevation";
+/** 旧的两种（历史数据 / 老存档还会是这两个值）+ 新的六个模式 */
+export type MeasureTool = "distance" | "angle" | MeasureProMode;
 export type EventContent = {
     /**
      * 是否是功能
@@ -73,6 +76,8 @@ export type EventContent = {
         title?: string;
         cameraView?: any;
         description?: string;
+        operateMode?: number;
+        operateIds?: string[];
     };
 };
 type instructionName = "updateCmtList" | "checkCmtDetail" | "newComment" | "updateBcfList" | "checkBcfDetail" | "changeBackgroundColor" | "setNavCube" | "setAnnoStatus" | "setCameraView" | "lastSetsContent";

package/types/viewerManager/load/loadModel.d.ts

@@ -20,6 +20,35 @@ export declare function createMetadataTask(modelId: string, options: MetadataTas
     load(targetViewer: any): Promise<void>;
     cancel(): void;
 };
+export interface ModelLoadResult {
+    code: 200 | -1;
+    result: string;
+    msg?: string;
+}
+export interface ModelLoadItem {
+    /** 模型 ID；为空时由 filePath 推导 */
+    modelId?: string;
+    /** 下载来源路径（http 完整地址 或 OSS 相对地址），为空表示直接使用 buffer */
+    filePath?: string;
+    /** 已下载好的模型二进制（filePath 为空时必填） */
+    buffer?: ArrayBuffer;
+    /** 已就绪的 meta 二进制（可选） */
+    metaBuffer?: ArrayBuffer;
+    /** 透传引擎 cfg：{ position, scale, rotation, matrix, origin, brightness, ... } */
+    options?: Record<string, any>;
+}
+export interface ModelLoaderConfig {
+    /** 模型类型（xtc / glb / ifc），默认 xtc */
+    modelType?: string;
+    /** 是否加载 meta（.xts）；不传则运行时取 getConfig("loadMeta") */
+    loadMeta?: boolean;
+    /** 事件回调：modelLoaded / metaLoading / metaLoaded */
+    emit?: (event_name: string, content: any) => void;
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 各自就绪即加载（默认推荐），默认 true */
+    sequential?: boolean;
+    /** 非顺序加载时的发起间隔毫秒数（仅作节流），默认 0 表示不节流 */
+    loadInterval?: number;
+}
 /**
  * BIMX 模型加载
  * @param modelId 模型 ID
@@ -31,4 +60,63 @@ export declare function createMetadataTask(modelId: string, options: MetadataTas
  *                - position / rotation / scale / origin / alignTo: 多模型坐标对齐参数
  */
 export default function viewerLoadModel(modelId: string, modelType: string, modelArrayBuffer: ArrayBuffer, callback?: Function, options?: Record<string, any>): void;
+/**
+ * 模型加载器：统一封装「下载 -> 引擎加载 -> meta 加载」。
+ *
+ * 相比逐模型串行「下载-加载」，这里会：
+ *  - 顺序加载时用流水线预取：下载第 i 个模型的同时加载第 i-1 个，让网络与解析重叠；
+ *  - 非顺序加载时所有模型并发下载、就绪即加载；
+ *  - 单文件（model + meta）并发下载；
+ *  - OSS STS client 在 OSSHelper 内缓存复用，不再每个文件都申请一次凭证。
+ */
+export declare class ModelLoader {
+    private modelType;
+    private loadMetaOverride?;
+    private emit;
+    /** 多模型是否顺序加载（默认 true） */
+    private sequential;
+    /** 非顺序加载的发起间隔（毫秒，默认 0 = 不节流） */
+    private loadInterval;
+    private metaBuffer?;
+    private metaReady;
+    private metaEventsBound;
+    private pendingMetaModel?;
+    constructor(config?: ModelLoaderConfig);
+    /** 运行时判断是否加载 meta（跟随 config，避免 setup 阶段 getConfig 尚未就绪） */
+    private getLoadMeta;
+    /** viewer 销毁/重建时重置内部 meta 状态 */
+    reset(): void;
+    /** 外部传入已就绪的 meta buffer（单模型外部 buffer 场景，可能晚于模型到达） */
+    setMetaBuffer(buffer?: ArrayBuffer): void;
+    /** 下载单个文件（http 直连 / OSS），返回 Promise<ArrayBuffer> */
+    private fetch;
+    /** 模型主体下载路径：http 直接用原地址；OSS 补上 .xtc 等类型后缀 */
+    private downloadModelPath;
+    /** 加载单个已就绪 buffer 的模型到引擎，模型成功后自动处理 meta */
+    loadSingle(modelId: string, buffer: ArrayBuffer, metaBuffer?: ArrayBuffer, options?: Record<string, any>): Promise<ModelLoadResult>;
+    /** 引擎模型加载成功后处理 meta：可用则立即加载，否则挂起等 setMetaBuffer */
+    private handleMetaAfterModelLoad;
+    private loadMetadata;
+    /** 绑定引擎 meta 事件（只绑一次），转发给 emit */
+    private bindMetaEvents;
+    /** 按路径加载单个模型：并发下载 model + meta，下载完再引擎加载；下载失败不抛异常 */
+    loadFromPath(modelId: string, filePath: string, options?: Record<string, any>): Promise<ModelLoadResult | undefined>;
+    /** 下载 meta（.xts）；失败不阻断主流程 */
+    private downloadMeta;
+    /** 准备单个模型：并发下载 model + meta，返回可直接加载的数据；下载失败 buffer 为空（不抛异常） */
+    private prepareItem;
+    /**
+     * 多模型加载。
+     *
+     * sequential=true：一个一个来，等当前模型 loaded 后再加载下一个。
+     * sequential=false（对齐 xtctwins 示例用法）：所有模型同时开始下载，
+     *   「谁的 buffer 先到就立即加载谁」，互不等待、默认不插入任何延迟。
+     *   这样下载与解析天然重叠，是引擎下最快的加载方式。
+     *
+     * loadInterval 仅作为可选的发起节流（默认 0 不节流）。
+     */
+    loadMulti(items: ModelLoadItem[]): Promise<ModelLoadResult[]>;
+    /** 延迟指定毫秒数 */
+    private sleep;
+}
 export {};