@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/particleeffect/index.js

@@ -717,6 +717,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     const props = __props;
+
+    //粒子特效表单参数
     let formItem = (0, _vue.reactive)({
       collapseValue: props?.settingParams?.collapseValue === '' ? '' : props?.settingParams?.collapseValue ?? "setting",
       // 默认展开属性设置
@@ -734,14 +736,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       endScale: props?.settingParams?.endScale ?? 1.0,
       gravity: props?.settingParams?.gravity ?? 0.0
     });
-    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 headerTempRef = (0, _vue.ref)(); // headerTemp组件Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
@@ -769,11 +772,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.particleEffect");
       }
     };
+
+    /**
+     * @description 切换粒子特效模式并重置默认参数
+     * @param {String} mode 模式名称（flame/smoke）
+     */
     function changeMode(mode) {
       if (formItem.mode !== mode) {
         // viewModel && viewModel.clear();
         formItem.mode = mode;
         if (mode === "flame" && formItem.isResetParams) {
+          // 火焰模式默认参数
           formItem.particleNum = 40;
           formItem.particleSize = 2.5;
           formItem.minLifeCycle = 0.5;
@@ -784,6 +793,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           formItem.endScale = 1.0;
           formItem.gravity = 0.0;
         } else if (mode === "smoke" && formItem.isResetParams) {
+          // 烟雾模式默认参数
           formItem.particleNum = 50;
           formItem.particleSize = 2;
           formItem.minLifeCycle = 3.5;
@@ -796,6 +806,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       }
     }
+
+    /**
+     * @description 表单参数变化处理
+     * @param {String} key 变化的字段名（particleNum/particleSize/minLifeCycle/maxLifeCycle/minSpeed/maxSpeed/startScale/endScale/gravity）
+     */
     function paramsChanged(key) {
       switch (key) {
         case "particleNum":
@@ -829,9 +844,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 添加粒子特效
     function add() {
       viewModel && viewModel.addParticleEffect(formItem);
     }
+
+    // 清除粒子特效
     function clear() {
       viewModel && viewModel.clear();
     }
@@ -1426,11 +1445,15 @@ var _constImage = __webpack_require__(4822);
  * All rights reserved.
  */
 
-let _gravityScratch = null;
-let _gravity = 1.0;
+let _gravityScratch = null; // 重力计算用的临时笛卡尔坐标缓存
+let _gravity = 1.0; // 当前重力系数
 //粒子特效逻辑类
 class ParticleEffectViewModel {
   //烟雾图片url地址
+  /**
+   * @description 构造函数：初始化粒子特效视图模型
+   * @param {Object} scenceView 场景视图对象
+   */
   constructor(scenceView) {
     this._scene = null;
     //三维球场景视图对象
@@ -1449,22 +1472,33 @@ class ParticleEffectViewModel {
     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, _gravity * dt, _gravityScratch);
     particle.velocity = Cesium.Cartesian3.add(particle.velocity, _gravityScratch, particle.velocity);
   }
 
-  //添加粒子特效
+  /**
+   * @description 添加粒子特效（启动绘制marker，绘制完成后创建粒子系统）
+   * @param {Object} options 粒子特效参数对象
+   */
   addParticleEffect(options) {
     var that = this;
     let mode = options.mode;
+    // 仅支持火焰和烟雾两种模式
     if (mode !== "flame" && mode !== "smoke") {
       console.log("This mode is not supported.");
       return;
     }
     if (options.gravity) this.setGravity(options.gravity);
     this._options = options;
+    // 启动marker绘制，绘制完成后回调创建粒子系统
     this._drawManager?.startDraw("marker", {
       image: null
     }, (feature, {
@@ -1474,8 +1508,10 @@ class ParticleEffectViewModel {
       if (shape && shape.type === "marker") {
         let position = shape.position;
         if (position) {
+          // 将绘制位置转为变换矩阵作为粒子系统原点
           let matrix = new Cesium.Matrix4.fromTranslation(position);
           if (that._options.mode === "flame") {
+            // 火焰模式：创建火焰粒子系统
             let fireParticle = new Cesium.ParticleSystem({
               emissionRate: that._options.particleNum,
               imageSize: new Cesium.Cartesian2(that._options.particleSize, 2 * that._options.particleSize),
@@ -1497,6 +1533,7 @@ class ParticleEffectViewModel {
             that._scene.primitives.add(fireParticle);
             that._particleSystemList.push(fireParticle);
           } else if (that._options.mode === "smoke") {
+            // 烟雾模式：创建烟雾粒子系统
             let smokeParticle = new Cesium.ParticleSystem({
               emissionRate: that._options.particleNum,
               imageSize: new Cesium.Cartesian2(that._options.particleSize, that._options.particleSize),
@@ -1553,62 +1590,91 @@ class ParticleEffectViewModel {
     this.clear();
   }
 
-  //设置粒子数量
+  /**
+   * @description 设置粒子数量
+   * @param {Number} number 粒子数量
+   */
   setParticleNumber(number) {
     this._particleSystemList.forEach(particle => {
       particle.emissionRate = number;
     });
   }
-  //设置粒子大小
+  /**
+   * @description 设置粒子大小（火焰模式下高度为宽度的2倍）
+   * @param {Number} size 粒子大小
+   */
   setParticleSize(size) {
     let mode = this._options.mode;
     this._particleSystemList.forEach(particle => {
       if (mode === "flame") {
+        // 火焰模式：高度为宽度的2倍
         particle.minimumImageSize = new Cesium.Cartesian2(size, 2 * size);
         particle.maximumImageSize = new Cesium.Cartesian2(size, 2 * size);
       } else {
+        // 烟雾模式：宽高一致
         particle.minimumImageSize = new Cesium.Cartesian2(size, size);
         particle.maximumImageSize = new Cesium.Cartesian2(size, size);
       }
     });
   }
-  //设置最小生命周期
+  /**
+   * @description 设置最小生命周期
+   * @param {Number} minLifeCycle 最小生命周期
+   */
   setMinLifeCycle(minLifeCycle) {
     this._particleSystemList.forEach(particle => {
       particle.minimumParticleLife = minLifeCycle;
     });
   }
-  //设置最大生命周期
+  /**
+   * @description 设置最大生命周期
+   * @param {Number} maxLifeCycle 最大生命周期
+   */
   setmaxLifeCycle(maxLifeCycle) {
     this._particleSystemList.forEach(particle => {
       particle.maximumParticleLife = maxLifeCycle;
     });
   }
-  //设置最小速度
+  /**
+   * @description 设置最小速度
+   * @param {Number} minSpeed 最小速度
+   */
   setMinSpeed(minSpeed) {
     this._particleSystemList.forEach(particle => {
       particle.minimumSpeed = minSpeed;
     });
   }
-  //设置最大速度
+  /**
+   * @description 设置最大速度
+   * @param {Number} maxSpeed 最大速度
+   */
   setMaxSpeed(maxSpeed) {
     this._particleSystemList.forEach(particle => {
       particle.maximumSpeed = maxSpeed;
     });
   }
-  //设置初始比例
+  /**
+   * @description 设置初始比例
+   * @param {Number} startScale 初始比例
+   */
   setStartScale(startScale) {
     this._particleSystemList.forEach(particle => {
       particle.startScale = startScale;
     });
   }
-  //设置结束比例
+  /**
+   * @description 设置结束比例
+   * @param {Number} endScale 结束比例
+   */
   setEndScale(endScale) {
     this._particleSystemList.forEach(particle => {
       particle.endScale = endScale;
     });
   }
-  //设置重力
+  /**
+   * @description 设置重力
+   * @param {Number} gravity 重力系数
+   */
   setGravity(gravity) {
     _gravity = gravity;
   }
@@ -2469,11 +2535,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/planeclip/index.js

@@ -111,10 +111,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       lang,
       locale
     } = (0, _useGlobalConfig.useLocale)();
-    let tiles = (0, _vue.ref)([]);
+    let tiles = (0, _vue.ref)([]); // 所有3dtiles模型对象列表
 
     // 获取组件传参
     const props = __props;
+
+    //平面裁剪表单参数
     let formItem = (0, _vue.reactive)({
       collapseValue: props?.settingParams?.collapseValue === '' ? '' : props?.settingParams?.collapseValue ?? "setting",
       // 默认展开属性设置
@@ -125,14 +127,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       boxEnable: props?.settingParams?.boxEnable ?? false,
       clipDistance: props?.settingParams?.clipDistance ?? 0
     });
-    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 headerTempRef = (0, _vue.ref)(); // headerTemp组件Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
@@ -163,10 +166,16 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         callbackParams();
       }, 1000);
     });
+    /**
+     * @description 视图模型回调参数处理（刷新图层列表并默认选中第一个）
+     * @param {String} key 回调类型
+     * @param {*} val 回调数据
+     */
     function callbackParams(key, val) {
       if (viewModel) {
         tiles.value = viewModel.findLayers(); // 获取所有tileset对象
         formItem.tileset = "";
+        // 默认选中第一个图层
         if (tiles.value.length > 0) {
           formItem.tileset = tiles.value[0].guid;
         }
@@ -183,7 +192,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    // 参数改变
+    /**
+     * @description 参数改变处理
+     * @param {String} key 变化的字段名（tileset/clipDirection/reverseClip/enableClip/boxEnable/distance）
+     */
     function paramsChanged(key) {
       switch (key) {
         case "tileset":
@@ -472,6 +484,13 @@ var _useGlobalConfig = __webpack_require__(22686);
 //平面裁剪逻辑类
 
 class PlaneClipViewModel {
+  // 视图模型回调函数
+  /**
+   * @description 构造函数：初始化平面裁剪视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} options 平面裁剪参数对象
+   * @param {Function} callbackParams 视图模型回调函数
+   */
   constructor(scenceView, options, callbackParams) {
     this._viewer = null;
     //三维viewer对象
@@ -484,7 +503,6 @@ class PlaneClipViewModel {
       z: 0,
       angle: 0,
       boxColor: Cesium.Color.fromCssColorString("#316882").withAlpha(0.4),
-      clipEdgeWidth: 4.0,
       clipEdgeColorLables: "#63cf25",
       clipEdgeColor: Cesium.Color.fromCssColorString("#63cf25"),
       clipEdgeWidth: 3,
@@ -506,6 +524,7 @@ class PlaneClipViewModel {
     this._drawManager = null;
     //绘制管理对象
     this._language = {};
+    // 当前语言包
     this.callbackParams = null;
     const {
       locale
@@ -522,6 +541,10 @@ class PlaneClipViewModel {
     // 添加图层数据源变化监听
     _gisUtils.mapViewUtils.bindViewEvents("resetLayerDatas", this._resetListData, scenceView._viewerId);
   }
+  /**
+   * @description 图层数据源变化时重置列表数据
+   * @param {Object} e 事件对象
+   */
   _resetListData(e) {
     // 如果图层变化事件是自己触发的 则不继续执行 避免死循环
     if (e.eventTarget && e.eventTarget === this) {
@@ -531,10 +554,11 @@ class PlaneClipViewModel {
   }
   // 查找所有3dtiles模型对象
   findLayers() {
-    let tilesets = [];
+    const tilesets = [];
     const primitives = this._options.viewer.scene.primitives._primitives;
     for (let m = 0; m < primitives.length; m++) {
       if (primitives[m] instanceof Cesium.Cesium3DTileset) {
+        // 跳过隐藏的模型
         if (!primitives[m].show) continue;
         tilesets.push({
           guid: primitives[m].guid,
@@ -545,7 +569,11 @@ class PlaneClipViewModel {
     return tilesets;
   }
 
-  //根据id获取tileset对象
+  /**
+   * @description 根据id获取tileset对象
+   * @param {String} id 图层guid
+   * @returns {Object} tileset对象
+   */
   findLayerById(id) {
     const primitives = this._options.viewer.scene.primitives._primitives;
     const tileset = primitives.find(function (item) {
@@ -556,7 +584,7 @@ class PlaneClipViewModel {
 
   // 开始分析
   start() {
-    let that = this;
+    const that = this;
     // 判断是否添加了模型
     var flag = false;
     var models = this._options.viewer.scene.primitives._primitives;
@@ -566,6 +594,7 @@ class PlaneClipViewModel {
       }
     }
     if (flag) {
+      // 存在可见模型：启动marker绘制，绘制完成后创建裁剪对象
       if (!this._drawManager) return;
       this._drawManager.startDraw("marker", {
         image: null
@@ -581,6 +610,7 @@ class PlaneClipViewModel {
         that._drawManager && that._drawManager.clearDrawGroup("PlaneClipDraw");
       }, "PlaneClipDraw");
     } else {
+      // 无可见模型：弹出提示
       (0, _message.default)({
         message: this._language.value.webgl["addModelAnalysisTips"],
         type: "warning"
@@ -603,18 +633,27 @@ class PlaneClipViewModel {
     _gisUtils.mapViewUtils.offViewEvents("resetLayerDatas", this._resetListData, this._viewer._container.id);
   }
 
-  // 设置裁剪对象
+  /**
+   * @description 设置裁剪对象
+   * @param {String} layerId 图层guid
+   */
   setLayer(layerId) {
     this.clear();
     this._options.tileset = this.findLayerById(layerId);
   }
 
-  // 设置裁剪方向,2:x,3:y,z:4
+  /**
+   * @description 设置裁剪方向,2:x,3:y,z:4
+   * @param {Number} val 裁剪方向值（2:x,3:y,4:z）
+   */
   setClipDirection(val) {
     this._options.clipType = val;
     if (this._planeclipAnalysis) this._planeclipAnalysis.clipType = val;
   }
-  // 设置裁剪方式,为false时，则为正向裁剪，否则为逆向裁剪
+  /**
+   * @description 设置裁剪方式,为false时，则为正向裁剪，否则为逆向裁剪
+   * @param {Boolean} val 是否逆向裁剪
+   */
   setClipType(val) {
     this._options.reverseClip = val;
     if (this._planeclipAnalysis) {
@@ -622,7 +661,10 @@ class PlaneClipViewModel {
       this._planeclipAnalysis.distance = this._options.distance;
     }
   }
-  //是否裁剪
+  /**
+   * @description 是否裁剪
+   * @param {Boolean} val 是否启用裁剪
+   */
   setEnable(val) {
     this._options.enable = val;
     if (this._planeclipAnalysis) {
@@ -630,13 +672,20 @@ class PlaneClipViewModel {
       this._planeclipAnalysis.boxEnable = this._options.boxEnable;
     }
   }
-  //显/隐辅助对象
+  /**
+   * @description 显/隐辅助对象
+   * @param {Boolean} val 是否显示辅助盒子
+   */
   setShowBox(val) {
     this._options.boxEnable = val;
     if (this._planeclipAnalysis) this._planeclipAnalysis.boxEnable = val;
   }
-  //设置裁剪距离
+  /**
+   * @description 设置裁剪距离
+   * @param {Number} val 裁剪距离值
+   */
   setDistance(val) {
+    // z方向裁剪时距离取反
     if (this._options.clipType == 4) {
       this._options.distance = -Number(val);
     } else {
@@ -2465,11 +2514,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;
 
 /***/ })