@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/typhoontrac/index.js

@@ -102,11 +102,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       lang,
       locale
     } = (0, _useGlobalConfig.useLocale)();
+    // 台风轨迹逻辑类
     let viewModel = null;
+    // 台风轨迹容器Ref
     let ref_box = (0, _vue.ref)();
+    // 当前选中台风行
     let currentRow = (0, _vue.ref)({});
+    // 当前播放台风行
     let currentPlay = (0, _vue.ref)({});
+    // 是否显示详情
     let showInfo = (0, _vue.ref)(false);
+    // 加载状态
     let loading = (0, _vue.ref)(false);
     // 获取组件传参
     const props = __props;
@@ -115,6 +121,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
+    // header组件Ref
     let headerTempRef = (0, _vue.ref)();
     // 属性值
     let tableData = (0, _vue.ref)([]);
@@ -135,6 +142,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 是否显示离线数据功能
       typhoonTracPath: props.settingParams?.typhoonTracPath ?? "" // 离线数据文件路径
     });
+
+    // 台风强度类型图例
     const strongType = [{
       name: t('webgl.tropicalPressure'),
       color: "#08F6A0, #00CF63"
@@ -154,6 +163,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       name: t('webgl.superTyphoon'),
       color: "#FF636F, #FF0016"
     }];
+    // 台风路径线型图例（各国机构）
     const lineList = [{
       name: t('webgl.chinaTitle'),
       color: "#ff3c4e"
@@ -191,6 +201,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             viewModel = new _TyphoonTracViewModel.default(scenceView);
             viewModel._language = locale;
             formItem.typhoonTracPath && getDataByPath();
+            // 存在外部接口时通过接口获取台风列表
             if (props.getTyphoonTracListByApi) {
               loading.value = true;
               props.getTyphoonTracListByApi(data => {
@@ -225,7 +236,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         clear();
       }
     }
-    // 选择文件
+    /**
+     * @description 选择文件
+     * @param {Object} file 文件对象
+     */
     function selectData(file) {
       let url = URL.createObjectURL(file.raw);
       formItem.typhoonTracPath = url;
@@ -234,15 +248,25 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       currentPlay.value = {};
       formItem.collapseValue = "list";
     }
+    /**
+     * @description 表格时间列格式化
+     * @param {Object} row 行数据
+     * @returns {String} 格式化后的时间
+     */
     function formatterFun(row) {
       return formatDate(row.time);
     }
-    // 显示台风
+    /**
+     * @description 显示/隐藏台风
+     * @param {Number} index 行索引
+     * @param {Object} row 行数据
+       */
     async function showTyphoon(index, row) {
       try {
         await getDataInfoByApi(row); // 等待回调完成
         row.show = !row.show;
         if (!row.show) {
+          // 隐藏时清除弹框并停止播放
           viewModel && viewModel.clearDivPoint(row.tfid);
           setTracStop(index, row);
         }
@@ -252,6 +276,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         // 可以添加错误处理逻辑，例如显示错误提示
       }
     }
+    /**
+     * @description 设置台风详情信息
+     * @param {Number} index 行索引
+     * @param {Object} row 行数据
+     */
     async function setDatainfo(index, row) {
       try {
         await getDataInfoByApi(row);
@@ -264,6 +293,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         // 可以添加错误处理逻辑，例如显示错误提示
       }
     }
+
+    /**
+     * @description 通过外部接口获取台风详情数据
+     * @param {Object} row 台风行数据
+     * @returns {Promise} Promise对象
+     */
     async function getDataInfoByApi(row) {
       // 条件判断提前返回
       if (!props.getDataInfoByApi || row.getInfoVis) {
@@ -312,6 +347,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       };
       return dateFormats.MM + "-" + dateFormats.DD + " " + dateFormats.hh + "时";
     }
+    /**
+     * @description 表格单元格类名回调，给行列索引赋值
+     * @param {Object} param0 解构参数（row、column、rowIndex、columnIndex）
+     */
     function tableCellClassName({
       row,
       column,
@@ -323,13 +362,21 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       row.index = rowIndex;
       column.index = columnIndex;
     }
+    /**
+     * @description 点击路径表格行
+     * @param {Object} row 行数据
+     */
     function rowClickPath(row) {
       viewModel && viewModel.clearDivPoint(currentRow.value.tfid);
       if (!currentRow.value.show) currentRow.value.show = true;
       if (currentRow.value.showPlayVis) setTracStop(row.index, currentRow.value);
       viewModel && viewModel.rowClickPath(row.index, currentRow.value);
     }
-    // 播放
+    /**
+     * @description 播放台风轨迹
+     * @param {Number} index 行索引
+     * @param {Object} row 行数据
+       */
     async function setTracPlay(index, row) {
       try {
         await getDataInfoByApi(row); // 等待回调完成
@@ -342,7 +389,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         // 可以添加错误处理逻辑，例如显示错误提示
       }
     }
-    // 停止播放
+    /**
+     * @description 停止播放台风轨迹
+     * @param {Number} index 行索引
+     * @param {Object} row 行数据
+     */
     function setTracStop(index, row) {
       row.showPlayVis = false;
       viewModel && viewModel.stopPlayTyphoonTrac(row);
@@ -352,6 +403,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       if (formItem && formItem.typhoonTracPath) {
         Cesium.Resource.fetchJson(formItem.typhoonTracPath).then(res => {
           if (res) {
+            // 数据为空时提示
             if (res.length === 0) {
               KqMessage({
                 message: "features " + t('webgl.noDataMessage') + "!",
@@ -373,13 +425,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         return;
       }
     }
-    // 更新台风数据
+    /**
+     * @description 更新台风数据
+     * @param {Array} data 台风数据数组
+       */
     function setTyphoonTracData(data) {
       if (data && data.length && data.length > 0) {
         clear();
         tableData.value = data;
       }
     }
+    // 清除
     function clear() {
       viewModel && viewModel.clear();
     }
@@ -686,28 +742,44 @@ exports["default"] = void 0;
  */
 // 国际化
 class TyphoonTracViewModel {
+  // 播放事件监听器
+  /**
+   * @description 台风轨迹逻辑类构造函数
+   * @param {Object} scenceView 三维场景视图对象
+   */
   constructor(scenceView) {
     this._viewer = null;
     // 三维viewer对象
     this._language = null;
+    // 当前语言对象
     this._curTyphoon = [];
+    // 当前台风对象集合
     this.currentRow = null;
+    // 当前选中台风行
     this.divPoint = null;
+    // 浮动信息弹框
     this.eventListener = null;
+    // 悬停事件监听器
     this.eventListener2 = null;
     this._viewer = scenceView._viewer;
     this._viewer.postProcessStages.fxaa.enabled = true;
     // 开启深度检测
     this._viewer.scene.globe.depthTestAgainstTerrain = true;
   }
-  // 控制台风显示
+  /**
+   * @description 控制台风显示
+   * @param {Object} row 台风行数据
+   * @param {Boolean} play 是否播放
+   */
   createTyphoonPath(row, play = false) {
     if (!this.warningLine_48) this.createWarningLine();
     let that = this;
     if (this._curTyphoon[row.tfid]) {
+      // 已存在台风对象则设置可见性
       this._curTyphoon[row.tfid].setVisible(row.show);
       row.show && this._curTyphoon[row.tfid].flyTo();
     } else {
+      // 不存在则创建台风对象并绑定事件
       let res = Object.assign({}, row);
       this._curTyphoon[row.tfid] = new Cesium.Kq3dTyphoon(this._viewer, {
         data: res
@@ -752,6 +824,7 @@ class TyphoonTracViewModel {
     }
     if (row.show) {
       if (play) {
+        // 播放前停止当前正在播放的台风
         if (this.currentRow && this.currentRow.tfid && this._curTyphoon[this.currentRow.tfid] && this._curTyphoon[this.currentRow.tfid].stop) {
           this._curTyphoon[this.currentRow.tfid].stop();
         }
@@ -760,14 +833,21 @@ class TyphoonTracViewModel {
     }
     this.currentRow = row;
   }
-  // 获取
+  /**
+   * @description 获取弹框点数据（解析风圈半径）
+   * @param {Object} pointInfo 台风点信息
+   * @returns {Object} 处理后的点信息
+   */
   getDivPointData(pointInfo) {
     if (pointInfo.radius7) pointInfo.radius7Arr = pointInfo.radius7.split('|');
     if (pointInfo.radius10) pointInfo.radius10Arr = pointInfo.radius10.split('|');
     if (pointInfo.radius12) pointInfo.radius12Arr = pointInfo.radius12.split('|');
     return pointInfo;
   }
-  // 创建台风属性弹框
+  /**
+   * @description 创建台风播放属性弹框
+   * @param {Object} data 台风点数据
+   */
   createInfoPlayDivPoint(data) {
     data = Object.assign(data, this.currentRow);
     if (this._curTyphoon[data.tfid].divPoint) {
@@ -782,7 +862,11 @@ class TyphoonTracViewModel {
       noEvent: false
     });
   }
-  //点击展示详细信息
+  /**
+   * @description 点击展示详细信息
+   * @param {Number} index 点索引
+   * @param {Object} row 台风行数据
+   */
   rowClickPath(index, row) {
     if (!this._curTyphoon[row.tfid]) {
       row.show = true;
@@ -794,7 +878,10 @@ class TyphoonTracViewModel {
       this.createInfoDivPoint(this.getDivPointData(this._curTyphoon[row.tfid].positions[index]));
     }, 500);
   }
-  // 创建浮动弹框属性
+  /**
+   * @description 创建浮动弹框属性
+   * @param {Object} data 台风点数据
+   */
   createInfoDivPoint(data) {
     if (this.divPoint) {
       this.divPoint.destroy();
@@ -816,7 +903,11 @@ class TyphoonTracViewModel {
       anchor: [-140, htmlObj.anchorY]
     });
   }
-  // 创建html弹框内容
+  /**
+   * @description 创建html弹框内容
+   * @param {Object} data 台风点数据
+   * @returns {Object} html内容和锚点对象
+   */
   createHtml(data) {
     let anchorY = -215;
     let html = `<div class='kq3d-typhoon-trac-Info'>
@@ -874,12 +965,22 @@ class TyphoonTracViewModel {
       anchorY: anchorY
     };
   }
-  // 动态插入时进行字符过滤
+  /**
+   * @description 动态插入时进行字符过滤
+   * @param {String} text 待过滤文本
+   * @returns {String} 过滤后的文本
+   */
   sanitize(text) {
     return text.replace(/[\u200B-\u200D\uFEFF]/g, "") // 清除零宽字符
     .replace(/[“”]/g, ""); // 主动过滤引号
   }
-  // 日期矫正
+  /**
+   * @description 日期矫正格式化
+   * @param {Date|String|Number} date 日期
+   * @param {String} format 格式类型（'date'/'datetime'）
+   * @param {Boolean} isPad 是否补零
+   * @returns {String} 格式化后的日期字符串
+   */
   formatDate(date = new Date(), format = 'datetime', isPad = true) {
     if (!(date instanceof Date)) {
       date = new Date(date);
@@ -901,11 +1002,17 @@ class TyphoonTracViewModel {
     };
     return Object.keys(dateFormats).reduce((result, item) => result.replaceAll(item, dateFormats[item]), format);
   }
-  // 停止播放
+  /**
+   * @description 停止播放台风轨迹
+   * @param {Object} row 台风行数据
+   */
   stopPlayTyphoonTrac(row) {
     if (this._curTyphoon[row.tfid]) this._curTyphoon[row.tfid].stop();
   }
-  // 暂停播放
+  /**
+   * @description 暂停/继续播放台风轨迹
+   * @param {Boolean} val 是否继续播放
+   */
   pausePlayTyphoonTrac(val) {
     if (this._curTyphoon[this.currentRow.tfid]) this._curTyphoon[this.currentRow.tfid].flyTo();
     if (val) {
@@ -914,7 +1021,10 @@ class TyphoonTracViewModel {
       this._viewer.clock.shouldAnimate = false;
     }
   }
-  // 设置时间流速
+  /**
+   * @description 设置时间流速
+   * @param {Number} val 流速倍数
+   */
   setMultiplier(val) {
     window.viewer.clock.multiplier = val || 1;
   }
@@ -993,6 +1103,10 @@ class TyphoonTracViewModel {
       }
     });
   }
+  /**
+   * @description 移除指定台风
+   * @param {String} tfid 台风ID
+   */
   remove(tfid) {
     if (this._curTyphoon[tfid] && this._curTyphoon[tfid].getHoverEvent) {
       let hishoverEvent = this._curTyphoon[tfid].getHoverEvent();
@@ -1014,6 +1128,10 @@ class TyphoonTracViewModel {
     }
     this._curTyphoon[tfid] = null;
   }
+  /**
+   * @description 清除指定台风的弹框
+   * @param {String} tfid 台风ID
+   */
   clearDivPoint(tfid) {
     if (this._curTyphoon[tfid] && this._curTyphoon[tfid].divPoint) {
       this._curTyphoon[tfid].divPoint.destroy();

package/underground/index.js

@@ -95,6 +95,10 @@ exports["default"] = void 0;
  */
 class UndergroundViewModel {
   // 地下模式三维管理对象
+  /**
+   * @description 构造函数，初始化地下模式管理对象
+   * @param {Object} viewer 三维viewer对象
+   */
   constructor(viewer) {
     this._viewer = null;
     // 三维viewer对象
@@ -102,6 +106,8 @@ class UndergroundViewModel {
     this._viewer = viewer;
     this._undergroundManager = new Cesium.Kq3dUndergroundManager(this._viewer.scene);
   }
+
+  // 开启地下模式
   open() {
     // this._viewer.scene.skyAtmosphere.show = false;
     // 关闭碰撞检测
@@ -184,8 +190,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const emit = __emit;
     //获取组件传参
     const props = __props;
-    let isUndergroundMode = (0, _vue.ref)(false);
-    let viewModel = null;
+    let isUndergroundMode = (0, _vue.ref)(false); // 地下模式开关状态
+    let viewModel = null; // 地下模式视图模型对象
 
     // 组件容器Ref
     let boxRef = (0, _vue.ref)(null);