@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/comparemap/index.js

@@ -63,22 +63,6 @@ _Divider.default.install = (Vue, opts) => {
 var _default = exports["default"] = _Divider.default;
 _KqGIS.kq_npm_client_common_vue.KqDivider = _Divider.default;
 
-/***/ }),
-
-/***/ 3736:
-/***/ (function(module, __webpack_exports__, __webpack_require__) {
-
-/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(76314);
-/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__);
-// Imports
-
-var ___CSS_LOADER_EXPORT___ = _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default()(function(i){return i[1]});
-// Module
-___CSS_LOADER_EXPORT___.push([module.id, ".compare-layer-tree-wrap[data-v-5e6278d6]{background-color:var(--kq-bg-color);border-radius:var(--kq-border-radius-base);width:272px;height:350px;padding:16px}.compare-layer-tree-wrap .compare-layer-tree[data-v-5e6278d6]{padding-top:16px;height:calc(100% - 83px);overflow-y:auto}.compare-layer-tree-wrap .compare-layer-tree .tree-node_icon[data-v-5e6278d6]{top:3px}.tree-node_icon[data-v-5e6278d6]{margin-right:6px;position:relative;font-size:16px;height:100%;color:var(--kq-color-primary)}.tree-node_label[data-v-5e6278d6]{display:inline-block;vertical-align:middle;overflow:hidden;text-overflow:ellipsis;font-size:var(--kq-font-size-base);color:var(--kq-text-color-regular)}.kq-tree-node__content[data-v-5e6278d6]{width:100%}", ""]);
-// Exports
-/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
-
-
 /***/ }),
 
 /***/ 14464:
@@ -188,6 +172,11 @@ exports["default"] = void 0;
 class CompareMapViewModel {
   //三维viewer对象
 
+  /**
+   * @description 构造函数，初始化视图对象及分屏线参数
+   * @param {Object} scenceView 三维视图对象
+   * @param {Object} options 配置项（splitLineColor：分屏线颜色，splitLineWidth：分屏线宽度）
+   */
   constructor(scenceView, options = {}) {
     this._scenceView = null;
     // 三维视图对象
@@ -204,7 +193,11 @@ class CompareMapViewModel {
     }
   }
 
-  //切换窗口模式
+  /**
+   * @description 切换窗口模式
+   * @param {Number} mode 窗口模式（1：单屏，2：双屏，4：四屏）
+   * @param {Boolean} selectAll 是否默认全部勾选
+   */
   changeMode(mode, selectAll) {
     let viewMode = Cesium.SplitViewMode.NONE;
     switch (mode) {
@@ -229,14 +222,16 @@ class CompareMapViewModel {
       default:
         break;
     }
+    // 非全选模式：清空各图层在所有视图中的显示状态
     if (!selectAll) {
       // 默认全部不勾选
-      let checkedLayerkeys = this._scenceView._layerManager.getLayerCheckedListKey();
+      const checkedLayerkeys = this._scenceView._layerManager.getLayerCheckedListKey();
       for (let i = 0; i < checkedLayerkeys.length; i++) {
-        let layer = this._scenceView._layerManager.getLayerByGuid(checkedLayerkeys[i]);
-        let type = this._scenceView._layerManager.getLayerTypeByGuid(checkedLayerkeys[i]);
+        const layer = this._scenceView._layerManager.getLayerByGuid(checkedLayerkeys[i]);
+        const type = this._scenceView._layerManager.getLayerTypeByGuid(checkedLayerkeys[i]);
         if (layer) {
           layer.showInViews = [];
+          // 数据源图层需同步清空各实体的视图显示状态
           if (type == 'datasource') {
             layer.entities.values.forEach(entity => {
               entity.showInViews = [];
@@ -251,12 +246,13 @@ class CompareMapViewModel {
   //重置窗口模式
   resetMode() {
     this.changeMode();
-    let checkedLayerkeys = this._scenceView._layerManager.getLayerCheckedListKey();
+    const checkedLayerkeys = this._scenceView._layerManager.getLayerCheckedListKey();
     for (let i = 0; i < checkedLayerkeys.length; i++) {
-      let layer = this._scenceView._layerManager.getLayerByGuid(checkedLayerkeys[i]);
-      let type = this._scenceView._layerManager.getLayerTypeByGuid(checkedLayerkeys[i]);
+      const layer = this._scenceView._layerManager.getLayerByGuid(checkedLayerkeys[i]);
+      const type = this._scenceView._layerManager.getLayerTypeByGuid(checkedLayerkeys[i]);
       if (layer) {
         layer.showInViews = undefined;
+        // 数据源图层需将各实体的视图显示状态恢复为全部视图可见
         if (type == 'datasource') {
           layer.entities.values.forEach(entity => {
             entity.showInViews = [0, 1, 2, 3];
@@ -265,25 +261,36 @@ class CompareMapViewModel {
       }
     }
   }
+
+  /**
+   * @description 设置图层显示状态
+   * @param {Number} index 窗口索引
+   * @param {String} guid 图层唯一标识
+   * @param {Boolean} visible 是否可见
+   */
   setLayerState(index, guid, visible) {
-    let layer = this._scenceView._layerManager.getLayerByGuid(guid);
+    const layer = this._scenceView._layerManager.getLayerByGuid(guid);
     if (layer) {
-      let showInViews = layer.showInViews || (visible ? [] : [0, 1, 2, 3]);
+      const showInViews = layer.showInViews || (visible ? [] : [0, 1, 2, 3]);
+      // 显示图层：将窗口索引加入显示视图列表
       if (visible) {
         if (showInViews.indexOf(index) == -1) {
           showInViews.push(index);
         }
+        // 图层整体不可见时同步打开
         if (!layer.show) {
           this._scenceView._layerManager.setLayerVisibleStateByIds([layer.guid], true);
         }
       } else {
-        let num = showInViews.indexOf(index);
+        // 隐藏图层：从显示视图列表中移除窗口索引
+        const num = showInViews.indexOf(index);
         if (num > -1) {
           showInViews.splice(num, 1);
         }
       }
       layer.showInViews = showInViews;
-      let type = this._scenceView._layerManager.getLayerTypeByGuid(layer.guid);
+      const type = this._scenceView._layerManager.getLayerTypeByGuid(layer.guid);
+      // 数据源图层需同步更新各实体的视图显示状态
       if (type == 'datasource') {
         layer.entities.values.forEach(entity => {
           if (entity.show) {
@@ -292,6 +299,7 @@ class CompareMapViewModel {
         });
       }
     } else if (visible) {
+      // 未找到图层但需要显示：直接调用图层管理器设置可见
       this._scenceView._layerManager.setLayerVisibleStateByIds([guid], true, null, [index]);
     }
   }
@@ -665,8 +673,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
     let headerTempRef = (0, _vue.ref)();
-    let layerTreeRef = (0, _vue.ref)(null);
-    let filterTreeTxt = (0, _vue.ref)('');
+    let layerTreeRef = (0, _vue.ref)(null); // 图层树组件引用
+    let filterTreeTxt = (0, _vue.ref)(''); // 图层过滤关键字
 
     // 图层树过滤
     (0, _vue.watch)(filterTreeTxt, val => {
@@ -674,14 +682,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         layerTreeRef.value.$refs.child.filter(val);
       }
     });
-    let treeData = (0, _vue.ref)([]);
-    let checkedKeysData = (0, _vue.ref)([]);
+    let treeData = (0, _vue.ref)([]); // 图层树数据
+    let checkedKeysData = (0, _vue.ref)([]); // 默认勾选的图层 key 列表
+
+    // 组件挂载后初始化头部及图层树数据
     (0, _vue.onMounted)(() => {
       (0, _vue.nextTick)(() => {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "common.layerListTitle");
         _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
           if (scenceView) {
             treeData.value = scenceView._layerManager._layerTreeData;
+            // 根据是否默认全选初始化勾选项
             if (props.defaultSelectAll) {
               checkedKeysData.value = scenceView._layerManager.getLayerCheckedListKey();
             } else {
@@ -691,17 +702,32 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         });
       });
     });
+
+    /**
+     * @description 图层树节点过滤方法
+     * @param {String} value 过滤关键字
+     * @param {Object} data 节点数据
+     * @returns {Boolean} 是否匹配
+     */
     const filterNode = (value, data) => {
       if (!value) return true;
       return data.name.includes(value);
     };
 
-    // 点击图层check框
+    /**
+     * @description 点击图层check框
+     * @param {Object} data 节点数据
+     * @param {Boolean} checked 是否勾选
+     */
     const handleCheck = (data, checked) => {
       props.setLayerState(props.index, data.guid, checked);
     };
 
-    // 图层树图层icon类型判断
+    /**
+     * @description 图层树图层icon类型判断
+     * @param {Object} data 图层数据
+     * @returns {Object} 图标组件
+     */
     const getIconType = data => {
       // 海图
       if (data.layerType === 10) {
@@ -760,6 +786,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         return (0, _vue.markRaw)(_client_icons_vue.IconRasterTile);
       }
     };
+
+    /**
+     * @description 设置图层树勾选项
+     * @param {Array} data 勾选图层 guid 列表
+     */
     function setCheckedData(data) {
       if (layerTreeRef.value) {
         layerTreeRef.value.$refs.child.setCheckedKeys(data);
@@ -878,7 +909,7 @@ var _default = exports.A = {
 
 /***/ }),
 
-/***/ 45485:
+/***/ 49600:
 /***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 // ESM COMPAT FLAG
@@ -897,9 +928,9 @@ var CompareMapLayerTreevue_type_script_setup_true_lang_js = __webpack_require__(
 // EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
 var injectStylesIntoStyleTag = __webpack_require__(85072);
 var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
-// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/sass-loader/dist/cjs.js??clonedRuleSet-3.use[2]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=5e6278d6&lang=scss&scoped=true
-var CompareMapLayerTreevue_type_style_index_0_id_5e6278d6_lang_scss_scoped_true = __webpack_require__(3736);
-;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/sass-loader/dist/cjs.js??clonedRuleSet-3.use[2]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=5e6278d6&lang=scss&scoped=true
+// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/sass-loader/dist/cjs.js??clonedRuleSet-3.use[2]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=4465cd75&lang=scss&scoped=true
+var CompareMapLayerTreevue_type_style_index_0_id_4465cd75_lang_scss_scoped_true = __webpack_require__(86175);
+;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/sass-loader/dist/cjs.js??clonedRuleSet-3.use[2]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=4465cd75&lang=scss&scoped=true
 
             
 
@@ -908,12 +939,12 @@ var options = {};
 options.insert = "head";
 options.singleton = false;
 
-var update = injectStylesIntoStyleTag_default()(CompareMapLayerTreevue_type_style_index_0_id_5e6278d6_lang_scss_scoped_true/* default */.A, options);
+var update = injectStylesIntoStyleTag_default()(CompareMapLayerTreevue_type_style_index_0_id_4465cd75_lang_scss_scoped_true/* default */.A, options);
 
 
 
-/* harmony default export */ var comparemap_CompareMapLayerTreevue_type_style_index_0_id_5e6278d6_lang_scss_scoped_true = (CompareMapLayerTreevue_type_style_index_0_id_5e6278d6_lang_scss_scoped_true/* default */.A.locals || {});
-;// ./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=5e6278d6&lang=scss&scoped=true
+/* harmony default export */ var comparemap_CompareMapLayerTreevue_type_style_index_0_id_4465cd75_lang_scss_scoped_true = (CompareMapLayerTreevue_type_style_index_0_id_4465cd75_lang_scss_scoped_true/* default */.A.locals || {});
+;// ./src/webgl/comparemap/CompareMapLayerTree.vue?vue&type=style&index=0&id=4465cd75&lang=scss&scoped=true
 
 // EXTERNAL MODULE: ./node_modules/vue-loader/dist/exportHelper.js
 var exportHelper = __webpack_require__(66262);
@@ -924,7 +955,7 @@ var exportHelper = __webpack_require__(66262);
 ;
 
 
-const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(CompareMapLayerTreevue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-5e6278d6"]])
+const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(CompareMapLayerTreevue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-4465cd75"]])
 
 /* harmony default export */ var CompareMapLayerTree = (__exports__);
 
@@ -1360,10 +1391,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     let preCheckedKeys = (0, _vue.ref)([]); // 记录上次图层树选中值
 
     /**
-     * 勾选图层逻辑
+     * @description 勾选图层逻辑，对比新旧选中值触发图层显示状态变更
+     * @param {Array} values 当前选中值列表
      */
     function changeLayer(values) {
       let checkedKeys = preCheckedKeys.value;
+      // 取消勾选：新值数量少于旧值，找出被取消的图层
       if (checkedKeys.length > values.length) {
         for (let val of checkedKeys.values()) {
           if (!values.includes(val)) {
@@ -1371,6 +1404,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           }
         }
       } else {
+        // 新增勾选：新值数量多于旧值，找出新增的图层
         for (let val of values.values()) {
           if (!checkedKeys.includes(val)) {
             props.setLayerState(props.index, val, true);
@@ -1379,11 +1413,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       preCheckedKeys.value = values;
     }
+
+    // 组件挂载后加载图层列表并初始化选中状态
     (0, _vue.onMounted)(() => {
       (0, _vue.nextTick)(() => {
         _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
           if (scenceView) {
             layerTreeData.value = _gisUtils.mapLayerUtils.getLayerCheckedList();
+            // 默认全选时同步初始勾选状态
             if (props.defaultSelectAll) {
               selectedLayers.value = _gisUtils.mapLayerUtils.getLayerCheckedListKey();
               preCheckedKeys.value = selectedLayers.value;
@@ -1952,6 +1989,22 @@ module.exports = function (list, options) {
   };
 };
 
+/***/ }),
+
+/***/ 86175:
+/***/ (function(module, __webpack_exports__, __webpack_require__) {
+
+/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(76314);
+/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__);
+// Imports
+
+var ___CSS_LOADER_EXPORT___ = _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default()(function(i){return i[1]});
+// Module
+___CSS_LOADER_EXPORT___.push([module.id, ".compare-layer-tree-wrap[data-v-4465cd75]{background-color:var(--kq-bg-color);border-radius:var(--kq-border-radius-base);width:272px;height:350px;padding:16px}.compare-layer-tree-wrap .compare-layer-tree[data-v-4465cd75]{padding-top:16px;height:calc(100% - 83px);overflow-y:auto}.compare-layer-tree-wrap .compare-layer-tree .tree-node_icon[data-v-4465cd75]{top:3px}.tree-node_icon[data-v-4465cd75]{margin-right:6px;position:relative;font-size:16px;height:100%;color:var(--kq-color-primary)}.tree-node_label[data-v-4465cd75]{display:inline-block;vertical-align:middle;overflow:hidden;text-overflow:ellipsis;font-size:var(--kq-font-size-base);color:var(--kq-text-color-regular)}.kq-tree-node__content[data-v-4465cd75]{width:100%}", ""]);
+// Exports
+/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
+
+
 /***/ }),
 
 /***/ 88897:
@@ -2067,13 +2120,15 @@ var _gisUtils = __webpack_require__(20064);
 var _client_icons_vue = __webpack_require__(65698);
 var _CompareMapViewModel = _interopRequireDefault(__webpack_require__(21508));
 var _CompareMapTree = _interopRequireDefault(__webpack_require__(240));
-var _CompareMapLayerTree = _interopRequireDefault(__webpack_require__(45485));
+var _CompareMapLayerTree = _interopRequireDefault(__webpack_require__(49600));
 var _useGlobalConfig = __webpack_require__(22686);
 var _button = _interopRequireDefault(__webpack_require__(68676));
 var _icon = _interopRequireDefault(__webpack_require__(80881));
 const _hoisted_1 = {
   class: "kq3d-compare-map"
 };
+// 组件 props 定义
+
 const __default__ = {
   name: "Kq3dCompareMap"
 };
@@ -2119,26 +2174,29 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     const props = __props;
-    let offsetTop = (0, _vue.ref)("auto");
+    let offsetTop = (0, _vue.ref)("auto"); // 顶部偏移量
     let btnShow = (0, _vue.ref)(false); // 分屏返回按钮
-    let emit = __emit;
-    let viewModel = null;
+    let emit = __emit; // 自定义事件：返回
+    let viewModel = null; // 多窗口逻辑类实例
     let showTree1 = (0, _vue.ref)(false); // 图层树1
     let showTree2 = (0, _vue.ref)(false); // 图层树2
     let showTree3 = (0, _vue.ref)(false); // 图层树3
     let showTree4 = (0, _vue.ref)(false); // 图层树4
-    let tree1Index = (0, _vue.ref)(0);
-    let tree2Index = (0, _vue.ref)(1);
-    let tree3Index = (0, _vue.ref)(2);
-    let tree4Index = (0, _vue.ref)(3);
-    let layerTreeRef1 = (0, _vue.ref)(null);
-    let layerTreeRef2 = (0, _vue.ref)(null);
-    let layerTreeRef3 = (0, _vue.ref)(null);
-    let layerTreeRef4 = (0, _vue.ref)(null);
+    let tree1Index = (0, _vue.ref)(0); // 图层树1的窗口索引
+    let tree2Index = (0, _vue.ref)(1); // 图层树2的窗口索引
+    let tree3Index = (0, _vue.ref)(2); // 图层树3的窗口索引
+    let tree4Index = (0, _vue.ref)(3); // 图层树4的窗口索引
+    let layerTreeRef1 = (0, _vue.ref)(null); // 图层树1组件引用
+    let layerTreeRef2 = (0, _vue.ref)(null); // 图层树2组件引用
+    let layerTreeRef3 = (0, _vue.ref)(null); // 图层树3组件引用
+    let layerTreeRef4 = (0, _vue.ref)(null); // 图层树4组件引用
+
+    // 组件挂载后初始化视图模型
     (0, _vue.onMounted)(() => {
       offsetTop.value = props.offsetTop;
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
+          // 组装分屏线参数
           let options = {
             splitLineColor: props.splitLineColor,
             splitLineWidth: props.splitLineWidth
@@ -2148,9 +2206,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       });
     });
 
-    //切换窗口模式
+    /**
+     * @description 切换窗口模式（2分屏或4分屏）
+     * @param {Number} mode 窗口模式（1：单屏，2：双屏，4：四屏）
+     */
     function changeMode(mode) {
       btnShow.value = true;
+      // 双屏模式：显示前两个图层树
       if (mode === 2) {
         showTree1.value = true;
         showTree2.value = true;
@@ -2159,6 +2221,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         tree3Index.value = 2;
         tree4Index.value = 3;
       } else if (mode === 4) {
+        // 四屏模式：显示全部四个图层树，并重排索引
         showTree1.value = true;
         showTree2.value = true;
         showTree3.value = true;
@@ -2187,12 +2250,21 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       viewModel && viewModel.resetMode();
     }
 
-    //设置图层显示状态
+    /**
+     * @description 设置图层显示状态
+     * @param {Number} index 窗口索引
+     * @param {String} guid 图层唯一标识
+     * @param {Boolean} visible 是否可见
+     */
     function setLayerState(index, guid, visible) {
       viewModel && viewModel.setLayerState(index, guid, visible);
     }
 
-    // 设置图层树勾选图层
+    /**
+     * @description 设置图层树勾选图层
+     * @param {Number} index 窗口索引
+     * @param {Array} guidList 勾选图层 guid 列表
+     */
     function setLayerTreeChecked(index, guidList) {
       let mapLayerTree = null;
       switch (index) {
@@ -2388,11 +2460,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/compass/index.js

@@ -28,6 +28,9 @@ exports["default"] = void 0;
 // 重置视图
 class CompassViewModel {
   //三维viewer对象
+  /** @description 构造函数，初始化指南针视图模型
+   * @param {Object} viewer Cesium 场景视图实例
+   */
   constructor(viewer) {
     this._viewer = null;
     this._viewer = viewer;
@@ -37,12 +40,14 @@ class CompassViewModel {
     var camera = this._viewer.camera;
     var scene = this._viewer.scene;
     var depthTestAgainstTerrain = scene.globe.depthTestAgainstTerrain;
+    // 临时开启深度检测以正确拾取中心点
     if (!depthTestAgainstTerrain) {
       scene.globe.depthTestAgainstTerrain = true;
     }
     var canvas = scene.canvas;
     var windowCenter = new Cesium.Cartesian2(canvas.clientWidth / 2, canvas.clientHeight / 2);
     setTimeout(() => {
+      // 优先通过场景拾取中心点，失败时退回椭球拾取
       var center = scene.pickPosition(windowCenter);
       if (!center) {
         center = scene.camera.pickEllipsoid(windowCenter, scene.globe.ellipsoid);
@@ -56,6 +61,9 @@ class CompassViewModel {
       camera.lookAtTransform(Cesium.Matrix4.IDENTITY);
     }, 300);
   }
+  /** @description 绑定指南针事件，相机变化时同步偏航角到外部 ref
+   * @param {Object} heading 外部传入的响应式 ref，用于接收相机偏航角
+   */
   //绑定指南针
   bindCompassEvent(heading) {
     var camera = this._viewer.camera;
@@ -119,8 +127,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   },
   setup(__props) {
     const props = __props;
-    let viewModel = null;
-    let heading = (0, _vue.ref)(0);
+    let viewModel = null; // 视图模型实例
+    let heading = (0, _vue.ref)(0); // 当前相机偏航角（弧度）
     // 国际化
     const {
       locale
@@ -134,7 +142,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       });
     });
-    // 按钮点击事件
+    /** @description 按钮点击事件，重置相机方向
+     * @param {Object} e 鼠标事件对象
+     */
     function btnClick(e) {
       viewModel && viewModel.resetOrientation();
     }
@@ -485,11 +495,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;
 
 /***/ })