@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/excavatefillanalysis/index.js

@@ -529,6 +529,8 @@ const _hoisted_5 = {
 const _hoisted_6 = {
   class: "title"
 };
+// 是否显示分析结果面板
+
 const __default__ = {
   name: "Kq3dExcavateFillAnalysis"
 };
@@ -583,6 +585,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     let showResult = (0, _vue.ref)(false);
+    // 分析结果数据（挖方/填方体积）
     let result = (0, _vue.reactive)({
       cutVolumn: "NaN",
       fillVolumn: "NaN"
@@ -609,6 +612,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 填方颜色
       restrictedArea: settingParams.restrictedArea ?? null // 限制绘制面积
     });
+
+    // 填挖方分析视图模型实例
     let viewModel = null;
 
     // 组件容器Ref
@@ -616,6 +621,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);
@@ -634,12 +640,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             setTimeout(() => {
               showResult.value = true;
               const cutVolumn = viewModel._excavateFillAnalysis.cutVolumn;
+              // 挖方体积超过10亿则换算为立方千米显示
               if (cutVolumn > 1000000000) {
                 result.cutVolumn = (cutVolumn / 1000000000).toFixed(2) + " km³";
               } else {
                 result.cutVolumn = cutVolumn.toFixed(2) + " m³";
               }
               const fillVolumn = viewModel._excavateFillAnalysis.fillVolumn;
+              // 填方体积超过10亿则换算为立方千米显示
               if (fillVolumn > 1000000000) {
                 result.fillVolumn = (fillVolumn / 1000000000).toFixed(2) + " km³";
               } else {
@@ -674,18 +682,25 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       showResult.value = false;
       viewModel && viewModel.clear();
     }
+
+    /** @description 参数变化处理，根据变化的参数类型更新分析状态与结果展示
+     * @param {string} key 变化的参数类型（height/cutColor/fillColor）
+     */
     function paramsChanged(key) {
       switch (key) {
+        // 高度变化：更新基准高度并刷新结果
         case "height":
           viewModel.setReferenceHeight(formItem.altitudeHeight);
           if (showResult.value) {
             const cutVolumn = viewModel._excavateFillAnalysis.cutVolumn;
+            // 挖方体积超过10亿则换算为立方千米显示
             if (cutVolumn > 1000000000) {
               result.cutVolumn = (cutVolumn / 1000000000).toFixed(2) + " km³";
             } else {
               result.cutVolumn = cutVolumn.toFixed(2) + " m³";
             }
             const fillVolumn = viewModel._excavateFillAnalysis.fillVolumn;
+            // 填方体积超过10亿则换算为立方千米显示
             if (fillVolumn > 1000000000) {
               result.fillVolumn = (fillVolumn / 1000000000).toFixed(2) + " km³";
             } else {
@@ -693,9 +708,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             }
           }
           break;
+        // 挖方颜色变化
         case "cutColor":
           viewModel.setCutColor(formItem.excavateColor);
           break;
+        // 填方颜色变化
         case "fillColor":
           viewModel.setFillColor(formItem.fillColor);
           break;
@@ -703,6 +720,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+
+    // 关闭结果面板
     function closeBtn() {
       showResult.value = false;
     }
@@ -1259,6 +1278,12 @@ var _useGlobalConfig = __webpack_require__(22686);
 //填挖方分析逻辑类
 
 class ExcavateFillAnalysisViewModel {
+  //限制绘制面积阈值
+  /** @description 构造函数，初始化填挖方分析视图模型
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} options 填挖方分析配置参数
+   * @param {Function} callback 分析完成回调函数
+   */
   constructor(scenceView, options, callback) {
     this._excavateFillAnalysis = null;
     //填挖方分析三维对象
@@ -1267,7 +1292,9 @@ class ExcavateFillAnalysisViewModel {
     this._options = null;
     //填挖方分析存储参数对象
     this._language = {};
+    // 多语言资源对象
     this._scenceView = null;
+    //三维场景视图对象
     this._restrictedArea = null;
     const {
       locale
@@ -1286,10 +1313,14 @@ class ExcavateFillAnalysisViewModel {
     this.callback = callback;
   }
 
-  // 处理绘制坐标，转成二维坐标
+  /** @description 处理绘制坐标，将三维笛卡尔坐标转换为经纬度二维坐标
+   * @param {Array} points 三维笛卡尔坐标点集合
+   * @returns {Array} 转换后的经纬度坐标点集合
+   */
   coordinateTransform(points) {
     let cutPoints = points.map(function (point) {
       let cartesPh = Cesium.Cartographic.fromCartesian(point);
+      // 弧度转换为角度
       cartesPh.longitude = cartesPh.longitude / Math.PI * 180;
       cartesPh.latitude = cartesPh.latitude / Math.PI * 180;
       let map = {
@@ -1307,6 +1338,7 @@ class ExcavateFillAnalysisViewModel {
     var that = this;
     // 判断是否添加了地形
     if (this._options.viewer.terrainProvider.availability) {
+      // 判断地形是否为非 heightmap 结构（即量化地形）
       if (this._options.viewer.terrainProvider && !this._options.viewer.terrainProvider._heightmapStructure) {
         if (this._drawManager) {
           this._drawManager.startDraw("polygon", {
@@ -1314,11 +1346,14 @@ class ExcavateFillAnalysisViewModel {
           }, (feature, {
             shape
           }) => {
+            // 过滤非当前分析组绘制的要素
             if (!shape.groupName || shape.groupName !== "ExcavateFillAnalysisDraw") return;
             that._drawManager.clearDrawGroup("ExcavateFillAnalysisDraw");
             if (shape) {
+              // 限制绘制面积检查
               if (typeof that._restrictedArea === 'number' && !isNaN(that._restrictedArea) && isFinite(that._restrictedArea)) {
                 const area = that._scenceView.computePolygonArea(shape._controlPoints);
+                // 绘制面积超过限制范围则提示并终止
                 if (area / 1000000 > Number(that._restrictedArea)) {
                   (0, _message.default)({
                     message: this._language.value.webgl["restrictedAreaTips"],
@@ -1327,6 +1362,7 @@ class ExcavateFillAnalysisViewModel {
                   return;
                 }
               }
+              // 坐标转换并创建填挖方分析对象
               that._options.positions = that.coordinateTransform(shape._controlPoints);
               that._excavateFillAnalysis = new Cesium.Kq3dCutFill(that._options);
               that.callback && that.callback();
@@ -1334,12 +1370,14 @@ class ExcavateFillAnalysisViewModel {
           }, "ExcavateFillAnalysisDraw");
         }
       } 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"
@@ -1361,21 +1399,27 @@ class ExcavateFillAnalysisViewModel {
     this._excavateFillAnalysis = null;
   }
 
-  //设置基准高度
+  /** @description 设置基准高度
+   * @param {number} height 基准高度值
+   */
   setReferenceHeight(height) {
     this._options.referenceHeight = Number(height);
     if (this._excavateFillAnalysis) {
       this._excavateFillAnalysis.referenceHeight = Number(height);
     }
   }
-  //设置挖方颜色
+  /** @description 设置挖方颜色
+   * @param {string} cutColor 挖方颜色（CSS颜色字符串）
+   */
   setCutColor(cutColor) {
     this._options.cutColor = Cesium.Color.fromCssColorString(cutColor).withAlpha(0.7);
     if (this._excavateFillAnalysis) {
       this._excavateFillAnalysis.cutColor = this._options.cutColor;
     }
   }
-  //设置填方颜色
+  /** @description 设置填方颜色
+   * @param {string} fillColor 填方颜色（CSS颜色字符串）
+   */
   setFillColor(fillColor) {
     this._options.fillColor = Cesium.Color.fromCssColorString(fillColor).withAlpha(0.7);
     if (this._excavateFillAnalysis) {
@@ -2361,11 +2405,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/fixedzoomin/index.js

@@ -175,6 +175,9 @@ exports["default"] = void 0;
 // 三维固定缩放逻辑
 class FixedZoomin3dViewModel {
   //三维viewer对象
+  /** @description 构造函数，初始化三维viewer对象
+   * @param {Object} viewer 三维viewer对象
+   */
   constructor(viewer) {
     this._viewer = null;
     this._viewer = viewer;
@@ -195,16 +198,22 @@ class FixedZoomin3dViewModel {
     return result;
   }
 
-  //地图缩小
+  /** @description 地图缩小，根据场景模式分发到对应处理方法
+   * @param {number} scale 缩放比例
+   */
   zoom(scale) {
+    // 三维模式缩放
     if (this._viewer.scene.mode == Cesium.SceneMode.SCENE3D) {
       this.zoom3D(scale);
     } else if (this._viewer.scene.mode == Cesium.SceneMode.SCENE2D) {
+      // 二维模式缩放
       this.zoom2D(scale);
     }
   }
 
-  // 二维模式缩小
+  /** @description 三维模式缩小，基于相机焦点计算飞行终点
+   * @param {number} scale 缩放比例
+   */
   zoom3D(scale) {
     if (!this._viewer) return;
     var scene = this._viewer.scene;
@@ -223,14 +232,18 @@ class FixedZoomin3dViewModel {
         roll: camera.roll
       };
     } else {
+      // 相机指向地球时使用相机方向与向上向量
       orientation = {
         direction: camera.direction,
         up: camera.up
       };
     }
     var cartesian3Scratch = new Cesium.Cartesian3();
+    // 计算相机到焦点的方向向量
     var direction = Cesium.Cartesian3.subtract(camera.position, focus, cartesian3Scratch);
+    // 按缩放比例计算移动向量
     var movementVector = Cesium.Cartesian3.multiplyByScalar(direction, scale, direction);
+    // 计算飞行终点位置
     var endPosition = Cesium.Cartesian3.add(focus, movementVector, focus);
     camera.flyTo({
       destination: endPosition,
@@ -240,12 +253,14 @@ class FixedZoomin3dViewModel {
     });
   }
 
-  // 二维模式缩小
+  /** @description 二维模式缩小，基于相机高度按比例缩小
+   * @param {number} scale 缩放比例
+   */
   zoom2D(scale) {
     if (!this._viewer) return;
     var scene = this._viewer.scene;
     var camera = scene.camera;
-    let height = camera.positionCartographic.height;
+    const height = camera.positionCartographic.height;
     camera.zoomOut(scale * height / 2);
   }
 }
@@ -371,7 +386,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   },
   setup(__props) {
     const props = __props;
+    // 固定缩小视图模型实例
     let viewModel = null;
+    // 按钮组件Ref
     let btn = (0, _vue.ref)(null);
 
     // 国际化
@@ -507,11 +524,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/fixedzoomout/index.js

@@ -50,7 +50,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   },
   setup(__props) {
     const props = __props;
+
+    // 固定放大视图模型实例
     let viewModel = null;
+    // 按钮组件Ref
     let btn = (0, _vue.ref)(null);
 
     // 国际化
@@ -420,6 +423,9 @@ exports["default"] = void 0;
 // 三维固定缩放逻辑
 class FixedZoomout3dViewModel {
   //三维viewer对象
+  /** @description 构造函数，初始化三维viewer对象
+   * @param {Object} viewer 三维viewer对象
+   */
   constructor(viewer) {
     this._viewer = null;
     this._viewer = viewer;
@@ -439,16 +445,22 @@ class FixedZoomout3dViewModel {
     }
     return result;
   }
-  //地图放大
+  /** @description 地图放大，根据场景模式分发到对应处理方法
+   * @param {number} scale 缩放比例
+   */
   zoom(scale) {
+    // 三维模式缩放
     if (this._viewer.scene.mode == Cesium.SceneMode.SCENE3D) {
       this.zoom3D(scale);
     } else if (this._viewer.scene.mode == Cesium.SceneMode.SCENE2D) {
+      // 二维模式缩放
       this.zoom2D(scale);
     }
   }
 
-  // 三维模式放大
+  /** @description 三维模式放大，基于相机焦点计算飞行终点
+   * @param {number} scale 缩放比例
+   */
   zoom3D(scale) {
     if (!this._viewer) return;
     var scene = this._viewer.scene;
@@ -466,14 +478,18 @@ class FixedZoomout3dViewModel {
         roll: camera.roll
       };
     } else {
+      // 相机指向地球时使用相机方向与向上向量
       orientation = {
         direction: camera.direction,
         up: camera.up
       };
     }
     var cartesian3Scratch = new Cesium.Cartesian3();
+    // 计算相机到焦点的方向向量
     var direction = Cesium.Cartesian3.subtract(camera.position, focus, cartesian3Scratch);
+    // 按缩放比例计算移动向量
     var movementVector = Cesium.Cartesian3.multiplyByScalar(direction, scale, direction);
+    // 计算飞行终点位置
     var endPosition = Cesium.Cartesian3.add(focus, movementVector, focus);
     camera.flyTo({
       destination: endPosition,
@@ -483,12 +499,14 @@ class FixedZoomout3dViewModel {
     });
   }
 
-  // 二维模式放大
+  /** @description 二维模式放大，基于相机高度按比例放大
+   * @param {number} scale 缩放比例
+   */
   zoom2D(scale) {
     if (!this._viewer) return;
     var scene = this._viewer.scene;
     var camera = scene.camera;
-    let height = camera.positionCartographic.height;
+    const height = camera.positionCartographic.height;
     camera.zoomIn(height * scale);
   }
 }
@@ -505,11 +523,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;
 
 /***/ })