@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/videoproject/index.js

@@ -62,6 +62,13 @@ exports["default"] = void 0;
  */
 //视频投放逻辑类
 class VideoProjectViewModel {
+  // 视频DOM元素
+
+  /**
+   * @description 构造函数，初始化视频投放管理对象并创建视频元素
+   * @param {Object} scenceView 场景视图对象，包含 _viewer 属性
+   * @param {Object} options 视频投放配置参数
+   */
   constructor(scenceView, options) {
     this._viewer = null;
     //三维viewer对象
@@ -96,11 +103,11 @@ class VideoProjectViewModel {
   // 投放
   project() {
     this.clear();
-    let position = Cesium.Cartesian3.clone(this._viewer.camera.positionWC);
+    const position = Cesium.Cartesian3.clone(this._viewer.camera.positionWC);
     this._options.heading = this._viewer.camera.heading;
     this._options.pitch = this._viewer.camera.pitch;
     this._options.roll = this._viewer.camera.roll;
-    let options = {
+    const options = {
       position: position,
       heading: this._options.heading,
       pitch: this._options.pitch,
@@ -112,9 +119,11 @@ class VideoProjectViewModel {
     };
     this._videoElement.src = this._options.videoPath;
     if (this._options.projectType == 1) {
+      // 平面投放：使用平面投影类
       options.outline = this._options.showHideLine;
       this._projectVideo = new Cesium.K3dProjectVideoPlane(options);
     } else {
+      // 模型投放：使用模型投影类
       options.showHelperPrimitive = this._options.showHideLine;
       this._projectVideo = new Cesium.Kq3dProjectVideo(options);
     }
@@ -124,7 +133,7 @@ class VideoProjectViewModel {
   // 获取投放坐标
   getProjectCoordinate() {
     if (this._projectVideo) {
-      let cartographic = Cesium.Cartographic.fromCartesian(this._projectVideo.position);
+      const cartographic = Cesium.Cartographic.fromCartesian(this._projectVideo.position);
       return {
         longitude: Cesium.Math.toDegrees(cartographic.longitude),
         latitude: Cesium.Math.toDegrees(cartographic.latitude),
@@ -169,65 +178,99 @@ class VideoProjectViewModel {
     this._videoElement = null;
   }
 
-  // 设置坐标
+  /**
+   * @description 设置投放的坐标位置
+   * @param {Number} longitude 经度
+   * @param {Number} latitude 纬度
+   * @param {Number} height 高度
+   */
   setPosition(longitude, latitude, height) {
-    let position = Cesium.Cartesian3.fromDegrees(longitude, latitude, height);
+    const position = Cesium.Cartesian3.fromDegrees(longitude, latitude, height);
     this._projectVideo.position = position;
   }
 
-  // 设置视频路径
+  /**
+   * @description 设置视频流路径
+   * @param {String} val 视频流地址
+   */
   setVideoPath(val) {
     this._options.videoPath = val;
   }
 
-  // 设置投放类型, 1:平面上, 2: 模型上
+  /**
+   * @description 设置投放类型, 1:平面上, 2: 模型上
+   * @param {Number} val 投放类型值
+   */
   setProjectType(val) {
     this._options.projectType = Number(val);
   }
 
-  // 设置视场角度
+  /**
+   * @description 设置视场角度
+   * @param {Number} val 视场角度值
+   */
   setFov(val) {
     this._options.fov = Number(val);
     if (this._projectVideo) this._projectVideo.fov = Cesium.Math.toRadians(this._options.fov);
   }
 
-  // 设置纵横比
+  /**
+   * @description 设置纵横比
+   * @param {Number} val 纵横比值
+   */
   setAspectRatio(val) {
     this._options.aspectRatio = Number(val);
     if (this._projectVideo) this._projectVideo.aspectRatio = this._options.aspectRatio;
   }
 
-  // 设置投放距离
+  /**
+   * @description 设置投放距离
+   * @param {Number} val 投放距离值
+   */
   setFar(val) {
     this._options.far = Number(val);
     if (this._projectVideo) this._projectVideo.far = this._options.far;
   }
 
-  // 设置朝向角
+  /**
+   * @description 设置朝向角
+   * @param {Number} val 朝向角度值
+   */
   setHeading(val) {
     this._options.heading = Number(val);
     if (this._projectVideo) this._projectVideo.heading = Cesium.Math.toRadians(this._options.heading);
   }
 
-  // 设置俯仰角
+  /**
+   * @description 设置俯仰角
+   * @param {Number} val 俯仰角度值
+   */
   setPitch(val) {
     this._options.pitch = Number(val);
     if (this._projectVideo) this._projectVideo.pitch = Cesium.Math.toRadians(this._options.pitch);
   }
 
-  // 设置翻转角
+  /**
+   * @description 设置翻转角
+   * @param {Number} val 翻转角度值
+   */
   setRoll(val) {
     this._options.roll = Number(val);
     if (this._projectVideo) this._projectVideo.roll = Cesium.Math.toRadians(this._options.roll);
   }
 
-  // 显隐线框
+  /**
+   * @description 设置线框显隐
+   * @param {Boolean} val 是否显示线框
+   */
   showHideLine(val) {
     this._options.showHideLine = val;
     if (this._projectVideo) {
       if (this._options.projectType == 1) {
+        // 平面投放：设置outline属性
         this._projectVideo.outline = val;
       } else {
+        // 模型投放：设置showHelperPrimitive属性
         this._projectVideo.showHelperPrimitive = val;
       }
     }
@@ -333,8 +376,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 获取组件传参
     const props = __props;
-    const lonlatOffset = 0.000010;
-    const heightOffset = 10.0;
+    const lonlatOffset = 0.000010; // 经纬度滑动条偏移量
+    const heightOffset = 10.0; // 高度滑动条偏移量
+
     let formItem = (0, _vue.reactive)({
       collapseValue: props?.settingParams?.collapseValue === '' ? '' : props?.settingParams?.collapseValue ?? "setting",
       // 默认展开属性设置
@@ -361,14 +405,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     let showCoordinate = (0, _vue.ref)(false);
     // 显示朝向角俯仰角翻转角
     let showHpr = (0, _vue.ref)(false);
-    let viewModel = null;
+    let viewModel = null; // 视频投影视图模型对象
 
     // 组件容器Ref
     let boxRef = (0, _vue.ref)(null);
 
     // 生成组件默认header
-    let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
+    let headerTemp = (0, _vue.ref)(); // 动态生成的Header组件
+    let headerTempRef = (0, _vue.ref)(); // Header组件Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
@@ -406,13 +451,21 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, 'webgl.videoProject');
       }
     };
+
+    /**
+     * @description 选择视频文件后获取本地访问URL并设置到视图模型
+     * @param {Object} file 上传的文件对象
+     */
     function selectVideo(file) {
       formItem.videoPath = file.name;
       let url = URL.createObjectURL(file.raw);
       viewModel.setVideoPath(url);
     }
 
-    // 参数改变
+    /**
+     * @description 参数改变时根据类型调用对应的视图模型方法
+     * @param {String} key 改变的参数类型标识
+     */
     function paramsChanged(key) {
       switch (key) {
         case "videoPath":
@@ -445,6 +498,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         case "longitude":
         case "latitude":
         case "height":
+          // 经纬度或高度变化时统一更新坐标
           viewModel.setPosition(formItem.longitude, formItem.latitude, formItem.height);
           break;
         default:
@@ -1125,11 +1179,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/viewshedanalysis/index.js

@@ -530,14 +530,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 不可见颜色
       lineColor: props?.settingParams?.lineColor ?? "#E6A23C" // 边界线颜色
     });
-    let viewModel = null;
+    let viewModel = null; // 可视域分析视图模型对象
 
     // 组件容器Ref
     let boxRef = (0, _vue.ref)(null);
 
     // 生成组件默认header
-    let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
+    let headerTemp = (0, _vue.ref)(); // 动态生成的Header组件
+    let headerTempRef = (0, _vue.ref)(); // Header组件Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
@@ -551,6 +552,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       });
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
+          // 需要重现时从本地存储恢复参数
           if (props.isReappear) {
             let options = localStorage.getItem('ViewshedAnalysis');
             if (options) {
@@ -584,6 +586,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, 'webgl.viewshedAnalysis');
       }
     };
+
+    /**
+     * @description 参数改变时根据类型调用对应的视图模型方法
+     * @param {String} key 改变的参数类型标识
+     */
     function paramsChanged(key) {
       switch (key) {
         case "height":
@@ -1196,10 +1203,17 @@ var _constImage = __webpack_require__(4822);
 
 //可视域分析逻辑类
 class ViewshedAnalysisViewModel {
+  //是否恢复上次分析结果
+  /**
+   * @description 构造函数，初始化可视域分析对象并根据配置恢复上次分析
+   * @param {Object} scenceView 场景视图对象，包含 _viewer 和 _drawManager 属性
+   * @param {Object} options 可视域分析配置参数
+   */
   constructor(scenceView, options) {
     this._viewshedAnalysis = null;
     //可视域分析三维对象
     this._viewer = null;
+    //三维viewer对象
     this._scene = null;
     //三维场景对象
     this._options = null;
@@ -1209,7 +1223,9 @@ class ViewshedAnalysisViewModel {
     this._position = null;
     //可视域分析初始点坐标
     this._drawManager = null;
+    //绘制管理器对象
     this._handler = null;
+    //事件处理对象
     this._isReappear = false;
     this._isReappear = options.isReappear;
     this._viewer = scenceView._viewer;
@@ -1217,9 +1233,11 @@ class ViewshedAnalysisViewModel {
     this._drawManager = scenceView._drawManager;
     this._scene.globe.depthTestAgainstTerrain = true;
     this._options = options;
+    // 解析可视颜色为Cesium颜色对象
     if (this._options.visibleColor) {
       this._options.visibleColor = Cesium.Color.fromCssColorString(this._options.visibleColor);
     }
+    // 解析不可视颜色为Cesium颜色对象
     if (this._options.visibleColor) {
       this._options.invisibleColor = Cesium.Color.fromCssColorString(this._options.invisibleColor);
     }
@@ -1231,6 +1249,7 @@ class ViewshedAnalysisViewModel {
     //   //   beforeDrawText: '',
     //   // });
     // }, window.Cesium.ScreenSpaceEventType.RIGHT_CLICK);
+    // 恢复上次分析结果
     if (this._isReappear) {
       let options = localStorage.getItem('ViewshedAnalysis');
       if (options) {
@@ -1257,7 +1276,9 @@ class ViewshedAnalysisViewModel {
     this.clear();
     this._viewshedAnalysis = new Cesium.Kq3dViewshedInteractive(this._scene, this._options);
     let that = this;
+    // 监听可视域交互事件，更新观察点和目标点
     this._viewshedAnalysis.event.addEventListener((p1, p2) => {
+      // p1存在表示设置了观察点
       if (p1 && p2 == undefined) {
         that._position = p1;
         let cartographic = Cesium.Cartographic.fromCartesian(p1);
@@ -1265,6 +1286,7 @@ class ViewshedAnalysisViewModel {
         if (that._marker) {
           that._marker.position = newPos;
         } else {
+          // 创建观察点图标
           that._marker = that._viewer.entities.add({
             position: newPos,
             billboard: {
@@ -1275,6 +1297,7 @@ class ViewshedAnalysisViewModel {
           });
         }
       }
+      // p2存在表示设置了目标点
       if (p2) that._target = p2;
     });
     // this._drawManager.startDraw("marker", { image: null }, (feature, { shape }) => {
@@ -1289,7 +1312,9 @@ class ViewshedAnalysisViewModel {
   //清除全部结果
   clear() {
     // this._drawManager?.stopDraw?.();
-    this._viewshedAnalysis && this._viewshedAnalysis.destroy();
+    this._viewshedAnalysis?.pause();
+    this._viewshedAnalysis?.stopHandle();
+    this._viewshedAnalysis?.destroy();
     this._viewshedAnalysis = null;
     if (this._marker) {
       this._viewer.entities.remove(this._marker);
@@ -1301,6 +1326,7 @@ class ViewshedAnalysisViewModel {
   //销毁
   destroy() {
     // this?._handler?.removeInputAction?.(window.Cesium.ScreenSpaceEventType.RIGHT_CLICK);
+    // 需要恢复时保存当前分析结果到本地存储
     if (this._viewshedAnalysis && this._isReappear) {
       let options = {
         offsetHeight: this._options.offsetHeight,
@@ -1316,7 +1342,10 @@ class ViewshedAnalysisViewModel {
     this.clear();
   }
 
-  //设置偏移高度
+  /**
+   * @description 设置偏移高度
+   * @param {Number} offsetHeight 偏移高度值
+   */
   setOffsetHeight(offsetHeight) {
     this._options.offsetHeight = Number(offsetHeight);
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.offsetHeight = this._options.offsetHeight;
@@ -1325,32 +1354,50 @@ class ViewshedAnalysisViewModel {
       this._marker.position = Cesium.Cartesian3.fromRadians(cartographic.longitude, cartographic.latitude, cartographic.height + this._options.offsetHeight);
     }
   }
-  //设置水平角
+  /**
+   * @description 设置水平角
+   * @param {Number} fovH 水平角度值
+   */
   setFovH(fovH) {
     this._options.fovH = Number(fovH);
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.fovH = this._options.fovH;
   }
-  //设置竖直角
+  /**
+   * @description 设置竖直角
+   * @param {Number} fovV 竖直角度值
+   */
   setFovV(fovV) {
     this._options.fovV = Number(fovV);
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.fovV = this._options.fovV;
   }
-  //设置可视颜色
+  /**
+   * @description 设置可视颜色
+   * @param {String} visibleColor 可视颜色的CSS颜色字符串
+   */
   setVisibleColor(visibleColor) {
     this._options.visibleColor = Cesium.Color.fromCssColorString(visibleColor);
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.visibleColor = this._options.visibleColor;
   }
-  //设置不可视颜色
+  /**
+   * @description 设置不可视颜色
+   * @param {String} invisibleColor 不可视颜色的CSS颜色字符串
+   */
   setInvisibleColor(invisibleColor) {
     this._options.invisibleColor = Cesium.Color.fromCssColorString(invisibleColor);
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.invisibleColor = this._options.invisibleColor;
   }
-  //设置网格线颜色
+  /**
+   * @description 设置网格线颜色
+   * @param {String} lineColor 网格线颜色的CSS颜色字符串
+   */
   setLineColor(lineColor) {
     this._options.lineColor = lineColor;
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.lineColor = Cesium.Color.fromCssColorString(lineColor);
   }
-  //显示/隐藏网格线
+  /**
+   * @description 显示/隐藏网格线
+   * @param {Boolean} showGridLine 是否显示网格线
+   */
   setShowGridLine(showGridLine) {
     this._options.showGridLine = showGridLine;
     if (this._viewshedAnalysis) this._viewshedAnalysis.attachedViewshed.showGridLine = showGridLine;
@@ -2416,11 +2463,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/weathereffect/index.js

@@ -34,12 +34,16 @@ var _constImage = __webpack_require__(4822);
  * All rights reserved.
  */
 
-let _gravityScratch = null;
-let _gravityStart = 0.0;
-let _gravityEnd = -1.0;
+let _gravityScratch = null; // 重力计算用的临时笛卡尔变量
+let _gravityStart = 0.0; // 重力随机范围起始值
+let _gravityEnd = -1.0; // 重力随机范围结束值
 //天气特效逻辑类
 class WeatherEffectViewModel {
   //雪图片url地址
+  /**
+   * @description 构造函数，初始化场景时钟及重力计算变量
+   * @param {Object} scenceView 场景视图对象，包含 _viewer 和 _drawManager 属性
+   */
   constructor(scenceView) {
     this._scene = null;
     //三维球场景视图对象
@@ -59,22 +63,33 @@ class WeatherEffectViewModel {
     this._drawManager = scenceView._drawManager;
     _gravityScratch = new Cesium.Cartesian3();
   }
+
+  /**
+   * @description 粒子更新回调，为粒子施加重力效果
+   * @param {Object} particle 粒子对象
+   * @param {Number} dt 时间增量
+   */
   applyGravity(particle, dt) {
     _gravityScratch = Cesium.Cartesian3.normalize(particle.position, _gravityScratch);
     Cesium.Cartesian3.multiplyByScalar(_gravityScratch, Cesium.Math.randomBetween(_gravityStart, _gravityEnd), _gravityScratch);
     particle.velocity = Cesium.Cartesian3.add(particle.velocity, _gravityScratch, particle.velocity);
   }
 
-  //添加天气特效
+  /**
+   * @description 添加天气特效（雨或雪）
+   * @param {Object} options 天气特效配置参数，包含 mode、gravity、lifeCycle 等
+   */
   addWeatherEffect(options) {
     var that = this;
     let mode = options.mode;
+    // 校验模式仅支持 rain 或 snow
     if (mode !== "rain" && mode !== "snow") {
       console.log("This mode is not supported.");
       return;
     }
     if (options.gravity) this.setGravity(options.gravity);
     this._options = options;
+    // 通过绘制管理器获取标记点位置作为粒子系统位置
     this._drawManager?.startDraw("marker", {
       image: null
     }, (feature, {
@@ -86,6 +101,7 @@ class WeatherEffectViewModel {
         if (position) {
           let matrix = new Cesium.Matrix4.fromTranslation(position);
           if (!that._particleSystem) {
+            // 首次创建粒子系统
             that._particleSystem = new Cesium.ParticleSystem({
               modelMatrix: matrix,
               lifetime: that._options.lifeCycle,
@@ -103,6 +119,7 @@ class WeatherEffectViewModel {
             });
             that._scene.primitives.add(that._particleSystem);
           } else {
+            // 已存在粒子系统时仅更新位置矩阵
             that._particleSystem.modelMatrix = matrix;
           }
         }
@@ -124,49 +141,72 @@ class WeatherEffectViewModel {
     this.clear();
   }
 
-  //设置范围半径
+  /**
+   * @description 设置范围半径
+   * @param {Number} radius 范围半径值
+   */
   setRangeRadius(radius) {
     if (this._particleSystem) {
       this._particleSystem.emitter = new Cesium.BoxEmitter(new Cesium.Cartesian3(radius, radius, radius));
     }
   }
-  //设置粒子数量
+  /**
+   * @description 设置粒子数量
+   * @param {Number} number 粒子数量值
+   */
   setParticleNumber(number) {
     if (this._particleSystem) {
       this._particleSystem.emissionRate = number;
     }
   }
-  //设置粒子大小
+  /**
+   * @description 设置粒子大小
+   * @param {Number} size 粒子大小值
+   */
   setParticleSize(size) {
     if (this._particleSystem) {
       this._particleSystem.minimumImageSize = new Cesium.Cartesian2(size, size);
       this._particleSystem.maximumImageSize = new Cesium.Cartesian2(size, size);
     }
   }
-  //设置生命周期
+  /**
+   * @description 设置生命周期
+   * @param {Number} lifeCycle 生命周期值
+   */
   setLifeCycle(lifeCycle) {
     if (this._particleSystem) {
       this._particleSystem.lifetime = lifeCycle;
     }
   }
-  //设置初始比例
+  /**
+   * @description 设置初始比例
+   * @param {Number} startScale 初始比例值
+   */
   setStartScale(startScale) {
     if (this._particleSystem) {
       this._particleSystem.startScale = startScale;
     }
   }
-  //设置结束比例
+  /**
+   * @description 设置结束比例
+   * @param {Number} endScale 结束比例值
+   */
   setEndScale(endScale) {
     if (this._particleSystem) {
       this._particleSystem.endScale = endScale;
     }
   }
-  //设置重力
+  /**
+   * @description 设置重力，根据值大小调整重力随机范围
+   * @param {Number} gravity 重力值
+   */
   setGravity(gravity) {
+    // 重力小于等于1时，起始值为0
     if (gravity <= 1) {
       _gravityStart = 0.0;
       _gravityEnd = 0 - gravity;
     } else {
+      // 重力大于1时，起始值为负值
       _gravityStart = 0 - (gravity - 1);
       _gravityEnd = 0 - gravity;
     }
@@ -309,14 +349,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       endScale: props?.settingParams?.endScale ?? 1.3,
       gravity: props?.settingParams?.gravity ?? 1
     });
-    let viewModel = null;
+    let viewModel = null; // 天气特效视图模型对象
 
     // 组件容器Ref
     let boxRef = (0, _vue.ref)(null);
 
     // 生成组件默认header
-    let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
+    let headerTemp = (0, _vue.ref)(); // 动态生成的Header组件
+    let headerTempRef = (0, _vue.ref)(); // Header组件Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
@@ -345,22 +386,32 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    //切换雨雪天气特效
+    /**
+     * @description 切换雨雪天气特效
+     * @param {String} mode 天气模式：rain-雨，snow-雪
+     */
     function changeMode(mode) {
       if (formItem.mode !== mode) {
         viewModel && viewModel.clear();
         formItem.mode = mode;
+        // 切换为雨模式且需要重置参数时恢复默认值
         if (mode === "rain" && formItem.isResetParams) {
           formItem.particleSize = 2.0;
           formItem.startScale = 1.1;
           formItem.endScale = 1.3;
         } else if (mode === "snow" && formItem.isResetParams) {
+          // 切换为雪模式且需要重置参数时恢复默认值
           formItem.particleSize = 0.6;
           formItem.startScale = 0.5;
           formItem.endScale = 0.6;
         }
       }
     }
+
+    /**
+     * @description 参数改变时根据类型调用对应的视图模型方法
+     * @param {String} key 改变的参数类型标识
+     */
     function paramsChanged(key) {
       switch (key) {
         case "rangeRadius":
@@ -388,9 +439,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 添加天气特效
     function add() {
       viewModel && viewModel.addWeatherEffect(formItem);
     }
+
+    // 清除天气特效
     function clear() {
       viewModel && viewModel.clear();
     }
@@ -2493,11 +2548,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;
 
 /***/ })