@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/roller/index.js

@@ -94,6 +94,11 @@ exports["default"] = void 0;
 //卷帘逻辑类
 class RollerViewModel {
   //上下卷帘活动状态
+  /**
+   * @description 构造函数：初始化卷帘视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} options 选项对象（包含图层数组）
+   */
   constructor(scenceView, options) {
     this._viewer = null;
     //三维viewer对象
@@ -115,14 +120,17 @@ class RollerViewModel {
     this._viewer = scenceView._viewer;
     this._layerManager = scenceView._layerManager;
     this._layers = options.layers;
+    // 创建左右卷帘分割线DOM元素
     this._lrSlider = document.createElement("div");
     this._lrSlider.class = "shutter-slider";
     this._lrSlider.id = "lrSlider";
+    // 创建上下卷帘分割线DOM元素
     this._tbSlider = document.createElement("div");
     this._tbSlider.class = "shutter-slider";
     this._tbSlider.id = "tbSlider";
     this._viewer.container.appendChild(this._lrSlider);
     this._viewer.container.appendChild(this._tbSlider);
+    // 延迟初始化图层，等待图层加载完成
     setTimeout(() => {
       this.initLayers();
     }, 500);
@@ -131,46 +139,55 @@ class RollerViewModel {
 
   //注册卷帘拖动事件
   registerEvents() {
-    let that = this;
+    const that = this;
+    // 左右卷帘分割线事件处理
     this._lrSliderHandler = new Cesium.ScreenSpaceEventHandler(this._lrSlider);
+    // 鼠标左键按下：激活左右卷帘拖动
     this._lrSliderHandler.setInputAction(function () {
       that._lrSliderActive = true;
     }, Cesium.ScreenSpaceEventType.LEFT_DOWN);
+    // 鼠标移动：根据位置更新分割位置
     this._lrSliderHandler.setInputAction(function (movement) {
       if (!that._lrSliderActive) {
         return;
       }
-      let relativeOffset = movement.endPosition.x;
-      let splitPosition = (that._lrSlider.offsetLeft + relativeOffset) / that._lrSlider.parentElement.parentElement.offsetWidth;
+      const relativeOffset = movement.endPosition.x;
+      const splitPosition = (that._lrSlider.offsetLeft + relativeOffset) / that._lrSlider.parentElement.parentElement.offsetWidth;
       that._lrSlider.style.left = 100.0 * splitPosition + "%";
       if (that._viewer.scene.imagerySplitPosition !== undefined) that._viewer.scene.imagerySplitPosition = splitPosition;else that._viewer.scene.splitPosition = splitPosition;
     }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
+    // 鼠标左键抬起：停止拖动
     this._lrSliderHandler.setInputAction(function () {
       that._lrSliderActive = false;
     }, Cesium.ScreenSpaceEventType.LEFT_UP);
+
+    // 上下卷帘分割线事件处理
     this._tbSliderHandler = new Cesium.ScreenSpaceEventHandler(this._tbSlider);
+    // 鼠标左键按下：激活上下卷帘拖动
     this._tbSliderHandler.setInputAction(function () {
       that._tbSliderActive = true;
     }, Cesium.ScreenSpaceEventType.LEFT_DOWN);
+    // 鼠标移动：根据位置更新分割位置
     this._tbSliderHandler.setInputAction(function (movement) {
       if (!that._tbSliderActive) {
         return;
       }
-      let relativeOffset = movement.endPosition.y;
-      let splitPosition = 1.0 - (that._tbSlider.offsetTop + relativeOffset) / that._tbSlider.parentElement.parentElement.offsetHeight;
+      const relativeOffset = movement.endPosition.y;
+      const splitPosition = 1.0 - (that._tbSlider.offsetTop + relativeOffset) / that._tbSlider.parentElement.parentElement.offsetHeight;
       that._tbSlider.style.top = 100.0 * (1.0 - splitPosition) + "%";
       // 兼容Cesium186和1102
       if (that._viewer.scene.imagerySplitPosition !== undefined) that._viewer.scene.imagerySplitPosition = splitPosition;else that._viewer.scene.splitPosition = splitPosition;
     }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
+    // 鼠标左键抬起：停止拖动
     this._tbSliderHandler.setInputAction(function () {
       that._tbSliderActive = false;
     }, Cesium.ScreenSpaceEventType.LEFT_UP);
   }
   //初始化图层数据
   initLayers() {
-    let layers = this._layerManager.getLayerCheckedList();
+    const layers = this._layerManager.getLayerCheckedList();
     for (let i = 0; i < layers.length; i++) {
-      let layer = this._layerManager.getLayerByGuid(layers[i].guid);
+      const layer = this._layerManager.getLayerByGuid(layers[i].guid);
       if (layer instanceof Cesium.ImageryLayer || layer instanceof Cesium.Cesium3DTileset) {
         this._layers.push({
           guid: layers[i].guid,
@@ -181,21 +198,28 @@ class RollerViewModel {
     }
   }
 
+  /**
+   * @description 切换卷帘模式
+   * @param {Number} mode 模式值（1:左右卷帘,2:上下卷帘,0/其他:无卷帘）
+   */
   //切换模式
   changeMode(mode) {
     let direction = 0;
     let splitdirection = Cesium.ImagerySplitDirection ? Cesium.ImagerySplitDirection.NONE : Cesium.SplitDirection.NONE;
     let splitPosition = 0.5;
+    // 先隐藏所有分割线
     this._lrSlider.style.display = "none";
     this._tbSlider.style.display = "none";
     switch (mode) {
       case 1:
+        // 左右卷帘模式
         direction = 1;
         this._lrSlider.style.display = "block";
         splitdirection = Cesium.ImagerySplitDirection ? Cesium.ImagerySplitDirection.LEFT : Cesium.SplitDirection.LEFT;
         splitPosition = this._lrSlider.offsetLeft / this._lrSlider.parentElement.parentElement.offsetWidth;
         break;
       case 2:
+        // 上下卷帘模式
         direction = 3;
         this._tbSlider.style.display = "block";
         splitdirection = Cesium.ImagerySplitDirection ? Cesium.ImagerySplitDirection.TOP : Cesium.SplitDirection.TOP;
@@ -204,22 +228,29 @@ class RollerViewModel {
       default:
         break;
     }
-    let that = this;
+    const that = this;
+    // 同步所有图层的方向和分割方向
     this._layers.forEach(layer => {
       layer.direction = direction;
-      let layerObj = that._layerManager.getLayerByGuid(layer.guid);
+      const layerObj = that._layerManager.getLayerByGuid(layer.guid);
       if (layerObj) layerObj.splitDirection = splitdirection;
     });
     if (mode !== 0) {
+      // 兼容Cesium186和1102
       if (this._viewer.scene.imagerySplitPosition !== undefined) {
         this._viewer.scene.imagerySplitPosition = splitPosition;
       } else this._viewer.scene.splitPosition = splitPosition;
     }
   }
 
+  /**
+   * @description 改变指定图层的卷帘方向
+   * @param {Number} index 图层在列表中的索引
+   */
   //改变方向
   changeDirection(index) {
-    let direction = this._layers[index].direction;
+    const direction = this._layers[index].direction;
+    // 兼容Cesium186和1102的分割方向枚举
     let splitDirection = Cesium.ImagerySplitDirection;
     if (!splitDirection) {
       splitDirection = Cesium.SplitDirection;
@@ -240,12 +271,13 @@ class RollerViewModel {
         splitdirection = splitDirection.BOTTOM;
         break;
       case 5:
+        // 隐藏图层
         show = false;
         break;
       default:
         break;
     }
-    let layer = this._layerManager.getLayerByGuid(this._layers[index].guid);
+    const layer = this._layerManager.getLayerByGuid(this._layers[index].guid);
     if (layer) {
       layer.show = show;
       layer.splitDirection = splitdirection;
@@ -1021,18 +1053,20 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         "font-size": "14px"
       };
     };
+
+    //卷帘表单参数
     let formItem = (0, _vue.reactive)({
       mode: props?.settingParams?.mode ?? null
     });
-    let layers = (0, _vue.reactive)([]);
-    let viewModel = null;
+    let layers = (0, _vue.reactive)([]); // 卷帘图层列表
+    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) => {
@@ -1069,7 +1103,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       let mode = formItem.mode;
       viewModel && viewModel.changeMode(formItem.mode);
     }
-    // 改变方向
+    /**
+     * @description 改变方向
+     * @param {Number} index 图层在列表中的索引
+     */
     function changeDirection(index) {
       viewModel && viewModel.changeDirection(index);
     }
@@ -1313,11 +1350,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/scaneffect/index.js

@@ -87,41 +87,72 @@ var _useGlobalConfig = __webpack_require__(22686);
 // 国际化
 
 class ScanEffectViewModel {
+  // 国际化语言对象
+  /**
+   * @description 构造函数，初始化扫描效果视图模型
+   * @param {Object} scenceView 场景视图对象，包含 _viewer 与 _drawManager
+   * @param {Object} option 表单参数对象，包含扫描样式、半径、颜色等配置
+   */
   constructor(scenceView, option) {
     this._viewer = null;
+    // Cesium 视图对象
     //参数
     this._options = {
       scanMode: 1,
       // 分析类型
       viewer: null,
+      // Cesium 视图对象
       lineWidth: 5,
+      // 线扫描宽度
       glowWidth: 20,
+      // 扫描线发光宽度
       length: 100,
+      // 扫描线长度
       origin: null,
+      // 扫描起点（笛卡尔坐标）
       direction: 45 / 180 * Math.PI,
+      // 扫描方向（弧度）
       color: window.Cesium.Color.fromCssColorString("#78f1fa"),
+      // 扫描颜色
       speed: 20,
+      // 扫描速度
       period: 5,
+      // 周期样式周期
       moveMode: 0,
+      // 移动模式
       lineColor: window.Cesium.Color.fromCssColorString("#78f1fa"),
+      // 线扫描颜色
       distance: 0,
+      // 扫描距离
       times: 0,
       // 扫描运动次数
       whetherToAndFrom: 0,
+      // 是否往返扫描
+
       ringMoveMode: 0,
+      // 环形扫描移动模式
       ringColor: window.Cesium.Color.fromCssColorString("#78f1fa"),
+      // 环形扫描颜色
       radius: 2000,
+      // 环形扫描半径
       ringScanType: 0,
+      // 环形扫描类型
       image: _constImage.ROUNDNESS_IMG,
+      // 环形扫描纹理
       blendEnable: false,
+      // 是否启用混合
       textureStyle: 1,
+      // 纹理样式
       lineScans: [],
-      ringScans: []
+      // 已添加的线扫描集合
+      ringScans: [] // 已添加的环形扫描集合
     };
     this._drawManager = null;
     // 绘制对象
     this._lineScan = null;
+    // 当前线扫描实例
     this._ringScan = null;
+    // 当前环形扫描实例
     this._language = null;
     this._viewer = scenceView._viewer;
     this._options.viewer = this._viewer;
@@ -142,15 +173,20 @@ class ScanEffectViewModel {
       period: option.cycleStyle,
       distance: option.lengthStyle
     });
-    this._viewer.scene.globe.depthTestAgainstTerrain = true;
+    this._viewer.scene.globe.depthTestAgainstTerrain = true; // 启用地形深度测试
     this._drawManager = scenceView._drawManager;
     const {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     this._language = locale;
   }
+  /**
+   * @description 根据扫描模式添加扫描线（线扫描或环形扫描）
+   * @param {Object} cartesian 笛卡尔坐标点，作为扫描起点
+   */
   addScaningLine(cartesian) {
     if (this._options.scanMode == 0) {
+      // 线扫描模式：构造线扫描参数
       var params = {
         viewer: this._viewer,
         color: this._options.lineColor,
@@ -173,6 +209,7 @@ class ScanEffectViewModel {
       this._viewer.effects.add(this._lineScan); // 添加条形扫描线
       this._options.lineScans.push(this._lineScan);
     } else if (this._options.scanMode == 1) {
+      // 环形扫描模式：将笛卡尔坐标转为经纬度后添加环形扫描线
       var cPosition = window.Cesium.Cartographic.fromCartesian(cartesian);
       var position1 = window.Cesium.Math.toDegrees(cPosition.longitude);
       var position2 = window.Cesium.Math.toDegrees(cPosition.latitude);
@@ -181,7 +218,11 @@ class ScanEffectViewModel {
       this._options.ringScans.push(this._ringScan);
     }
   }
-  //添加环型扫描线
+  /**
+   * @description 添加环型扫描线，根据扫描类型创建雷达扫描或圆形缩放扫描
+   * @param {Array} position 扫描中心点经纬度数组 [经度, 纬度, 高度]
+   * @returns {Object} 环形扫描线实例
+   */
   addRingScanLine(position) {
     var options = {
       viewer: this._viewer,
@@ -193,23 +234,29 @@ class ScanEffectViewModel {
       position: position || this._options.position
     };
     if (this._options.ringScanType == 2) {
+      // 雷达扫描类型
       return new RadarScanLine(options);
     } else {
+      // 圆形缩放扫描类型
       return new CircleZoomScanLine(options);
     }
+    /**
+     * 雷达扫描线构造函数
+     * @param {Object} options 扫描线配置参数
+     */
     function RadarScanLine(options) {
       options = options || {};
-      this.position = options.position;
-      this.radius = options.radius;
-      this.moveMode = window.Cesium.defined(options.moveMode) ? options.moveMode : 1;
-      this.fillStyle = window.Cesium.defined(options.fillStyle) ? options.fillStyle : 0;
-      this.image = options.image;
-      this.color = options.color;
-      this.show = window.Cesium.defined(options.show) ? options.show : true;
-      this.customDataSource = new window.Cesium.CustomDataSource("CircleRotateScan");
-      this.viewer = options.viewer;
+      this.position = options.position; // 扫描中心点
+      this.radius = options.radius; // 扫描半径
+      this.moveMode = window.Cesium.defined(options.moveMode) ? options.moveMode : 1; // 移动模式
+      this.fillStyle = window.Cesium.defined(options.fillStyle) ? options.fillStyle : 0; // 填充样式
+      this.image = options.image; // 纹理图片
+      this.color = options.color; // 颜色
+      this.show = window.Cesium.defined(options.show) ? options.show : true; // 是否显示
+      this.customDataSource = new window.Cesium.CustomDataSource("CircleRotateScan"); // 自定义数据源
+      this.viewer = options.viewer; // Cesium 视图
       var that = this;
-      var ratio = 1;
+      var ratio = 1; // 旋转方向系数
       var scanline = that.customDataSource.entities.add({
         position: window.Cesium.Cartesian3.fromDegrees(that.position[0], that.position[1], that.position[2]),
         name: "CircleRotateScan",
@@ -245,12 +292,14 @@ class ScanEffectViewModel {
           }),
           stRotation: new window.Cesium.CallbackProperty(function () {
             if (that.moveMode == 0) {
+              // 单一方向：始终正向
               ratio = 1;
             }
             if (!window.Cesium.defined(scanline.ellipse._stRotation2)) {
               scanline.ellipse._stRotation2 = 0;
             }
             if (scanline.ellipse._stRotation2 < 0) {
+              // 负角度处理
               if (that.moveMode == 1) {
                 ratio = 1;
               } else {
@@ -258,6 +307,7 @@ class ScanEffectViewModel {
               }
             }
             if (scanline.ellipse._stRotation2 > 2 * Math.PI) {
+              // 超过一圈处理
               if (that.moveMode == 1) {
                 ratio = -1;
               } else {
@@ -277,18 +327,22 @@ class ScanEffectViewModel {
         this.viewer.dataSources.remove(this.customDataSource, true);
       };
     }
+    /**
+     * 圆形缩放扫描线构造函数
+     * @param {Object} options 扫描线配置参数
+     */
     function CircleZoomScanLine(options) {
       options = options || {};
-      this.position = options.position;
-      this.radius = options.radius;
-      this.moveMode = window.Cesium.defined(options.moveMode) ? options.moveMode : 1;
-      this.fillStyle = window.Cesium.defined(options.fillStyle) ? options.fillStyle : 0;
-      this.image = options.image;
-      this.color = options.color;
-      this.show = window.Cesium.defined(options.show) ? options.show : true;
-      this.customDataSource = new window.Cesium.CustomDataSource("CircleRotateScan");
-      this.viewer = options.viewer;
-      var multiS = 1;
+      this.position = options.position; // 扫描中心点
+      this.radius = options.radius; // 扫描半径
+      this.moveMode = window.Cesium.defined(options.moveMode) ? options.moveMode : 1; // 移动模式
+      this.fillStyle = window.Cesium.defined(options.fillStyle) ? options.fillStyle : 0; // 填充样式
+      this.image = options.image; // 纹理图片
+      this.color = options.color; // 颜色
+      this.show = window.Cesium.defined(options.show) ? options.show : true; // 是否显示
+      this.customDataSource = new window.Cesium.CustomDataSource("CircleRotateScan"); // 自定义数据源
+      this.viewer = options.viewer; // Cesium 视图
+      var multiS = 1; // 缩放方向系数
       var that = this;
       var circleFirst3 = that.customDataSource.entities.add({
         position: window.Cesium.Cartesian3.fromDegrees(that.position[0], that.position[1], that.position[2]),
@@ -376,7 +430,11 @@ class ScanEffectViewModel {
       };
     }
   }
-  // 参数切换
+  /**
+   * @description 参数切换，根据 key 更新对应扫描参数并同步到当前扫描实例
+   * @param {String} key 参数键名
+   * @param {*} val 参数值
+   */
   paramsChanged(key, val) {
     switch (key) {
       case "linearScanning":
@@ -455,6 +513,11 @@ class ScanEffectViewModel {
         break;
     }
   }
+  /**
+   * @description 根据填充样式获取对应的纹理图片地址
+   * @param {Number} val 填充样式值（0/1/2）
+   * @returns {String} 纹理图片地址
+   */
   getImageUrl(val) {
     var imageUrl = "";
     switch (val) {
@@ -484,6 +547,7 @@ class ScanEffectViewModel {
       }
     }
     if (flag) {
+      // 场景中存在模型：启动绘制点交互
       if (this._drawManager) {
         this._drawManager.startDraw("point", {
           clampToGround: true,
@@ -500,12 +564,14 @@ class ScanEffectViewModel {
         }, "ScanEffectDraw");
       }
     } else {
+      // 场景中无模型：提示用户先添加模型
       (0, _message.default)({
         message: this._language?.value?.webgl?.["addModelExtractionTips"],
         type: "warning"
       });
     }
   }
+  // 移除当前扫描并清除所有已添加的扫描线
   removeScan() {
     if (this._ringScan) this._ringScan.destroy();
     if (this._lineScan) this._viewer.effects.remove(this._lineScan);
@@ -679,7 +745,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       cycleStyle: props?.settingParams?.cycleStyle ?? 5,
       lengthStyle: props?.settingParams?.lengthStyle ?? 100
     });
-    let viewModel = null;
+    let viewModel = null; // 扫描效果视图模型实例
 
     // 组件容器Ref
     let boxRef = (0, _vue.ref)(null);
@@ -714,7 +780,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, 'webgl.scanningTitle');
       }
     };
-    // 切换参数
+    /**
+     * @description 切换参数，根据 key 调用 viewModel 更新对应配置项
+     * @param {String} key 参数键名
+     */
     function paramsChanged(key) {
       switch (key) {
         case "linearScanning":
@@ -1326,11 +1395,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/sceneadvancedtoimage/index.js

@@ -191,7 +191,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function drawHander() {
       viewModel && viewModel.start();
     }
-    // 参数改变
+    /**
+     * @description 参数改变，调用 viewModel 更新对应配置项
+     * @param {String} key 参数键名
+     */
     function paramsChanged(key) {
       viewModel && viewModel.paramsChanged(key, formItem[key]);
     }
@@ -592,14 +595,23 @@ var _jspdf = _interopRequireDefault(__webpack_require__(65515));
 // 国际化
 
 class SceneAdvancedToImageViewModel {
+  // 国际化语言对象
+  /**
+   * @description 构造函数，初始化场景高级出图视图模型
+   * @param {Object} scenceView 场景视图对象，包含 _viewer 与 _drawManager
+   * @param {Object} options 表单参数对象
+   */
   constructor(scenceView, options) {
     this._viewer = null;
+    // Cesium 视图对象
     this._options = null;
+    // 表单参数对象
     this._canvasToImage = null;
     //场景出图类
     this._drawManager = null;
     //绘制管理对象
     this._satellitePyramidPrimitive = null;
+    // 卫星视椎体图元
     this._language = {};
     const {
       locale
@@ -616,7 +628,10 @@ class SceneAdvancedToImageViewModel {
       canvas: this._viewer.scene.canvas
     });
   }
-  //加载椎体
+  /**
+   * @description 加载卫星视椎体图元
+   * @param {Object} position 椎体顶点的笛卡尔坐标
+   */
   addSatellitePyramidPrimitive(position) {
     // 实例化
     let cartographic = Cesium.Cartographic.fromCartesian(position);
@@ -672,7 +687,11 @@ class SceneAdvancedToImageViewModel {
     }
     return {};
   }
-  // 获取矩阵
+  /**
+   * @description 获取点集的外接矩形范围
+   * @param {Array} points 点集数组，每个元素为 [经度, 纬度]
+   * @returns {Object} 外接矩形 { xmin, ymin, xmax, ymax }
+   */
   getRect(points) {
     let xmin, ymin, xmax, ymax;
     for (let i in points) {
@@ -766,6 +785,7 @@ class SceneAdvancedToImageViewModel {
     newCtx.save();
     newCtx.drawImage(this._viewer.canvas, 0, 0);
     if (this._options.imgFormat === "pdf") {
+      // 输出 PDF：使用 jsPDF 生成并保存
       const pdf = new _jspdf.default({
         orientation: canvas.width >= canvas.height ? "landscape" : "portrait",
         unit: "px",
@@ -782,6 +802,7 @@ class SceneAdvancedToImageViewModel {
         pdf.save(datetimeCode + ".pdf");
       }, 100);
     } else {
+      // 其它格式：直接保存为图片
       this._canvasToImage.saveAsimages(canvas, options);
     }
   }
@@ -803,6 +824,11 @@ class SceneAdvancedToImageViewModel {
       that._drawManager.clearDrawGroup("SceneAdvancedToImageDraw");
     }, "SceneAdvancedToImageDraw");
   }
+  /**
+   * @description 参数改变，更新配置项并同步到当前视椎体图元
+   * @param {String} key 参数键名
+   * @param {*} val 参数值
+   */
   paramsChanged(key, val) {
     if (!this._options) return;
     this._options[key] = val;
@@ -959,11 +985,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;
 
 /***/ })