@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/lowaltitudefeature/style/index.js

@@ -0,0 +1,3 @@
+"use strict";
+
+require("./lowaltitudefeature.css");

package/lowaltitudefeature/style/lowaltitudefeature.css

@@ -0,0 +1 @@
+.kq-low-altitude-feature{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;padding:16px;font-size:13px;color:#333;overflow:hidden;padding:var(--kq-box-padding);border-radius:var(--kq-border-radius-base);background-color:var(--kq-bg-color)}.kq-low-altitude-feature .kq-box-shadow{-webkit-box-shadow:0 2px 12px rgba(0,0,0,.1);box-shadow:0 2px 12px rgba(0,0,0,.1)}.kq-low-altitude-feature-box{display:-webkit-box;display:-ms-flexbox;display:flex;width:100%;height:100%;min-height:400px}.kq-laf-left-panel{width:280px;min-width:240px;height:800px;border-right:1px solid #e4e7ed;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column}.kq-laf-left-panel .kq-laf-list-header{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;padding:12px 16px;border-bottom:1px solid #ebeef5}.kq-laf-left-panel .kq-laf-list-header .kq-laf-title{font-size:14px;font-weight:600;color:#303133}.kq-laf-left-panel .kq-laf-list-header .kq-laf-header-icon{color:#909399;cursor:pointer}.kq-laf-left-panel .kq-laf-list-header .kq-laf-header-icon:hover{color:#409eff}.kq-laf-left-panel .kq-laf-search{padding:8px 12px;border-bottom:1px solid #ebeef5}.kq-laf-left-panel .kq-laf-tree-scroll{-webkit-box-flex:1;-ms-flex:1;flex:1;overflow:hidden}.kq-laf-left-panel .kq-laf-tree-scroll .el-scrollbar__wrap{overflow-x:hidden}.kq-laf-left-panel .kq-tree{background:transparent;padding:4px 0}.kq-laf-left-panel .kq-tree .el-tree-node__content{height:36px;line-height:36px}.kq-laf-left-panel .kq-tree .el-tree-node__content:hover{background-color:#f5f7fa}.kq-laf-left-panel .kq-tree .el-tree-node__content:has(.kq-laf-category-name){font-weight:500}.kq-laf-left-panel .kq-laf-tree-label{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%;padding-right:8px;-webkit-box-sizing:border-box;box-sizing:border-box}.kq-laf-left-panel .kq-laf-category-name{-webkit-box-flex:1;-ms-flex:1;flex:1;font-weight:500;font-size:13px;color:#303133;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding-right:6px}.kq-laf-left-panel .kq-laf-add-btn{color:#409eff;opacity:.8;cursor:pointer;-ms-flex-negative:0;flex-shrink:0}.kq-laf-left-panel .kq-laf-add-btn:hover{opacity:1;color:#337ecc}.kq-laf-left-panel .kq-laf-feature-row{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;width:100%}.kq-laf-left-panel .kq-laf-feature-row .kq-laf-feature-name{-webkit-box-flex:1;-ms-flex:1;flex:1;font-size:12px;color:#606266;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;margin-right:6px}.kq-laf-left-panel .kq-laf-feature-row .kq-laf-feature-actions{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:2px;opacity:0;-webkit-transition:opacity .15s;transition:opacity .15s}.kq-laf-left-panel .kq-laf-feature-row:hover .kq-laf-feature-actions{opacity:1}.kq-laf-left-panel .kq-laf-action-btn{padding:2px 3px;border-radius:3px;cursor:pointer;color:#909399;-webkit-transition:all .15s;transition:all .15s}.kq-laf-left-panel .kq-laf-action-btn:hover{background-color:rgba(64,158,255,.1);color:#409eff}.kq-laf-left-panel .kq-laf-action-btn.active,.kq-laf-left-panel .kq-laf-action-btn.kq-laf-grid-btn.active,.kq-laf-left-panel .kq-laf-action-btn.kq-laf-grid-btn:hover{color:#67c23a}.kq-laf-left-panel .kq-laf-action-btn.kq-laf-edit-btn:hover{color:#e6a23c}.kq-laf-left-panel .kq-laf-action-btn.kq-laf-zoom-btn:hover{color:#409eff}.kq-laf-left-panel .kq-laf-action-btn.kq-laf-delete-btn:hover{color:#f56c6c}.kq-laf-left-panel .kq-laf-empty{padding:16px;text-align:center;color:#c0c4cc;font-size:12px}.kq-laf-right-panel{-webkit-box-flex:1;-ms-flex:1;flex:1;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;min-width:140px;max-width:420px;width:420px}.kq-laf-right-panel .kq-laf-panel-header{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;padding:12px 16px;border-bottom:1px solid #ebeef5;-ms-flex-negative:0;flex-shrink:0}.kq-laf-right-panel .kq-laf-panel-header .kq-laf-panel-title{font-size:14px;font-weight:600;color:#303133}.kq-laf-right-panel .kq-laf-panel-header .kq-laf-collapse-btn{color:#909399;cursor:pointer}.kq-laf-right-panel .kq-laf-panel-header .kq-laf-collapse-btn:hover{color:#409eff}.kq-laf-right-panel .kq-laf-panel-body{-webkit-box-flex:1;-ms-flex:1;flex:1;overflow-y:auto;padding:16px}.kq-laf-toolbar{display:-webkit-box;display:-ms-flexbox;display:flex;gap:8px;padding:12px 0;border-bottom:1px solid #f0f0f0;margin-bottom:16px;-ms-flex-wrap:wrap;flex-wrap:wrap}.kq-laf-toolbar .el-divider--vertical,.kq-laf-toolbar .kq-divider--vertical{height:36px;margin:0 20px}.kq-laf-toolbar .kq-laf-tool-btn{width:36px!important;height:36px!important}.kq-laf-symbol-settings{border-top:1px solid #ebeef5;padding-top:12px;margin-top:8px}.kq-laf-symbol-settings .kq-laf-settings-header{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:center;-ms-flex-align:center;align-items:center;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;padding:8px 0;cursor:pointer;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;font-weight:500;font-size:13px;color:#303133}.kq-laf-symbol-settings .kq-laf-settings-header:hover{color:#409eff}.kq-laf-symbol-settings .kq-laf-settings-header .kq-icon{color:#909399;-webkit-transition:-webkit-transform .2s;transition:-webkit-transform .2s;transition:transform .2s;transition:transform .2s, -webkit-transform .2s}.kq-laf-symbol-settings .kq-laf-settings-header .kq-icon.is-active{-webkit-transform:rotate(90deg);-ms-transform:rotate(90deg);transform:rotate(90deg)}.kq-laf-symbol-settings .kq-laf-settings-body{padding:8px 0}.kq-laf-symbol-settings .kq-laf-settings-body .kq-form-item{margin-bottom:8px}.kq-laf-symbol-settings .kq-laf-settings-body .kq-form-item:last-child{margin-bottom:0}.kq-laf-symbol-settings .kq-laf-settings-body .el-radio-group{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:8px 16px;min-height:32px}.kq-laf-symbol-settings .kq-laf-settings-body .el-radio-group .el-radio{margin-right:0;white-space:nowrap}.kq-laf-symbol-settings .el-slider,.kq-laf-symbol-settings .kq-slider{width:calc(100% - 18px);margin-right:var(--kq-box-padding)}.kq-laf-setting-row{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-align:start;-ms-flex-align:start;align-items:flex-start;margin-bottom:14px}.kq-laf-setting-row .kq-laf-setting-label{-ms-flex-negative:0;flex-shrink:0;width:80px;font-size:12px;color:#606266;line-height:32px;text-align:right;padding-right:8px}.kq-laf-setting-row .kq-laf-slider-wrap{-webkit-box-flex:1;-ms-flex:1;flex:1;min-width:180px;width:300px}.kq-laf-setting-row .kq-laf-slider-wrap .el-slider .el-slider__input{width:70px}.kq-laf-setting-row .kq-laf-radio-group{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-align:center;-ms-flex-align:center;align-items:center;gap:12px 20px;min-height:32px}.kq-laf-setting-row .kq-laf-radio-group .kq-radio{margin-right:0;white-space:nowrap}.kq-laf-setting-row .kq-laf-radio-group.kq-laf-buffer-types{gap:8px 16px}.kq-laf-setting-row .el-slider,.kq-laf-setting-row .kq-slider{width:calc(100% - 18px);margin-right:var(--kq-box-padding)}.kq-laf-panel-footer{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;gap:10px;padding-top:16px;border-top:1px solid #ebeef5;margin-top:8px}@media screen and (max-width:800px){.kq-low-altitude-feature-box{-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column}.kq-laf-left-panel{width:100%;min-width:auto;max-height:250px;border-right:none;border-bottom:1px solid #e4e7ed}.kq-laf-right-panel{max-width:none}}

package/measure/index.js

@@ -255,19 +255,20 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     } = (0, _useGlobalConfig.useLocale)();
     const props = __props;
     let measureType = (0, _vue.ref)(null); // 测量类型
-    let isActive = (0, _vue.ref)(null);
-    let isResult = (0, _vue.ref)(false);
-    let isTips = (0, _vue.ref)(false);
-    let distanceValue = null;
+    let isActive = (0, _vue.ref)(null); // 当前激活的测量类型
+    let isResult = (0, _vue.ref)(false); // 是否显示测量结果面板
+    let isTips = (0, _vue.ref)(false); // 是否显示测量提示
+    let distanceValue = null; // 原始距离/面积数值（用于单位换算）
     // 默认显示距离的单位
     let distanceUnit = (0, _vue.ref)(props.settingParams && props.settingParams.distanceUnit || "");
     // 海里单位选择
     let nauticalMileUnit = props.settingParams && props.settingParams.nauticalMileUnit || "nmi";
     // 面积单位
     let areaUnit = (0, _vue.ref)(props.settingParams && props.settingParams.areaUnit || "");
-    let result = (0, _vue.ref)(0);
-    let mode = (0, _vue.ref)("space");
-    let viewModel = null;
+    let result = (0, _vue.ref)(0); // 测量结果显示值
+
+    let mode = (0, _vue.ref)("space"); // 测量模式：space/ground/model
+    let viewModel = null; // 测量视图模型实例
     (0, _vue.watch)(() => lang.value, (newVal, oldVal) => {
       distanceUnits.value = setDistanceUnits();
       areaUnits.value = setAreaUnits();
@@ -483,7 +484,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       });
     });
-    // 经纬度转度分秒
+    /** @description 经纬度转度分秒
+     * @param {Number} val 经纬度数值
+     * @returns {String} 度分秒格式字符串
+     */
     function convertXY(val) {
       if (!val) {
         return "";
@@ -511,6 +515,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         });
       }
     };
+
+    /** @description 格式化距离数值，自动选择 m/km 单位
+     * @param {Number} dis 距离数值（米）
+     * @returns {String} 带单位的距离字符串
+     */
     function formatDistance(dis) {
       if (dis > 5000) {
         dis = dis / 1000;
@@ -520,6 +529,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       return dis.toFixed(2) + " " + distanceUnit.value;
     }
+
+    /** @description 格式化面积数值，自动选择 m²/km² 单位
+     * @param {Number} area 面积数值（平方米）
+     * @returns {String} 带单位的面积字符串
+     */
     function formatArea(area) {
       areaUnit.value = "m²";
       if (area > 1000000) {
@@ -640,6 +654,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 继续连续测量
     function continueMeasure() {
       setTimeout(() => {
         switch (measureType.value) {
@@ -1451,8 +1467,14 @@ var _useGlobalConfig = __webpack_require__(22686);
 //测量操作类
 
 class MeasureViewModel {
+  // 当前语言包
+  /** @description 构造函数，初始化测量视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Boolean} exaggerateCompute 是否启用夸张计算
+   */
   constructor(scenceView, exaggerateCompute) {
     this._viewer = null;
+    // Cesium Viewer 实例
     this._measureHandler = null;
     //测量三维对象
     this.measureEvent = null;
@@ -1460,7 +1482,9 @@ class MeasureViewModel {
     this.activeEvent = null;
     //活动事件
     this.nauticalMileUnit = "nmi";
+    // 海里单位标识
     this.drawTipsStyle = null;
+    // 绘制提示样式
     this._language = null;
     const {
       locale
@@ -1478,9 +1502,12 @@ class MeasureViewModel {
       this._measureHandler.showDrawTips = scenceView._props.showDrawTipsStyle;
     }
   }
-  // 设置绘制鼠标提示
+  /** @description 设置绘制鼠标提示
+   * @param {Object} params 提示样式参数
+   */
   setDrawTipsStyle(params = {}) {
     if (!this._measureHandler) return;
+    // 空字符串转为 null，避免显示空提示
     const processedParams = Object.entries(params).reduce((acc, [key, value]) => {
       acc[key] = value === '' ? null : value;
       return acc;
@@ -1490,13 +1517,16 @@ class MeasureViewModel {
       ...processedParams
     };
   }
-  //距离测量
+  /** @description 距离测量
+   * @param {String} mode 测量模式：ground/model/空
+   */
   distanceMeasure(mode) {
     this.setDrawTipsStyle({
       beforeDrawText: this._language.value.webgl.measureBeforeDrawText,
       duringDrawText: this._language.value.webgl.measureDuringDrawText
     });
     this._viewer.scene.globe.depthTestAgainstTerrain = true;
+    // 根据模式选择对应测量方式
     if (mode === "ground") {
       this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.TerrainDistance);
     } else if (mode === "model") {
@@ -1516,13 +1546,16 @@ class MeasureViewModel {
     this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.ComplexDistance);
   }
 
-  //面积测量
+  /** @description 面积测量
+   * @param {String} mode 测量模式：ground/model/空
+   */
   areaMeasure(mode) {
     this.setDrawTipsStyle({
       beforeDrawText: this._language.value.webgl.measureBeforeDrawText,
       duringDrawText: this._language.value.webgl.measureDuringDrawText
     });
     this._viewer.scene.globe.depthTestAgainstTerrain = true;
+    // 根据模式选择对应测量方式
     if (mode === "ground") {
       this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.TerrainArea);
     } else if (mode === "model") {
@@ -1578,7 +1611,10 @@ class MeasureViewModel {
     this._viewer.scene.globe.depthTestAgainstTerrain = false;
   }
 
-  //更新距离测量单位
+  /** @description 更新距离测量单位
+   * @param {Object|Number} distanceTotal 距离测量结果，可能是数值或包含 verticalDistance/horizontalDistance 等字段的对象
+   * @param {String} unit 单位标识
+   */
   updateDistanceUnit(distanceTotal, unit) {
     if (this._measureHandler.measureResults) {
       this._measureHandler.measureResults.forEach(measureResult => {
@@ -1595,8 +1631,8 @@ class MeasureViewModel {
           measureResult.label.text = this.convertValueUnit(distanceTotal, unit);
         } else if (measureResult.polyline) {
           // 距离测量结果
-          let labels = measureResult.labels._labels;
-          let positions = measureResult.polyline.positions;
+          const labels = measureResult.labels._labels;
+          const positions = measureResult.polyline.positions;
           let dist = 0;
           if (!Cesium.Color.equals(measureResult.label.fillColor, Cesium.Color.RED)) {
             // 测量过程中实时切换单位
@@ -1625,7 +1661,11 @@ class MeasureViewModel {
     }
   }
 
-  //测量距离数值单位换算
+  /** @description 测量距离数值单位换算
+   * @param {Number} value 数值
+   * @param {String} unit 单位标识
+   * @returns {String} 换算后的带单位字符串
+   */
   convertValueUnit(value, unit) {
     let newValue = "";
     switch (unit) {
@@ -1664,7 +1704,8 @@ class MeasureViewModel {
   // 判断是否加载模型
   checkModelAdded() {
     let isAdd = false;
-    let models = this._viewer.scene.primitives._primitives;
+    const models = this._viewer.scene.primitives._primitives;
+    // 遍历场景图元查找 3D Tileset 模型
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset) {
         isAdd = true;
@@ -1698,11 +1739,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/modelFlat/index.js

@@ -79,6 +79,12 @@ var _gisUtils = __webpack_require__(20064);
 //模型平整逻辑类
 
 class ModelFlatViewModel {
+  /**
+   * @description 构造函数，初始化viewer、绘制管理器、平整纹理对象、测量处理器及图层监听
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} viewModel 表单参数对象
+   * @param {Function} callbackParams 回调函数，用于通知外部状态变化
+   */
   constructor(scenceView, viewModel, callbackParams) {
     this._viewer = null;
     //三维viewer对象
@@ -97,6 +103,7 @@ class ModelFlatViewModel {
     this._assistPolygons = [];
     //平整辅助面数组
     this.currentFlatPolygonIndex = -1;
+    //当前操作的平整实例索引
     this._language = {};
     this.tiles = [];
     this.callbackParams = null;
@@ -110,8 +117,10 @@ class ModelFlatViewModel {
     this._drawManager = scenceView._drawManager;
     //Create flattenning controller
     var that = this;
+    // 创建平整多边形纹理对象
     let kq3dFlattenning = new window.Cesium.Kq3dFlattenning(this._viewer, {});
     this._flatteningPolygonTex = kq3dFlattenning.createFlattenedPolygonTexture();
+    // 实例化测量处理器
     this._measureHandler = new Cesium.Kq3dMeasureHandler(this._viewer);
     if (scenceView._props.showDrawTipsStyle) {
       this._measureHandler.showDrawTips = scenceView._props.showDrawTipsStyle;
@@ -123,10 +132,12 @@ class ModelFlatViewModel {
         }
       };
     }
+    // 测量完成事件：保存测量结果并隐藏标签
     this._measureHandler.measureEvent.addEventListener(function (result) {
       that._measureResult = result;
       result.measureResult.label.show = false;
     });
+    // 测量激活状态变化事件：测量结束时创建平整，并按需连续绘制多个平整
     this._measureHandler.activeEvent.addEventListener(function (ret) {
       if (ret == false) {
         if (that._measureResult) {
@@ -196,6 +207,7 @@ class ModelFlatViewModel {
     var flag = false;
     this.remove();
     var models = this._viewer.scene.primitives._primitives;
+    // 遍历所有3dtiles，对选中模型启用平整并附加纹理
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset && models[i]._url) {
         if (this.tiles.includes(models[i].guid)) {
@@ -209,8 +221,10 @@ class ModelFlatViewModel {
       }
     }
     if (flag) {
+      // 存在模型时启动水平面积测量，触发后续平整创建
       this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.HorizontalArea);
     } else {
+      // 未添加模型时给出警告
       (0, _message.default)({
         message: this._language.value.webgl["addModelTips"],
         type: "warning"
@@ -224,16 +238,23 @@ class ModelFlatViewModel {
       if (model.refresh) model.refresh(tileset, tile.content);
     }
   }
-  // 切换高度重新计算
+  /**
+   * @description 切换平整深度并同步到对应平整实例
+   * @param {Number} val 平整深度值
+   */
   setHeight(val) {
     this._options.flatHeight = Number(val);
+    // 索引为-1时表示作用于全部平整实例
     if (this.currentFlatPolygonIndex == -1) {
       this._flatteningPolygonTex.setFlattenedPolygonHeight(-1, Number(val));
     } else {
       this._flatteningPolygonTex.setFlattenedPolygonHeight(this.currentFlatPolygonIndex, Number(val));
     }
   }
-  // 切换辅助面显示
+  /**
+   * @description 切换辅助面显示状态
+   * @param {Boolean} val 是否显示
+   */
   setFlatteningShow(val) {
     this._options.flatteningShow = val;
     if (val) {
@@ -246,7 +267,10 @@ class ModelFlatViewModel {
       });
     }
   }
-  // 设置平整实例
+  /**
+   * @description 设置当前操作的平整实例索引
+   * @param {Number} val 平整实例索引
+   */
   setCurrentFlatPolygonIndex(val) {
     this.currentFlatPolygonIndex = val;
   }
@@ -258,11 +282,13 @@ class ModelFlatViewModel {
   remove() {
     this._flatteningPolygonTex && this._flatteningPolygonTex.removeAllFlattenedPolygon();
     this._flatteningPolygonTex && this._flatteningPolygonTex.detachAllTileset();
+    // 移除所有辅助面
     for (var i = 0; i < this._assistPolygons.length; i++) {
       this._viewer.entities.remove(this._assistPolygons[i]);
     }
     this._assistPolygons = [];
     var models = this._viewer.scene.primitives._primitives;
+    // 遍历所有3dtiles，取消平整并移除tileVisible监听
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset && models[i]._url) {
         if (!models[i].refresh) models[i]?.tileVisible?.removeEventListener(this.tileVisible);
@@ -345,6 +371,7 @@ const __default__ = {
 };
 var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   props: {
+    // 指定组件绑定的viewer对象的div的id
     mapTarget: {
       type: String
     },
@@ -397,6 +424,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 获取组件传参
     const props = __props;
+
+    // 表单数据对象
     let formItem = (0, _vue.reactive)({
       isFilterTilset: props?.settingParams?.isFilterTilset ?? true,
       isCheckTilset: props?.settingParams?.isCheckTilset ?? false,
@@ -418,6 +447,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
     let headerTempRef = (0, _vue.ref)();
+    // 可选的3dtiles图层列表
     let tiles = (0, _vue.ref)([]);
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
@@ -441,6 +471,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         callbackParams();
       }, 500);
     });
+    /**
+     * @description 回调函数：刷新可选图层列表，按需默认全选并同步给逻辑类
+     */
     function callbackParams() {
       if (viewModel) {
         tiles.value = viewModel?.findLayers?.() ?? []; // 获取所有tileset对象
@@ -448,7 +481,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         changeTilset(formItem.tileset);
       }
     }
-    // 切换模型
+    /**
+     * @description 切换平整目标模型图层
+     * @param {Array} val 选中的tileset guid数组
+     */
     function changeTilset(val) {
       viewModel.tiles = formItem?.tileset ?? [];
     }
@@ -473,7 +509,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function getFlatCount() {
       return viewModel && viewModel.getFlatCount();
     }
-    // 设置操作平整实例
+    /**
+     * @description 设置当前操作的平整实例索引
+     * @param {Number} val 平整实例索引
+     */
     function setCurrentFlatPolygonIndex(val) {
       viewModel && viewModel.setCurrentFlatPolygonIndex(val);
     }
@@ -481,6 +520,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function startOperation() {
       viewModel && viewModel.start();
     }
+    // 取消绘制
     function cancel() {
       viewModel && viewModel.cancel();
     }
@@ -701,11 +741,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/modeledit/index.js

@@ -31,16 +31,25 @@ var _useGlobalConfig = __webpack_require__(22686);
 //模型平整逻辑类
 
 class ModelEditViewModel {
+  //语言对象
+  /**
+   * @description 构造函数，初始化viewer、绘制管理对象及表单参数
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} formItem 表单参数对象
+   */
   constructor(scenceView, formItem) {
     this._viewer = null;
     //三维viewer对象
     this._drawManager = null;
     //绘制管理对象
     this._modelEdit = null;
+    //当前编辑的模型对象
     this._customAxis = null;
     // 编辑类
     this._option = null;
+    //表单参数对象
     this._modelEdits = [];
+    //已加载的模型集合
     this._language = {};
     const {
       locale
@@ -51,7 +60,10 @@ class ModelEditViewModel {
     this._viewer.scene.globe.depthTestAgainstTerrain = true;
     this._option = formItem;
   }
-  // 开始分析
+  /**
+   * @description 开始分析：根据传入的模型URL通过绘制点选择位置加载gltf模型并挂载自定义编辑轴
+   * @param {String} url 模型文件路径
+   */
   start(url) {
     let that = this;
     // this.clear();
@@ -61,6 +73,7 @@ class ModelEditViewModel {
       }, (feature, {
         shape
       }) => {
+        // 过滤非本组件绘制的图形
         if (!shape.groupName || shape.groupName !== "ModelEditDraw") return;
         that._drawManager.clearDrawGroup("ModelEditDraw");
         if (shape._position) {
@@ -76,10 +89,12 @@ class ModelEditViewModel {
             scale: that?._option?.modelScale ?? 80
           }));
           that._modelEdits.push(that._modelEdit);
+          // 若已存在编辑轴，先移除监听并销毁
           if (that._customAxis) {
             that._customAxis?.removeListener?.(); //移除监听
             that._customAxis?.destroy?.();
           }
+          // 模型加载完成后创建自定义编辑轴并添加监听
           that._modelEdit.readyPromise.then(function (model) {
             that._customAxis = new Cesium.Kq3dCustomAxis(that._viewer, model);
             that._customAxis.addListener(); //添加监听
@@ -88,20 +103,27 @@ class ModelEditViewModel {
         }
       }, "ModelEditDraw");
     } else {
+      // 未传入模型路径时给出提示
       (0, _message.default)({
         message: that._language.value.webgl["modelPathTips"],
         type: "info"
       });
     }
   }
+  /**
+   * @description 设置当前可编辑的模型对象并为其挂载自定义编辑轴
+   * @param {Object} val 模型对象
+   */
   setEditModel(val) {
     let that = this;
     that._modelEdit = val;
     that._modelEdits.push(that._modelEdit);
+    // 若已存在编辑轴，先移除监听并销毁
     if (that._customAxis) {
       that._customAxis?.removeListener?.(); //移除监听
       that._customAxis?.destroy?.();
     }
+    // 模型加载完成后创建自定义编辑轴并添加监听
     that._modelEdit?.readyPromise?.then?.(function (model) {
       that._customAxis = new Cesium.Kq3dCustomAxis(that._viewer, model);
       that._customAxis.addListener(); //添加监听
@@ -122,6 +144,7 @@ class ModelEditViewModel {
   }
   // 清除
   clear() {
+    // 遍历移除所有已加载的模型
     for (let i = 0; i < this._modelEdits.length; i++) {
       if (this._modelEdits[i]) {
         this._viewer.scene.primitives.remove(this._modelEdits[i]);
@@ -285,6 +308,7 @@ const __default__ = {
 };
 var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   props: {
+    // 指定组件绑定的viewer对象的div的id
     mapTarget: {
       type: String
     },
@@ -338,6 +362,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 获取组件传参
     const props = __props;
+
+    // 表单数据对象
     let formItem = (0, _vue.reactive)({
       modelPath: props?.settingParams?.modelPath ?? "",
       isScaleFile: props?.settingParams?.isScaleFile ?? false,
@@ -383,6 +409,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.modelEditTitle");
       }
     };
+    /**
+     * @description 选择本地模型文件并生成可访问的本地路径
+     * @param {Object} file 上传文件对象
+     */
     function selectModel(file) {
       formItem.modelPath = URL.createObjectURL(file.raw);
     }
@@ -416,6 +446,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         Object.assign(viewModel._option, formItem);
       }
     }
+    /**
+     * @description 设置当前可编辑的模型对象
+     * @param {Object} val 模型对象
+     */
     function setEditModel(val) {
       viewModel && viewModel.setEditModel(val);
     }
@@ -620,11 +654,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;
 
 /***/ })