@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/modelmaterialedit/index.js

@@ -40,10 +40,18 @@ const MATERIAL_PART = {
   DEFAULT: -1
 };
 class ModelMaterialEditViewModel {
+  /**
+   * @description 构造函数，初始化场景视图与表单配置
+   * @param {Object} sceneView 三维场景视图
+   * @param {Object} formItem 表单配置项
+   */
   constructor(sceneView, formItem) {
     this._options = {};
+    // 表单配置项
     this._sceneView = null;
+    // 三维场景视图
     this._buildModels = [];
+    // 当前编辑的构建模型集合
     this._language = null;
     this._sceneView = sceneView;
     this._options = formItem;
@@ -53,14 +61,22 @@ class ModelMaterialEditViewModel {
     this._language = locale;
   }
 
-  // 获取模型
+  /**
+   * @description 获取模型
+   * @param {Array} keys 模型 key 列表
+   * @returns {Array} 匹配到的构建模型集合
+   */
   getBuildModels(keys) {
     const primitives = this._sceneView?._viewer?.scene?.primitives?._primitives ?? [];
     this._buildModels = primitives.filter(element => element?._key && keys.includes(element._key));
     return this._buildModels;
   }
 
-  // 参数切换
+  /**
+   * @description 参数切换
+   * @param {String} key 参数名
+   * @param {*} val 参数值
+   */
   paramsChanged(key, val) {
     if (!this._buildModels?.length) {
       this._showNoDataMessage();
@@ -79,7 +95,10 @@ class ModelMaterialEditViewModel {
     }
   }
 
-  // 处理材质变更
+  /**
+   * @description 处理材质变更
+   * @param {*} val 材质值
+   */
   _handleMaterialChange(val) {
     this._buildModels.forEach(element => {
       const materialConfig = this._getMaterialConfig(element);
@@ -120,11 +139,21 @@ class ModelMaterialEditViewModel {
     });
   }
 
-  // 处理道路放样的重复模式
+  /**
+   * @description 处理道路放样的重复模式
+   * @param {Object} element 模型对象
+   * @param {Number} materialPart 材质部位
+   * @param {Number} repeatBySize 重复模式（0：按尺寸，1：按次数）
+   * @param {Number} repeatWidth 重复宽度
+   * @param {Number} repeatHeight 重复高度
+   * @param {Number} repeatCountX X 方向重复次数
+   * @param {Number} repeatCountY Y 方向重复次数
+   */
   _handleRoadLoftingRepeat(element, materialPart, repeatBySize, repeatWidth, repeatHeight, repeatCountX, repeatCountY) {
     const isRepeatBySize = repeatBySize === REPEAT_MODE.BY_SIZE;
     element.repeatBySize = isRepeatBySize;
     if (materialPart === MATERIAL_PART.WALL) {
+      // 墙体部位：按尺寸或按次数设置纹理重复参数
       if (isRepeatBySize) {
         element.wallTextureWidth = repeatWidth || 3;
         element.wallTextureHeight = repeatHeight || 3;
@@ -133,6 +162,7 @@ class ModelMaterialEditViewModel {
         element.wallTextureRepeatY = repeatCountY || 1;
       }
     } else if (materialPart === MATERIAL_PART.WALL_TOP) {
+      // 墙顶部位：按尺寸或按次数设置纹理重复参数
       if (isRepeatBySize) {
         element.wallTopTextureWidth = repeatWidth || 3;
         element.wallTopTextureHeight = repeatHeight || 3;
@@ -143,7 +173,14 @@ class ModelMaterialEditViewModel {
     }
   }
 
-  // 处理管道放样的重复模式
+  /**
+   * @description 处理管道放样的重复模式
+   * @param {Object} element 模型对象
+   * @param {Number} materialPart 材质部位
+   * @param {Number} repeatBySize 重复模式（0：按尺寸，1：按次数）
+   * @param {Number} repeatCountX X 方向重复次数
+   * @param {Number} repeatCountY Y 方向重复次数
+   */
   _handlePipelineLoftingRepeat(element, materialPart, repeatBySize, repeatCountX, repeatCountY) {
     if (repeatBySize === REPEAT_MODE.BY_COUNT && materialPart === MATERIAL_PART.DEFAULT) {
       element.repeatX = repeatCountX || 1;
@@ -151,7 +188,10 @@ class ModelMaterialEditViewModel {
     }
   }
 
-  // 处理颜色变更
+  /**
+   * @description 处理颜色变更
+   * @param {String} val 颜色值
+   */
   _handleColorChange(val) {
     this._buildModels.forEach(element => {
       if (element) {
@@ -160,7 +200,11 @@ class ModelMaterialEditViewModel {
     });
   }
 
-  // 获取材质配置
+  /**
+   * @description 获取材质配置
+   * @param {Object} element 模型对象
+   * @returns {Object} 材质配置
+   */
   _getMaterialConfig(element) {
     const modelingType = element?._modelingType;
     const materialPart = this._options?.materialPart;
@@ -168,7 +212,12 @@ class ModelMaterialEditViewModel {
     return config[materialPart];
   }
 
-  // 应用材质配置
+  /**
+   * @description 应用材质配置
+   * @param {Object} element 模型对象
+   * @param {Object} config 材质配置
+   * @param {*} val 材质值
+   */
   _applyMaterialConfig(element, config, val) {
     const {
       key,
@@ -197,9 +246,13 @@ class ModelMaterialEditViewModel {
       type: "info"
     });
   }
+
+  // 清空构建模型集合
   clear() {
     this._buildModels = [];
   }
+
+  // 销毁并清理资源
   destroy() {
     this.clear();
     // 可选的清理其他资源
@@ -209,6 +262,7 @@ class ModelMaterialEditViewModel {
   }
 }
 exports["default"] = ModelMaterialEditViewModel;
+// 语言配置
 // 材质配置映射
 ModelMaterialEditViewModel.MATERIAL_CONFIG = {
   roadLofting: {
@@ -303,10 +357,11 @@ var _default = exports.A = {
     emit: __emit
   }) {
     const props = __props;
-    const refreshKey = (0, _vue.ref)(0);
-    const emit = __emit;
+    const refreshKey = (0, _vue.ref)(0); // 级联选择器刷新 key
+    const emit = __emit; // 自定义事件：v-model 更新、目录选中
     const selectedPath = (0, _vue.ref)(props.modelValue); // 使用 props.modelValue
 
+    // 级联选择器字段映射配置
     const cascaderProps = {
       value: "id",
       label: "name",
@@ -315,6 +370,8 @@ var _default = exports.A = {
       emitPath: true,
       multiple: false
     };
+
+    // 目录树选项数据（仅保留有子节点的目录）
     const directoryOptions = (0, _vue.computed)(() => {
       const filterDirectories = nodes => {
         if (!nodes) return [];
@@ -334,7 +391,11 @@ var _default = exports.A = {
       return filterDirectories(props.materials);
     });
 
-    // 根据路径查找节点对象（实时查找）
+    /**
+     * @description 根据路径查找节点对象（实时查找）
+     * @param {Array} path 路径 id 数组
+     * @returns {Object|null} 节点对象
+     */
     const getNodeByPath = path => {
       if (!path || path.length === 0) return null;
       const findNode = (nodes, pathArray) => {
@@ -349,7 +410,10 @@ var _default = exports.A = {
       return findNode(props.materials, path);
     };
 
-    // 选中目录事件
+    /**
+     * @description 选中目录事件
+     * @param {Array} pathValues 选中路径 id 数组
+     */
     const handleDirectoryChange = pathValues => {
       if (!pathValues || pathValues.length === 0) {
         // 清除操作时，重置为根目录
@@ -372,6 +436,11 @@ var _default = exports.A = {
         });
       }
     };
+    /**
+     * @description 根据名称查找节点对象
+     * @param {String} name 节点名称
+     * @returns {Object|null} 节点对象
+     */
     const getNodeByName = name => {
       const findNode = (nodes, targetName) => {
         if (!nodes) return null;
@@ -388,7 +457,11 @@ var _default = exports.A = {
       };
       return findNode(props.materials, name);
     };
-    // 通过ID获取完整路径
+    /**
+     * @description 通过ID获取完整路径
+     * @param {String} id 节点 id
+     * @returns {Array|null} 路径 id 数组
+     */
     const getPathById = id => {
       const findPath = (nodes, targetId, currentPath = []) => {
         if (!nodes) return null;
@@ -406,11 +479,16 @@ var _default = exports.A = {
       };
       return findPath(props.materials, id);
     };
+    /**
+     * @description 根据节点 id 设置选中路径并同步父组件
+     * @param {String} id 节点 id
+     */
     const setSelectedPath = id => {
       const path = getPathById(id) || ["root"];
       selectedPath.value = path;
       emit("update:modelValue", path); // 同步到父组件
     };
+    // 刷新级联选择器（预留）
     const refreshCascader = () => {
       // refreshKey.value++;
     };
@@ -554,8 +632,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       lang,
       locale
     } = (0, _useGlobalConfig.useLocale)();
-    let accept = ".png,.jpg";
-    const emit = __emit;
+    let accept = ".png,.jpg"; // 允许上传的图片后缀
+    const emit = __emit; // 自定义事件：添加目录、上传图片、删除图片
     // 获取组件传参
     const props = __props;
     // 关联数据
@@ -595,7 +673,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 重复次数-长
       repeatCountY: props?.settingParams?.repeatCountY ?? 1 // 重复次数-宽
     });
-    const repeatModes = (0, _vue.ref)([locale.value.webgl.actualSize, locale.value.webgl.repeatCount]);
+    const repeatModes = (0, _vue.ref)([locale.value.webgl.actualSize, locale.value.webgl.repeatCount]); // 重复模式选项
     // 材质列表
     let materialDirectorys = (0, _vue.computed)(() => [{
       id: "root",
@@ -620,7 +698,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
     let headerTempRef = (0, _vue.ref)();
-    let viewModel = null;
+    let viewModel = null; // 材质编辑视图模型实例
+    // 组件挂载后初始化位置、监听 header 生成及视图模型
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.materials, () => {
@@ -643,10 +722,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       });
     });
+    // 打开添加目录对话框
     const openAddFolderDialog = () => {
       folderForm.name = "";
       showFolderDialog.value = true;
     };
+    // 关闭添加目录对话框时重置表单
     const handleDialogClosed = () => {
       folderForm.name = "";
       showFolderDialog.value = false;
@@ -663,6 +744,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       if (!currentNode.children) {
         currentNode.children = [];
       }
+      // 重名目录校验
       const exists = currentNode.children.some(child => child.name === folderForm.name && child.children);
       if (exists) {
         _message.default.warning(locale.value.webgl.duplicateDirectory);
@@ -688,11 +770,18 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       return currentNode?.children || [];
     });
 
-    // 处理目录选择
+    /**
+     * @description 处理目录选择
+     * @param {Object} event 选中事件对象（包含 path、node）
+     */
     const handleDirectorySelect = event => {
       // 如果需要处理节点相关的其他逻辑
       if (event.node) {}
     };
+    /**
+     * @description 点击缩略项：目录则进入，图片则切换材质
+     * @param {Object} item 缩略项数据
+     */
     const clickItem = item => {
       if (item.children) {
         item.id && cascaderRef?.value?.setSelectedPath(item.id);
@@ -705,7 +794,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function resetMaterial() {
       viewModel?.paramsChanged?.("changImage", "null");
     }
-    // 上传图片
+    /**
+     * @description 上传图片
+     * @param {Object} file 上传文件对象
+     */
     const handleImageChange = file => {
       const reader = new FileReader();
       const currentNode = cascaderRef.value?.getCurrentNode();
@@ -740,7 +832,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         cascaderKey.value++;
       });
     };
-    // 删除目录和图片
+    /**
+     * @description 删除目录和图片
+     * @param {Object} item 缩略项数据
+     */
     const deleteItem = item => {
       const itemName = item.name;
       const itemType = item.children ? locale.value.webgl.directory : locale.value.webgl.image;
@@ -776,14 +871,20 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.modelMaterialEditTitle");
       }
     };
-    //
+    /**
+     * @description 参数改变时同步至视图模型
+     * @param {String} key 参数名
+     */
     function paramsChanged(key) {
       if (viewModel) {
         viewModel._options[key] = formItem[key];
         viewModel.paramsChanged(key, formItem[key]);
       }
     }
-    // 设置数据
+    /**
+     * @description 设置数据
+     * @param {Array|String} guids 模型 guid 列表
+     */
     function setData(guids) {
       if (!guids) return;
       if (!viewModel) return;
@@ -792,6 +893,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       if (guidArray.length === 0) return;
       viewModel.getBuildModels(guidArray);
     }
+    // 清空选中模型集合
     function clear() {
       viewModel?.clear();
     }
@@ -1640,11 +1742,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })

package/modelprofileanalysis/index.js

@@ -31,9 +31,15 @@ var _useGlobalConfig = __webpack_require__(22686);
 //剖面分析逻辑类
 let floatingPoint;
 let drawPoints = (/* unused pure expression or super */ null && ([]));
-let activeShapePoints = [];
+let activeShapePoints = []; //当前绘制的剖面点数组
 let activeCartographicPoints = (/* unused pure expression or super */ null && ([]));
 class ModelProfileAnalysisViewModel {
+  /**
+   * @description 构造函数，初始化viewer、剖面分析对象、屏幕事件处理器及结果显示canvas
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} viewModel 表单参数对象
+   * @param {HTMLElement} chart 结果显示DOM元素
+   */
   constructor(scenceView, viewModel, chart) {
     this._profileAnalysis = null;
     //剖面分析三维对象
@@ -103,6 +109,7 @@ class ModelProfileAnalysisViewModel {
       this.remove();
       let that = this;
       this._globaOptions._handler.removeInputAction(window.Cesium.ScreenSpaceEventType.LEFT_CLICK);
+      // 注册左键点击事件，收集剖面点
       this._globaOptions._handler.setInputAction(function (event) {
         var earthPosition = that._globaOptions.viewer.scene.pickPosition(event.position);
         if (window.Cesium.defined(earthPosition)) {
@@ -132,13 +139,18 @@ class ModelProfileAnalysisViewModel {
         that._drawManager.clearDrawGroup("ModelProfileAnalysis");
       }, "ModelProfileAnalysis");
     } else {
+      // 未添加模型时给出警告
       (0, _message.default)({
         message: this._language.value.webgl["addModelTips"],
         type: "warning"
       });
     }
   }
-  //绘制点
+  /**
+   * @description 绘制点
+   * @param {Object} worldPosition 世界坐标
+   * @returns {Object} 点实体
+   */
   createPoint(worldPosition) {
     var point = this._globaOptions.viewer.entities.add({
       position: worldPosition,
@@ -156,6 +168,7 @@ class ModelProfileAnalysisViewModel {
       this._profileAnalysis.angle = this._globaOptions.viewModel.angle;
       this._profileAnalysis.extendWidth = this._globaOptions.viewModel.extendWidth;
       this._profileAnalysis.cameraHeight = this._globaOptions.viewModel.cameraHeight;
+      this._profileAnalysis._cameraHeight = this._globaOptions.viewModel.cameraHeight;
       this._profileAnalysis.isPerspective = this._globaOptions.viewModel.isPerspective;
       if (this._globaOptions._handler) {
         let buffer = this._profileAnalysis.updateBuffer();
@@ -167,7 +180,10 @@ class ModelProfileAnalysisViewModel {
       }
     }
   }
-  //获取单线剖面分析纹理
+  /**
+   * @description 获取单线剖面分析纹理并绘制到结果canvas上
+   * @param {Array} buffer 像素缓冲数据
+   */
   getPorfileAnalysisTexture(buffer) {
     if (buffer) {
       this._globaOptions.canvas.height = this._globaOptions.height;
@@ -176,6 +192,7 @@ class ModelProfileAnalysisViewModel {
 
       // flipY
       var line = this._globaOptions.width * 4;
+      // 纵向翻转像素数据
       for (let h = 0; h < this._globaOptions.height; h++) {
         for (let w = 0; w < this._globaOptions.width; w++) {
           for (let n = 0; n < 4; n++) {
@@ -185,7 +202,7 @@ class ModelProfileAnalysisViewModel {
       }
       this._globaOptions.ctx.putImageData(imgData, 0, 0);
 
-      //=====================
+      //===================== 绘制目标区域边框
       this._globaOptions.ctx.setLineDash([20, 5]);
       this._globaOptions.ctx.lineWidth = 1;
       this._globaOptions.ctx.strokeStyle = "#ff2";
@@ -197,7 +214,7 @@ class ModelProfileAnalysisViewModel {
       this._globaOptions.ctx.lineTo(360 - fLeft, 360);
       this._globaOptions.ctx.stroke();
 
-      //=====================
+      //===================== 绘制剖面长度/高度文本
       let str = String(this._profileAnalysis._frustumW.toFixed(2));
       let str1 = this._language.value.webgl.profileLength + " : " + str + "m";
       str = String(this._profileAnalysis._maxW.toFixed(2));
@@ -216,32 +233,50 @@ class ModelProfileAnalysisViewModel {
       this._globaOptions.ctx.fillText(str4, 10, 80);
     }
   }
-  // 是否透视
+  /**
+   * @description 是否透视
+   * @param {Boolean} val 是否透视
+   */
   setEnablePerspective(val) {
     this._globaOptions.viewModel.isPerspective = val;
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
-  // 透视角度
+  /**
+   * @description 透视角度
+   * @param {Number} val 透视角度值
+   */
   setPerspectiveAngle(val) {
     this._globaOptions.viewModel.angle = val;
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
-  // 目标区域宽度
+  /**
+   * @description 目标区域宽度
+   * @param {Number} val 宽度值
+   */
   setTargetAreaWidth(val) {
     this._globaOptions.viewModel.extendWidth = val;
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
-  // 目标区域高度
+  /**
+   * @description 目标区域高度
+   * @param {Number} val 高度值
+   */
   setTargetAreaHeight(val) {
     this._globaOptions.viewModel.frustumH = val;
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
-  // 相机高度
+  /**
+   * @description 相机高度
+   * @param {Number} val 相机高度值
+   */
   setCameraHeight(val) {
     this._globaOptions.viewModel.cameraHeight = val;
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
-  // 切换语言
+  /**
+   * @description 切换语言
+   * @param {String} lang 语言标识
+   */
   changeLanguage(lang) {
     if (this._ProfileAnalysisChartVis.value) this.updatePorfileAnalysis();
   }
@@ -1637,6 +1672,7 @@ const __default__ = {
 };
 var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   props: {
+    // 指定组件绑定的viewer对象的div的id
     mapTarget: {
       type: String
     },
@@ -1742,6 +1778,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       });
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
+          // 初始化剖面分析逻辑类并绑定结果图表DOM
           viewModel = new _ModelProfileAnalysisViewModel.default(scenceView, {
             perspectiveAngle: formItem.perspectiveAngle,
             // 透视角度
@@ -2342,11 +2379,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })