@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/flight/index.js

@@ -450,19 +450,28 @@ exports["default"] = void 0;
  */
 //飞行操作类
 class FlightViewModel {
+  //是否处于暂停状态
+
+  /** @description 构造函数，根据是否远景创建对应的动画路径对象
+   * @param {Object} viewer 三维viewer对象
+   * @param {boolean} isLongShot 是否远景模式
+   */
   constructor(viewer, isLongShot) {
     this._animationPath = null;
     //飞行三维对象
     this.stopEvent = null;
     //停止事件
     this._currentKey = -1;
+    //当前播放关键帧索引
     this._isPause = false;
+    // 远景模式使用Kq3dAnimationPath，否则使用Kq3dAnimationPath2
     if (isLongShot) {
       this._animationPath = new Cesium.Kq3dAnimationPath(viewer);
     } else {
       this._animationPath = new Cesium.Kq3dAnimationPath2(viewer);
     }
     this.stopEvent = this._animationPath.stoped;
+    // 监听停止事件，重置暂停状态
     this.stopEvent.addEventListener(() => {
       this._isPause = false;
     });
@@ -470,9 +479,10 @@ class FlightViewModel {
 
   //播放动画导航路径
   play() {
+    // 非暂停状态时定位到下一关键帧视角
     if (!this._isPause) {
       this._animationPath.currentKey = this._currentKey;
-      let keyPoint = this._animationPath.getKeyPoint(this._currentKey + 1);
+      const keyPoint = this._animationPath.getKeyPoint(this._currentKey + 1);
       this._animationPath.viewer.camera.setView({
         destination: keyPoint.position,
         orientation: keyPoint.orientation
@@ -498,48 +508,70 @@ class FlightViewModel {
     return this._animationPath.getAutoRepeat();
   }
 
-  //设置动画导航是否循环播放
+  /** @description 设置动画导航是否循环播放
+   * @param {boolean} autoRepeat 是否循环播放
+   */
   setAutoRepeat(autoRepeat) {
     this._animationPath.setAutoRepeat(autoRepeat);
   }
 
-  //将当前相机位置添加到动画导航路径中
+  /** @description 将当前相机位置添加到动画导航路径中
+   * @param {number} duration 当前关键帧耗时
+   */
   addKeyPointByCurrentView(duration) {
     this._animationPath.addKeyPointByCurrentView(duration);
   }
 
-  //使用当前视角修改指定索引位置的路径节点
+  /** @description 使用当前视角修改指定索引位置的路径节点
+   * @param {number} index 路径节点索引
+   * @param {number} duration 关键帧耗时
+   */
   modifyKeyPointByCurrentView(index, duration) {
     this._animationPath.modifyKeyPointByCurrentView(index, duration);
   }
 
-  //获取指定索引位置处的路径节点
+  /** @description 获取指定索引位置处的路径节点
+   * @param {number} index 路径节点索引
+   * @returns {Object} 路径节点对象
+   */
   getKeyPoint(index) {
     return this._animationPath.getKeyPoint(index);
   }
 
-  //定位到关键帧
+  /** @description 定位到关键帧
+   * @param {number} index 关键帧索引
+   */
   locationKey(index) {
     this.stop();
     this._currentKey = index - 1;
-    let keyPoint = this._animationPath.getKeyPoint(index);
+    const keyPoint = this._animationPath.getKeyPoint(index);
     this._animationPath.viewer.camera.setView({
       destination: keyPoint.position,
       orientation: keyPoint.orientation
     });
   }
 
-  //获取指定索引位置的路径节点的耗时信息
+  /** @description 获取指定索引位置的路径节点的耗时信息
+   * @param {number} index 路径节点索引
+   * @returns {number} 耗时（秒）
+   */
   getKeyPointDur(index) {
     return this._animationPath.getKeyPointDur(index);
   }
 
-  //修改指定索引位置的路径节点
+  /** @description 修改指定索引位置的路径节点
+   * @param {number} index 路径节点索引
+   * @param {Object} position 节点位置
+   * @param {Object} orientation 节点朝向
+   * @param {number} duration 关键帧耗时
+   */
   modifyKeyPoint(index, position, orientation, duration) {
     this._animationPath.modifyKeyPoint(index, position, orientation, duration);
   }
 
-  //删除动画导航中指定索引位置的路径节点
+  /** @description 删除动画导航中指定索引位置的路径节点
+   * @param {number} index 路径节点索引
+   */
   deleteKeyPoint(index) {
     this._animationPath.deleteKeyPoint(index);
   }
@@ -555,7 +587,9 @@ class FlightViewModel {
     this._animationPath.clearKeyPoints();
   }
 
-  //从xml字符串获取动画导航
+  /** @description 从xml字符串获取动画导航
+   * @param {string} xmlString xml字符串
+   */
   fromXmlString(xmlString) {
     this._animationPath.fromXmlString(xmlString);
   }
@@ -566,12 +600,17 @@ class FlightViewModel {
     return this._animationPath.asXmlString();
   }
 
-  //从xml文件获取动画导航
+  /** @description 从xml文件获取动画导航
+   * @param {Object} xmlFile xml文件对象
+   * @returns {Promise} 加载完成的Promise
+   */
   fromXmlFile(xmlFile) {
     return this._animationPath.fromXmlFile(xmlFile);
   }
 
-  //动画导航导出为xml文件
+  /** @description 动画导航导出为xml文件
+   * @param {string} xmlFileName 导出文件名
+   */
   asXmlFile(xmlFileName) {
     this._animationPath.asXmlFile(xmlFileName);
   }
@@ -985,21 +1024,39 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     const props = __props;
+
+    // 是否处于新增/编辑路径界面
     let isAdd = (0, _vue.ref)(false);
+    // 是否为编辑路径模式
     let isEdit = (0, _vue.ref)(false);
+    // 飞行路径列表
     let pathList = (0, _vue.reactive)([]);
+    // 是否显示更多功能下拉菜单
     let showMoreMenu = (0, _vue.ref)(false);
+    // 下拉菜单组件Ref
     let dropDownMenu = (0, _vue.ref)(null);
+    // 当前路径名称
     let pathName = (0, _vue.ref)("");
+    // 关键帧表格数据
     let tableData = (0, _vue.reactive)([]);
+    // 是否处于预播放状态
     let isPrePlaying = (0, _vue.ref)(false);
+    // 三维viewer对象
     let viewer = null;
+    // 当前播放路径索引
     let pathPlayIndex = -1;
+    // 当前下拉菜单对应的路径对象
     let dropDownPath = null;
+    // 表格组件Ref
     let tableRef = (0, _vue.ref)();
+
+    // 飞行视图模型实例
     let viewModel = null;
 
-    // 表格头样式
+    /** @description 表格头样式
+     * @param {Object} args 表格头参数对象
+     * @returns {Object} 样式对象
+     */
     let headClass = args => {
       return {
         "background-color": "var(--kq-fill-color-light)",
@@ -1013,6 +1070,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
+    // header组件引用Ref
     let headerTempRef = (0, _vue.ref)();
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
@@ -1120,8 +1178,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    //路径播放
+    /** @description 路径播放
+     * @param {Object} item 路径对象
+     * @param {number} index 路径索引
+     */
     function play(item, index) {
+      // 切换播放路径时重新加载路径数据
       if (index !== pathPlayIndex) {
         viewModel.fromXmlString(item.xmlString);
         pathPlayIndex = index;
@@ -1132,28 +1194,39 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       viewModel.setAutoRepeat(item.isRepeat);
     }
 
-    //路径播放暂停
+    /** @description 路径播放暂停
+     * @param {Object} item 路径对象
+     */
     function pause(item) {
       item.isPlaying = false;
       viewModel.pause();
     }
 
-    //路径播放停止
+    /** @description 路径播放停止
+     * @param {Object} item 路径对象
+     */
     function stop(item) {
       item.isPlaying = false;
       viewModel.stop();
     }
 
-    //循环播放
+    /** @description 循环播放切换
+     * @param {Object} item 路径对象
+     */
     function repeat(item) {
       item.isRepeat = !item.isRepeat;
+      // 仅在播放中切换循环状态
       if (item.isPlaying) {
         viewModel.setAutoRepeat(item.isRepeat);
       }
     }
 
-    //显示更多功能菜单
+    /** @description 显示更多功能菜单
+     * @param {Object} item 路径对象
+     * @param {number} index 路径索引
+     */
     function showDropDownMenu(item, index) {
+      // 同一路径再次点击则关闭菜单
       if (showMoreMenu.value === true && index === dropDownPath.index) {
         showMoreMenu.value = false;
         document.addEventListener("click", hideDropDownMenu);
@@ -1161,6 +1234,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       showMoreMenu.value = true;
       let _menuDropdown = dropDownMenu.value.$el;
+      // 根据鼠标点击位置定位下拉菜单
       _menuDropdown.style.left = window.event.clientX - 70 + "px";
       _menuDropdown.style.top = window.event.clientY + 15 + "px";
       dropDownPath = {
@@ -1181,7 +1255,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       showMoreMenu.value = false;
     }
 
-    // 定位到关键帧
+    /** @description 定位到关键帧
+     * @param {number} index 关键帧索引
+     */
     function locationKey(index) {
       viewModel.locationKey(index);
     }
@@ -1204,7 +1280,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       viewModel.addKeyPointByCurrentView(duration);
     }
 
-    //替换关键帧
+    /** @description 替换关键帧
+     * @param {number} index 关键帧索引
+     * @param {Object} row 表格行数据
+     */
     function replaceKey(index, row) {
       var lonlat = viewer.getCurrentView();
       var positionArr = [lonlat.longitude.toFixed(4) * 1, lonlat.latitude.toFixed(4) * 1, lonlat.height.toFixed(2) * 1];
@@ -1214,7 +1293,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       viewModel.modifyKeyPointByCurrentView(index, row.interval);
     }
 
-    //删除关键帧
+    /** @description 删除关键帧
+     * @param {number} index 关键帧索引
+     */
     function deleteKey(index) {
       viewModel.deleteKeyPoint(index);
       tableData.splice(index, 1);
@@ -1226,6 +1307,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         var duration = tableData[index].interval;
         var key = viewModel.getKeyPoint(index);
         var dur = viewModel.getKeyPointDur(index);
+        // 关键帧时长不一致时同步更新
         if (dur !== duration) {
           viewModel.modifyKeyPoint(index, key.position, key.orientation, duration);
         }
@@ -1248,12 +1330,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     //保存
     function save() {
+      // 路径名为空则提示
       if (pathName.value === "") {
         (0, _message.default)({
           message: locale.value.webgl["enterPathName"] + "!",
           type: "warning"
         });
       } else {
+        // 保存前同步关键帧时长
         for (let index = 0; index < tableData.length; index++) {
           var duration = tableData[index].interval;
           var key = viewModel.getKeyPoint(index);
@@ -1263,6 +1347,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           }
         }
         var xmlString = viewModel.asXmlString();
+        // 编辑已有路径
         if (isEdit.value) {
           //编辑路径
           if (dropDownPath) {
@@ -1310,7 +1395,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       isEdit.value = false;
     }
 
-    //导入文件
+    /** @description 导入文件
+     * @param {Object} file 导入的文件对象
+     */
     function importFile(file) {
       var name = file.name.split(".")[0];
       viewModel.fromXmlFile(file.raw).then(() => {
@@ -2157,11 +2244,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/floodanalysis/index.js

@@ -1529,6 +1529,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 淹没最大高度范围的最大值
       floodColorImage: props.settingParams?.floodColorImage ?? "0" // 淹没纹理色带值
     });
+
+    // 淹没分析视图模型实例
     let viewModel = null;
 
     // 组件容器Ref
@@ -1536,6 +1538,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
+    // header组件引用Ref
     let headerTempRef = (0, _vue.ref)();
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
@@ -1573,7 +1576,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    //获取图片路径
+    /** @description 获取图片路径，根据色带值匹配对应的淹没色调图片
+     * @param {string} value 色带值
+     * @returns {string} 图片路径
+     */
     function getImagePath(value) {
       var imagePath = "";
       var image = colorImages.find(item => item.value === value);
@@ -1592,22 +1598,29 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function clearResult() {
       viewModel && viewModel.clear();
     }
-    // 参数切换
+    /** @description 参数切换处理，根据参数类型更新淹没分析状态
+     * @param {string} key 变化的参数类型（mode/moveMode/speed/alpha/minHeight/maxHeight/colorImage）
+     */
     function paramsChanged(key) {
       if (!viewModel) return;
       switch (key) {
+        // 淹没模式变化
         case "mode":
           viewModel.setMoveMode(formItem.floodMode);
           break;
+        // 淹没方向变化
         case "moveMode":
           viewModel.setMoveDirection(formItem.floodDirection);
           break;
+        // 淹没速度变化
         case "speed":
           viewModel.setMoveSpeed(formItem.floodSpeed);
           break;
+        // 透明度变化
         case "alpha":
           viewModel.setMoveAlpha(formItem.floodAlpha);
           break;
+        // 最小高度变化：保证不超过最大高度
         case "minHeight":
           if (formItem.floodMinHeight > formItem.floodMaxHeight) {
             formItem.floodMaxHeight = formItem.floodMinHeight;
@@ -1615,6 +1628,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           }
           viewModel.setMoveMinHeight(formItem.floodMinHeight);
           break;
+        // 最大高度变化：保证不小于最小高度
         case "maxHeight":
           if (formItem.floodMinHeight > formItem.floodMaxHeight) {
             formItem.floodMinHeight = formItem.floodMaxHeight;
@@ -1622,6 +1636,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           }
           viewModel.setMoveMaxHeight(formItem.floodMaxHeight);
           break;
+        // 色带图片变化
         case "colorImage":
           var imageUrl = getImagePath(formItem.floodColorImage);
           viewModel.setMoveImage(imageUrl);
@@ -1630,15 +1645,23 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    /** @description 设置参数值，根据参数类型更新淹没范围或绘制面
+     * @param {string} key 参数类型（polygon/minHeight/maxHeight）
+     * @param {*} value 参数值
+     */
     function setValue(key, value) {
       switch (key) {
+        // 设置淹没分析多边形
         case "polygon":
           viewModel.setMovePolygon(value);
           break;
+        // 设置最小高度并触发参数变化
         case "minHeight":
           formItem.floodMinHeight = value;
           paramsChanged(key);
           break;
+        // 设置最大高度并触发参数变化
         case "maxHeight":
           formItem.floodMaxHeight = value;
           paramsChanged(key);
@@ -2137,8 +2160,13 @@ var _useGlobalConfig = __webpack_require__(22686);
 //地形淹没分析逻辑类
 
 class FloodAnalysisViewModel {
+  /** @description 构造函数，初始化淹没分析视图模型并绑定测量事件
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} options 淹没分析配置参数
+   */
   constructor(scenceView, options) {
     this._options = {};
+    //淹没分析配置参数对象
     this._floodTerrainAnalysis = null;
     //地形淹没三维对象
     this._floodModelAnalysis = null;
@@ -2152,6 +2180,7 @@ class FloodAnalysisViewModel {
     this._polygon = null;
     //淹没范围
     this._language = {};
+    //多语言资源对象
     this._colorImages = [
     //淹没纹理图片集合
     {
@@ -2173,6 +2202,7 @@ class FloodAnalysisViewModel {
     options.viewer.scene.globe.depthTestAgainstTerrain = true;
     options.colorImage = this.getImagePath(options.colorImage);
     this._options = options;
+    // 复用场景已存在的模型淹没对象，避免重复创建
     if (scenceView._floodModelAnalysis) {
       this._floodModelAnalysis = scenceView._floodModelAnalysis;
     } else {
@@ -2188,6 +2218,7 @@ class FloodAnalysisViewModel {
     // this._floodModelAnalysis.colorImage = options.colorImage;
     var that = this;
     this._measureHandler = new Cesium.Kq3dMeasureHandler(scenceView._viewer);
+    // 自定义绘制提示样式
     if (scenceView._props.showDrawTipsStyle) {
       this._measureHandler.showDrawTips = scenceView._props.showDrawTipsStyle;
       this._measureHandler.drawTipsStyle = {
@@ -2198,13 +2229,16 @@ class FloodAnalysisViewModel {
         }
       };
     }
+    // 测量完成事件：记录结果并隐藏标签
     this._measureHandler.measureEvent.addEventListener(function (result) {
       that._measureResult = result;
       result.measureResult.label.show = false;
     });
+    // 测量激活状态事件：测量结束(ret==false)时根据模式启动淹没分析
     this._measureHandler.activeEvent.addEventListener(function (ret) {
       if (ret == false) {
         if (that._measureResult) {
+          // 地形淹没模式
           if (that._mode === 0) {
             that._options.positions = that._measureResult.positions;
             if (!that._floodTerrainAnalysis) {
@@ -2214,6 +2248,7 @@ class FloodAnalysisViewModel {
             }
             that._floodTerrainAnalysis.start();
           } else if (that._mode === 1) {
+            // 模型淹没模式
             if (that._measureResult.positions && that._measureResult.positions.length > 0) {
               that._floodModelAnalysis.center = that._measureResult.positions[0];
             }
@@ -2229,7 +2264,10 @@ class FloodAnalysisViewModel {
     });
   }
 
-  //获取图片路径
+  /** @description 获取图片路径，根据色带值匹配对应的淹没纹理图片
+   * @param {string} value 色带值
+   * @returns {string} 图片路径
+   */
   getImagePath(value) {
     var imagePath = '';
     var image = this._colorImages.find(item => item.value === value);
@@ -2243,9 +2281,12 @@ class FloodAnalysisViewModel {
   start() {
     // 判断是否添加了地形
     if (this._mode === 0) {
+      // 地形淹没模式：检查地形可用性
       if (this._floodModelAnalysis.viewer.terrainProvider.availability) {
+        // 判断地形是否为非 heightmap 结构
         if (this._floodModelAnalysis.viewer.terrainProvider && !this._floodModelAnalysis.viewer.terrainProvider._heightmapStructure) {
           this.clear();
+          // 已有淹没范围直接启动，否则启动测量绘制
           if (this._polygon) {
             this._options.positions = this._polygon;
             if (!this._floodTerrainAnalysis) {
@@ -2258,18 +2299,21 @@ class FloodAnalysisViewModel {
             this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.HorizontalArea);
           }
         } else {
+          // heightmap 地形不支持该分析
           (0, _message.default)({
             message: this._language.value.webgl["stkTerrainAnalysisTips"],
             type: "warning"
           });
         }
       } else {
+        // 未加载地形则提示
         (0, _message.default)({
           message: this._language.value.webgl["terrainAnalysisTips"],
           type: "warning"
         });
       }
     } else if (this._mode === 1) {
+      // 模型淹没模式：检查场景是否存在3DTileset模型
       var modelFlag = false;
       var models = this._floodModelAnalysis.viewer.scene.primitives._primitives;
       for (let i = 0; i < models.length; i++) {
@@ -2281,6 +2325,7 @@ class FloodAnalysisViewModel {
       }
       if (modelFlag) {
         this.clear();
+        // 已有淹没范围直接启动，否则启动测量绘制
         if (this._polygon) {
           this._floodModelAnalysis.center = this._polygon[0];
           let polygon = Cesium.PolygonGeometry.fromPositions({
@@ -2292,6 +2337,7 @@ class FloodAnalysisViewModel {
           this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.HorizontalArea);
         }
       } else {
+        // 场景中无模型则提示
         (0, _message.default)({
           message: this._language.value.webgl["addModelAnalysisTips"],
           type: "warning"
@@ -2304,6 +2350,7 @@ class FloodAnalysisViewModel {
   clear() {
     this._measureHandler.stopMeasure();
     if (this._floodTerrainAnalysis) {
+      // 保留当前地形淹没配置后销毁重建，以清除分析结果
       var options = {
         viewer: this._floodTerrainAnalysis.viewer,
         moveMode: this._floodTerrainAnalysis.moveMode,
@@ -2332,58 +2379,76 @@ class FloodAnalysisViewModel {
     this._measureHandler = null;
   }
 
-  //设置淹没模式
+  /** @description 设置淹没模式
+   * @param {number} mode 淹没模式（0：地形淹没 1：模型淹没）
+   */
   setMoveMode(mode) {
     this._mode = Number(mode);
   }
-  //设置淹没方向
+  /** @description 设置淹没方向
+   * @param {number} direction 淹没方向（0：单向 1：双向）
+   */
   setMoveDirection(direction) {
     direction = Number(direction);
     this._options.moveMode = direction;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.moveMode = direction;
     if (this._floodModelAnalysis) this._floodModelAnalysis.moveMode = direction;
   }
-  //设置淹没速度
+  /** @description 设置淹没速度
+   * @param {number} speed 淹没速度
+   */
   setMoveSpeed(speed) {
     speed = Number(speed);
     this._options.speed = speed;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.speed = speed;
     if (this._floodModelAnalysis) this._floodModelAnalysis.speed = speed;
   }
-  //设置淹没纹理透明度
+  /** @description 设置淹没纹理透明度
+   * @param {number} alpha 透明度（0-1）
+   */
   setMoveAlpha(alpha) {
     alpha = Number(alpha);
     this._options.alpha = alpha;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.alpha = alpha;
     if (this._floodModelAnalysis) this._floodModelAnalysis.alpha = alpha;
   }
-  //设置最小淹没高度
+  /** @description 设置最小淹没高度
+   * @param {number} minHeight 最小淹没高度
+   */
   setMoveMinHeight(minHeight) {
     minHeight = Number(minHeight);
     this._options.minHeight = minHeight;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.minHeight = minHeight;
     if (this._floodModelAnalysis) this._floodModelAnalysis.minHeight = minHeight;
   }
-  //设置最大淹没高度
+  /** @description 设置最大淹没高度
+   * @param {number} maxHeight 最大淹没高度
+   */
   setMoveMaxHeight(maxHeight) {
     maxHeight = Number(maxHeight);
     this._options.maxHeight = maxHeight;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.maxHeight = maxHeight;
     if (this._floodModelAnalysis) this._floodModelAnalysis.maxHeight = maxHeight;
   }
-  //设置淹没填充纹理
+  /** @description 设置淹没填充纹理
+   * @param {string} image 纹理图片路径
+   */
   setMoveImage(image) {
     this._options.colorImage = image;
     if (this._floodTerrainAnalysis) this._floodTerrainAnalysis.colorImage = image;
     if (this._floodModelAnalysis) this._floodModelAnalysis.colorImage = image;
   }
-  //设置淹没范围
+  /** @description 设置淹没范围，根据点维度自动选择构造方式
+   * @param {Array} points 淹没范围点集合（二维或三维坐标）
+   */
   setMovePolygon(points) {
     if (Array.isArray(points) && points.length > 0) {
       if (Array.isArray(points[0])) {
+        // 二维坐标（经纬度）
         if (points[0].length == 2) {
           this._polygon = Cesium.Cartesian3.fromDegreesArray(points.flat());
         } else if (points[0].length == 3) {
+          // 三维坐标（经纬度高）
           this._polygon = Cesium.Cartesian3.fromDegreesArrayHeights(points.flat());
         }
       }
@@ -2674,11 +2739,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;
 
 /***/ })