@xtctwins/tctwins-bimx-engine 0.3.5 → 0.3.7

package/dist/{tallPanel-8Rc6OZ8T.mjs → tallPanel-CHmr0WiN.mjs}

@@ -1,4 +1,4 @@
-import { o as g, p as t, T as r, A as y, B as x, x as S, y as b } from "./index-Cg9YgLyf.mjs";
+import { o as g, p as t, T as r, A as y, B as x, x as S, y as b } from "./index-B9qL5nx5.mjs";
 import { defineComponent as k, ref as c, onMounted as P, watch as W, openBlock as _, createElementBlock as f, normalizeStyle as w, createElementVNode as o, toDisplayString as C, createVNode as T, unref as h, renderSlot as N, createCommentVNode as B } from "vue";
 const E = { class: "tall_panel_content" }, $ = { class: "panel_top" }, H = { class: "panel_title" }, L = { class: "panel_close" }, A = { class: "panel_content" }, M = {
   key: 0,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xtctwins/tctwins-bimx-engine",
-	"version": "0.3.5",
+	"version": "0.3.7",
 	"main": "dist/BIMX_Viewer_Lib.umd.js",
 	"style": "dist/style.css",
 	"module": "dist/BIMX_Viewer_Lib.es.js",
@@ -38,7 +38,7 @@
 		"@vue/eslint-config-prettier": "^9.0.0",
 		"@vue/eslint-config-typescript": "^13.0.0",
 		"@vue/tsconfig": "^0.5.1",
-		"@xtctwins/tctwins-bimx-engine": "^0.3.4",
+		"@xtctwins/tctwins-bimx-viewer": "^1.1.3",
 		"ali-oss": "^6.20.0",
 		"axios": "^1.7.3",
 		"element-plus": "^2.8.0",

package/types/components/BimxViewerComp.vue.d.ts

@@ -12,6 +12,10 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
+    loadSequential?: boolean;
+    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
+    loadInterval?: number;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     emitHandler: (...args: any[]) => void;
 }, string, import('vue').PublicProps, Readonly<{
@@ -27,6 +31,10 @@ declare const _default: import('vue').DefineComponent<{
     modelIds?: string[];
     /** 每个模型的变换选项（与 modelIds 一一对应）：{ position, scale, rotation, matrix, origin } */
     modelOptions?: Record<string, any>[];
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
+    loadSequential?: boolean;
+    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
+    loadInterval?: number;
 }> & Readonly<{
     onEmitHandler?: ((...args: any[]) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/types/pages/BimxViewerEntry.vue.d.ts

@@ -14,6 +14,10 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
+    loadSequential?: boolean;
+    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
+    loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
     bottomHeight?: number;
@@ -72,6 +76,10 @@ declare const _default: import('vue').DefineComponent<{
     multiModel?: boolean;
     filePaths?: string[];
     modelIds?: string[];
+    /** 多模型是否顺序加载：true 等待每个模型加载完成再加载下一个；false 按 loadInterval 毫秒间隔依次发起，默认 true */
+    loadSequential?: boolean;
+    /** 非顺序加载时发起下一个模型的间隔毫秒数，默认 200 */
+    loadInterval?: number;
     themeColor?: ThemeColor;
     topHeight?: number;
     bottomHeight?: number;

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/viewerManager/load/loadModel.d.ts

@@ -1 +1,94 @@
+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 按 loadInterval 间隔依次发起，默认 true */
+    sequential?: boolean;
+    /** 非顺序加载时，发起下一个模型的间隔毫秒数，默认 200 */
+    loadInterval?: number;
+}
+/**
+ * BIMX 模型加载
+ * @param modelId 模型 ID
+ * @param modelType 模型类型（xtc / glb / ifc）
+ * @param modelArrayBuffer 模型二进制数据
+ * @param callback 加载结果回调
+ * @param options 附加加载参数，透传给接口层 BIMXViewer.loadModel 的 cfg：
+ *                - brightness: 该模型的颜色亮度系数（1.0 原始，>1 提亮，<1 变暗），如 { brightness: 1.5 }
+ *                - position / rotation / scale / origin / alignTo: 多模型坐标对齐参数
+ */
 export default function viewerLoadModel(modelId: string, modelType: string, modelArrayBuffer: ArrayBuffer, callback?: Function, options?: Record<string, any>): void;
+/**
+ * 模型加载器：统一封装「下载 -> 引擎加载 -> meta 加载」。
+ *
+ * 相比逐模型串行「下载-加载」，这里会：
+ *  - 多模型时先并发下载全部模型 + meta，再串行交给引擎（消除模型间的网络间隔）；
+ *  - 单文件（model + meta）也是并发下载；
+ *  - OSS STS client 在 OSSHelper 内缓存复用，不再每个文件都申请一次凭证。
+ */
+export declare class ModelLoader {
+    private modelType;
+    private loadMetaOverride?;
+    private emit;
+    /** 多模型是否顺序加载（默认 true） */
+    private sequential;
+    /** 非顺序加载的发起间隔（毫秒，默认 200） */
+    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;
+    /**
+     * 多模型加载：先并发下载全部模型（含 meta），再交给引擎加载。
+     *
+     * 引擎加载调度由 config.sequential 决定：
+     *  - sequential=true（默认）：等待每个模型加载完成后再加载下一个（原循环方式）；
+     *  - sequential=false：不等每个模型加载完成，按 loadInterval 毫秒间隔依次发起下一个。
+     * @returns 每个模型的加载结果
+     */
+    loadMulti(items: ModelLoadItem[]): Promise<ModelLoadResult[]>;
+    /** 延迟指定毫秒数 */
+    private sleep;
+}

package/types/viewerManager/viewerManager.d.ts

@@ -10,6 +10,18 @@ export default class ViewerManager {
         edgesObjectIds: string[];
     };
     static ConfigViewer(eventTarget?: string): void;
+    /**
+     * 设置指定模型的颜色亮度（如贴图模型发暗补偿）
+     * @param modelId 模型 ID
+     * @param brightness 亮度系数，1.0 为原始亮度，>1 提亮，<1 变暗
+     */
+    static SetModelBrightness(modelId: string, brightness: number): void;
+    /**
+     * 获取指定模型的颜色亮度
+     * @param modelId 模型 ID
+     * @returns 亮度系数，未找到模型时返回 undefined
+     */
+    static GetModelBrightness(modelId: string): number | undefined;
     static SaveViewerState(content: any): void;
     static SetToolActiveById(id: number, active?: boolean): void;
     static SetToolActiveByKey(key: string, active?: boolean): void;