@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/aspectanalysis/index.js

@@ -61,6 +61,11 @@ var _useGlobalConfig = __webpack_require__(22686);
  **/
 
 class AspectAnalysisViewModel {
+  // 限制绘制面积（平方公里）
+  /** @description 构造函数，初始化坡向分析对象
+   * @param {Object} scenceView 场景视图对象，包含 _viewer、_drawManager 等
+   * @param {Object} aspect 坡向分析参数，包含采样间隔、箭头宽度、箭头颜色等
+   */
   constructor(scenceView, aspect) {
     this._aspectAnalysis = null;
     // 坡向三维对象
@@ -70,7 +75,9 @@ class AspectAnalysisViewModel {
       _drawManager: null
     };
     this._language = {};
+    // 多语言资源对象
     this._scenceView = null;
+    // 场景视图对象
     this._restrictedArea = null;
     const {
       locale
@@ -109,6 +116,7 @@ class AspectAnalysisViewModel {
             if (!shape.groupName || shape.groupName !== "AspectAnalysisDraw") return;
             that._globaOptions._drawManager.clearDrawGroup("AspectAnalysisDraw");
             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)) {
@@ -124,27 +132,35 @@ class AspectAnalysisViewModel {
           }, "AspectAnalysisDraw");
         }
       } else {
+        // 使用了 STK 地形，不支持该分析
         (0, _message.default)({
           message: this._language.value.webgl["stkTerrainAnalysisTips"],
           type: "warning"
         });
       }
     } else {
+      // 未添加地形，无法分析
       (0, _message.default)({
         message: this._language.value.webgl["terrainAnalysisTips"],
         type: "warning"
       });
     }
   }
-  // 设置采样间隔
+  /** @description 设置采样间隔
+   * @param {Number} newValue 采样间隔值
+   */
   setInterval(newValue) {
     if (this._aspectAnalysis) this._aspectAnalysis._interval = newValue;
   }
-  // 设置箭头宽度
+  /** @description 设置箭头宽度
+   * @param {Number} newValue 箭头宽度值
+   */
   setArrowWidth(newValue) {
     if (this._aspectAnalysis) this._aspectAnalysis._width = newValue;
   }
-  // 设置箭头颜色
+  /** @description 设置箭头颜色
+   * @param {String} newValue 箭头颜色 CSS 颜色字符串
+   */
   setArrowColor(newValue) {
     if (this._aspectAnalysis) this._aspectAnalysis._color = Cesium.Color.fromCssColorString(newValue);
   }
@@ -318,7 +334,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    // 参数改变
+    /** @description 参数改变处理，根据变更字段同步到视图模型
+     * @param {String} key 变更的参数字段名
+     */
     function paramsChanged(key) {
       switch (key) {
         case "interval":
@@ -585,11 +603,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/baseterraingallery/index.js

@@ -379,6 +379,9 @@ exports["default"] = void 0;
 //在线地形逻辑类
 class BaseterrainGalleryViewModel {
   //基本地形对象
+  /** @description 构造函数，初始化地形对象
+   * @param {Object} viewer Cesium 场景视图实例
+   */
   constructor(viewer) {
     this._baseterrainGallery = {};
     this._baseterrainGallery.viewer = viewer;
@@ -386,6 +389,9 @@ class BaseterrainGalleryViewModel {
     this._baseterrainGallery.viewer.scene.postProcessStages.fxaa.enabled = false;
     //this.terrainTDT();
   }
+  /** @description 根据索引设置地形类型
+   * @param {Number} inx 地形索引（0 天地图、1 Cesium 全球地形、2 无地形）
+   */
   setTerrainType(inx) {
     if (inx === 0) {
       this._baseterrainGallery.viewer.terrainProvider = this._baseterrainGallery.terrainTDT;
@@ -583,6 +589,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.onlineTerrain");
       }
     };
+
+    // 根据当前选中索引更新当前地形显示文本（无参数）
     function changSelectTerrain() {
       switch (currentIndex.value) {
         case 0:
@@ -596,7 +604,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
-    //地形选择事件
+    /** @description 地形选择事件，切换地形类型
+     * @param {Number} inx 地形索引（0 天地图、1 Cesium 全球地形、2 无地形）
+     */
     function clickHandler(inx) {
       currentIndex.value = inx;
       changSelectTerrain();
@@ -606,6 +616,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function clearResult() {
       viewModel && viewModel.clear();
     }
+
+    // 获取当前选中的地形索引（无参数）
     function getSelectIndex() {
       return currentIndex.value;
     }
@@ -714,11 +726,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/boxclip/index.js

@@ -683,6 +683,10 @@ 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对象
@@ -703,7 +707,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    // 参数改变
+    /** @description 参数改变处理，根据变更字段同步到视图模型
+     * @param {String} key 变更的参数字段名
+     */
     function paramsChanged(key) {
       switch (key) {
         case "tileset":
@@ -1838,6 +1844,12 @@ var _useGlobalConfig = __webpack_require__(22686);
 //Box裁剪逻辑类
 
 class BoxClipViewModel {
+  // 图层列表刷新回调
+  /** @description 构造函数，初始化裁剪视图模型并绑定图层变化监听
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} options 用户传入的裁剪参数
+   * @param {Function} callbackParams 图层列表刷新回调
+   */
   constructor(scenceView, options, callbackParams) {
     this._viewer = null;
     //三维viewer对象
@@ -1868,6 +1880,7 @@ class BoxClipViewModel {
     this._drawManager = null;
     //绘制管理对象
     this._language = {};
+    // 多语言资源对象
     this.callbackParams = null;
     const {
       locale
@@ -1885,6 +1898,9 @@ class BoxClipViewModel {
     // 添加图层数据源变化监听
     _gisUtils.mapViewUtils.bindViewEvents("resetLayerDatas", this._resetListData, scenceView._viewerId);
   }
+  /** @description 图层数据源变化回调，刷新图层列表
+   * @param {Object} e 事件参数对象
+   */
   _resetListData(e) {
     // 如果图层变化事件是自己触发的 则不继续执行 避免死循环
     if (e.eventTarget && e.eventTarget === this) {
@@ -1908,7 +1924,10 @@ class BoxClipViewModel {
     return tilesets;
   }
 
-  //根据id获取tileset对象
+  /** @description 根据id获取tileset对象
+   * @param {String} id tileset 的 guid
+   * @returns {Object} 匹配到的 tileset 对象
+   */
   findLayerById(id) {
     const primitives = this._options.viewer.scene.primitives._primitives;
     const tileset = primitives.find(function (item) {
@@ -1928,6 +1947,7 @@ class BoxClipViewModel {
         flag = true;
       }
     }
+    // 已添加模型时启动绘制，否则提示
     if (flag) {
       this.clear();
       if (this._drawManager) {
@@ -1972,18 +1992,24 @@ class BoxClipViewModel {
     _gisUtils.mapViewUtils.offViewEvents("resetLayerDatas", this._resetListData, this._viewer._container.id);
   }
 
-  // 设置裁剪对象
+  /** @description 设置裁剪对象
+   * @param {String} layerId tileset 的 guid
+   */
   setLayer(layerId) {
     this.clear();
     this._options.tileset = this.findLayerById(layerId);
   }
 
-  // 设置裁剪方式,为true时，则为外部裁剪，否则为内部裁剪
+  /** @description 设置裁剪方式,为true时，则为外部裁剪，否则为内部裁剪
+   * @param {Boolean} val 是否为外部裁剪
+   */
   setClipType(val) {
     this._options.unionClippingRegions = val;
     if (this._boxclipAnalysis) this._boxclipAnalysis.unionClippingRegions = val;
   }
-  //是否裁剪
+  /** @description 是否裁剪
+   * @param {Boolean} val 是否开启裁剪
+   */
   setClip(val) {
     this._options.enable = val;
     if (this._boxclipAnalysis) {
@@ -1991,42 +2017,58 @@ class BoxClipViewModel {
       this._boxclipAnalysis.boxEnable = this._options.boxEnable;
     }
   }
-  //显/隐辅助对象
+  /** @description 显/隐辅助对象
+   * @param {Boolean} val 是否显示辅助盒
+   */
   setShowBox(val) {
     this._options.boxEnable = val;
     if (this._boxclipAnalysis) this._boxclipAnalysis.boxEnable = val;
   }
-  // X方向上移动
+  /** @description X方向上移动
+   * @param {Number} val X方向位移值
+   */
   setXDistance(val) {
     this._options.x = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.translationClip("x", Number(val));
   }
-  // Y方向上移动
+  /** @description Y方向上移动
+   * @param {Number} val Y方向位移值
+   */
   setYDistance(val) {
     this._options.y = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.translationClip("y", Number(val));
   }
-  // Z方向上移动
+  /** @description Z方向上移动
+   * @param {Number} val Z方向位移值
+   */
   setZDistance(val) {
     this._options.z = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.translationClip("z", Number(val));
   }
-  //设置裁剪体长度
+  /** @description 设置裁剪体长度
+   * @param {Number} val 裁剪体长度
+   */
   setAxisX(val) {
     this._options.axisX = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.axisX = Number(val);
   }
-  //设置裁剪体宽度
+  /** @description 设置裁剪体宽度
+   * @param {Number} val 裁剪体宽度
+   */
   setAxisY(val) {
     this._options.axisY = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.axisY = Number(val);
   }
-  //设置裁剪体高度
+  /** @description 设置裁剪体高度
+   * @param {Number} val 裁剪体高度
+   */
   setAxisZ(val) {
     this._options.axisZ = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.axisZ = Number(val);
   }
-  //设置裁剪体旋转角
+  /** @description 设置裁剪体旋转角
+   * @param {Number} val 裁剪体旋转角度
+   */
   setAngle(val) {
     this._options.angle = Number(val);
     if (this._boxclipAnalysis) this._boxclipAnalysis.angle = Number(val);
@@ -2864,11 +2906,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;
 
 /***/ })