@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/sceneset/index.js

@@ -12,7 +12,51 @@ return /******/ (function() { // webpackBootstrap
 /******/ 	"use strict";
 /******/ 	var __webpack_modules__ = ({
 
-/***/ 12322:
+/***/ 20064:
+/***/ (function(module) {
+
+module.exports = __WEBPACK_EXTERNAL_MODULE__20064__;
+
+/***/ }),
+
+/***/ 20455:
+/***/ (function(module) {
+
+module.exports = __WEBPACK_EXTERNAL_MODULE__20455__;
+
+/***/ }),
+
+/***/ 21250:
+/***/ (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, ".cesium-performanceDisplay-defaultContainer{top:unset !important;bottom:16px;right:64px !important}", ""]);
+// Exports
+/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
+
+
+/***/ }),
+
+/***/ 22686:
+/***/ (function(module) {
+
+module.exports = __WEBPACK_EXTERNAL_MODULE__22686__;
+
+/***/ }),
+
+/***/ 33751:
+/***/ (function(module) {
+
+module.exports = require("@babel/runtime/helpers/interopRequireDefault");
+
+/***/ }),
+
+/***/ 40544:
 /***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 // ESM COMPAT FLAG
@@ -31,9 +75,9 @@ var SceneSetvue_type_script_setup_true_lang_js = __webpack_require__(68591);
 // 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/sceneset/SceneSet.vue?vue&type=style&index=0&id=06939beb&lang=scss
-var SceneSetvue_type_style_index_0_id_06939beb_lang_scss = __webpack_require__(27663);
-;// ./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/sceneset/SceneSet.vue?vue&type=style&index=0&id=06939beb&lang=scss
+// 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/sceneset/SceneSet.vue?vue&type=style&index=0&id=ce9e18ee&lang=scss
+var SceneSetvue_type_style_index_0_id_ce9e18ee_lang_scss = __webpack_require__(21250);
+;// ./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/sceneset/SceneSet.vue?vue&type=style&index=0&id=ce9e18ee&lang=scss
 
             
 
@@ -42,12 +86,12 @@ var options = {};
 options.insert = "head";
 options.singleton = false;
 
-var update = injectStylesIntoStyleTag_default()(SceneSetvue_type_style_index_0_id_06939beb_lang_scss/* default */.A, options);
+var update = injectStylesIntoStyleTag_default()(SceneSetvue_type_style_index_0_id_ce9e18ee_lang_scss/* default */.A, options);
 
 
 
-/* harmony default export */ var sceneset_SceneSetvue_type_style_index_0_id_06939beb_lang_scss = (SceneSetvue_type_style_index_0_id_06939beb_lang_scss/* default */.A.locals || {});
-;// ./src/webgl/sceneset/SceneSet.vue?vue&type=style&index=0&id=06939beb&lang=scss
+/* harmony default export */ var sceneset_SceneSetvue_type_style_index_0_id_ce9e18ee_lang_scss = (SceneSetvue_type_style_index_0_id_ce9e18ee_lang_scss/* default */.A.locals || {});
+;// ./src/webgl/sceneset/SceneSet.vue?vue&type=style&index=0&id=ce9e18ee&lang=scss
 
 ;// ./src/webgl/sceneset/SceneSet.vue
 
@@ -61,50 +105,6 @@ const __exports__ = SceneSetvue_type_script_setup_true_lang_js/* default */.A;
 
 /***/ }),
 
-/***/ 20064:
-/***/ (function(module) {
-
-module.exports = __WEBPACK_EXTERNAL_MODULE__20064__;
-
-/***/ }),
-
-/***/ 20455:
-/***/ (function(module) {
-
-module.exports = __WEBPACK_EXTERNAL_MODULE__20455__;
-
-/***/ }),
-
-/***/ 22686:
-/***/ (function(module) {
-
-module.exports = __WEBPACK_EXTERNAL_MODULE__22686__;
-
-/***/ }),
-
-/***/ 27663:
-/***/ (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, ".cesium-performanceDisplay-defaultContainer{top:unset !important;bottom:16px;right:64px !important}", ""]);
-// Exports
-/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
-
-
-/***/ }),
-
-/***/ 33751:
-/***/ (function(module) {
-
-module.exports = require("@babel/runtime/helpers/interopRequireDefault");
-
-/***/ }),
-
 /***/ 42975:
 /***/ (function(module) {
 
@@ -131,8 +131,14 @@ var _skyboxImage = __webpack_require__(98110);
  * 场景设置逻辑类
  **/
 class SceneSetViewModel {
+  // 相机变化事件解绑函数
+  /**
+   * @description 构造函数，初始化场景设置视图模型
+   * @param {Object} viewer Cesium 视图对象
+   */
   constructor(viewer) {
     this._viewer = null;
+    // Cesium 视图对象
     this._constellation = null;
     //星座
     this._skyStar = null;
@@ -158,13 +164,19 @@ class SceneSetViewModel {
     this._blueskyBox = null;
     // 蓝天
     this._oldTerrain = null;
+    // 原始地形提供者（用于海洋效果恢复）
     this._waterLayer = null;
+    // 水层图层（海洋效果）
     this._removeChangedEvent = null;
     this._viewer = viewer;
     this._defaultSkyBox = viewer.scene.skyBox;
     this._undergroundManager = new Cesium.Kq3dUndergroundManager(this._viewer.scene);
   }
-  // 获取场景内容
+  /**
+   * @description 获取场景内容项的开启状态
+   * @param {String} key 场景内容项键名（earth/sun/moon/star 等）
+   * @returns {Boolean} 是否开启
+   */
   getSceneContent(key) {
     let open = false;
     switch (key) {
@@ -209,7 +221,11 @@ class SceneSetViewModel {
     }
     return open;
   }
-  // 设置场景内容
+  /**
+   * @description 设置场景内容项的开启状态
+   * @param {String} key 场景内容项键名
+   * @param {Boolean} isOpen 是否开启
+   */
   setSceneContent(key, isOpen) {
     switch (key) {
       case "earth":
@@ -287,7 +303,10 @@ class SceneSetViewModel {
         break;
     }
   }
-  // 设置天空盒样式
+  /**
+   * @description 设置天空盒样式
+   * @param {String} style 天空盒样式键名（default/style1/style2/style3）
+   */
   setSkyBoxStyle(style) {
     let sources = null;
     switch (style) {
@@ -336,9 +355,13 @@ class SceneSetViewModel {
     }
     if (sources) this._defaultSkyBox.sources = sources;
   }
-  // 打开或关闭近地天空盒
+  /**
+   * @description 打开或关闭近地天空盒
+   * @param {Boolean} isOpen 是否开启近地天空盒
+   */
   openNearSkyBoxStyle(isOpen) {
     if (isOpen) {
+      // 开启：按需创建晴天/晚霞/蓝天三种近地天空盒并绑定相机变化事件
       if (!this._sunshineBox) {
         this._sunshineBox = new Cesium.Kq3dLocalViewSkyBox({
           sources: {
@@ -376,18 +399,22 @@ class SceneSetViewModel {
         });
       }
       this.updateNearSkyBox();
-      let that = this;
+      const that = this;
       this._removeChangedEvent = this._viewer.camera.changed.addEventListener(function () {
         that.updateNearSkyBox();
       });
     } else {
+      // 关闭：恢复默认天空盒并解绑相机变化事件
       this._viewer.scene.skyBox = this._defaultSkyBox;
       this._viewer.scene.skyAtmosphere.show = true;
       this._removeChangedEvent && this._removeChangedEvent();
       this._removeChangedEvent = null;
     }
   }
-  // 设置近地天空盒样式
+  /**
+   * @description 设置近地天空盒样式
+   * @param {String} style 近地天空盒样式键名（sunny/sunset/blueSky）
+   */
   setNearSkyBoxStyle(style) {
     switch (style) {
       case "sunny":
@@ -423,7 +450,10 @@ class SceneSetViewModel {
       }
     }
   }
-  // 打开或关闭颜色校正
+  /**
+   * @description 打开或关闭颜色校正
+   * @param {Boolean} isOpen 是否开启颜色校正
+   */
   openColorCorrection(isOpen) {
     if (!this._colorCorrection) {
       this._colorCorrection = new Cesium.Kq3dColorCorrection({
@@ -437,13 +467,20 @@ class SceneSetViewModel {
     }
     this._colorCorrection.enabled = isOpen;
   }
-  // 设置颜色校正参数
+  /**
+   * @description 设置颜色校正参数
+   * @param {String} key 参数键名（brightness/contrast/hue/saturation）
+   * @param {*} val 参数值
+   */
   setColorCorrection(key, val) {
     if (this._colorCorrection) {
       this._colorCorrection[key] = Number(val);
     }
   }
-  // 打开或关闭泛光
+  /**
+   * @description 打开或关闭泛光
+   * @param {Boolean} isOpen 是否开启泛光
+   */
   openFloodlight(isOpen) {
     if (!this._brightness) {
       this._brightness = new Cesium.Kq3dBrightness({
@@ -453,13 +490,20 @@ class SceneSetViewModel {
     }
     this._brightness.enabled = isOpen;
   }
-  // 设置泛光参数
+  /**
+   * @description 设置泛光参数
+   * @param {String} key 参数键名
+   * @param {*} val 参数值
+   */
   setFloodlight(key, val) {
     if (this._brightness) {
       this._brightness[key] = Number(val);
     }
   }
-  // 设置视图模式
+  /**
+   * @description 设置视图模式
+   * @param {String} mode 视图模式（3d/2d/其它为哥伦布视图）
+   */
   setViewMode(mode) {
     if (this._viewer.scene.mode === Cesium.SceneMode.MORPHING) {
       return; // 如果已经处于变换中，则不进行任何操作
@@ -472,45 +516,65 @@ class SceneSetViewModel {
       this._viewer.scene.mode = Cesium.SceneMode.COLUMBUS_VIEW;
     }
   }
-  // 显示坐标网格
+  /**
+   * @description 显示坐标网格
+   * @param {String} type 网格类型（geographic 地理坐标/mercator 墨卡托）
+   */
   showGrid(type) {
     if (this._gridLayer) {
       this._viewer.imageryLayers.remove(this._gridLayer);
       this._gridLayer = null;
     }
     if (type == "geographic") {
+      // 地理坐标网格
       this._gridLayer = new Cesium.ImageryLayer(new Cesium.TileCoordinatesImageryProvider({
         tilingScheme: new Cesium.GeographicTilingScheme()
       }));
       this._viewer.imageryLayers.add(this._gridLayer);
     } else if (type == "mercator") {
+      // 墨卡托投影网格
       this._gridLayer = new Cesium.ImageryLayer(new Cesium.TileCoordinatesImageryProvider({
         tilingScheme: new Cesium.WebMercatorTilingScheme()
       }));
       this._viewer.imageryLayers.add(this._gridLayer);
     }
   }
-  // 打开或关闭地下模式
+  /**
+   * @description 打开或关闭地下模式
+   * @param {Boolean} isOpen 是否开启地下模式
+   */
   openUnderground(isOpen) {
     this._undergroundManager.undergroundEnabled = isOpen;
     this._undergroundManager.transparentEnabled = isOpen;
   }
-  // 设置地表透明度
+  /**
+   * @description 设置地表透明度
+   * @param {*} val 透明度值
+   */
   setSurfaceTransparency(val) {
     this._undergroundManager.transparent = Number(val);
   }
 
-  // 设置地形夸张系数
+  /**
+   * @description 设置地形夸张系数
+   * @param {*} val 夸张系数值
+   */
   setExaggerationFactor(val) {
     this._viewer.scene.globe.terrainExaggeration = Number(val);
   }
 
-  // 设置地形夸张基准高度
+  /**
+   * @description 设置地形夸张基准高度
+   * @param {*} val 基准高度值
+   */
   setAltitudeHeight(val) {
     this._viewer.scene.globe.terrainExaggerationRelativeHeight = Number(val);
   }
 
-  // 设置模型清晰度
+  /**
+   * @description 设置模型清晰度
+   * @param {*} val 模型分辨率值（maximumScreenSpaceError）
+   */
   setModelResolution(val) {
     this._viewer._modelResolution = val;
     var primitives = this._viewer.scene.primitives._primitives;
@@ -732,12 +796,18 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     };
 
-    // 场景内容设置改变
+    /**
+     * @description 场景内容设置改变，调用 viewModel 设置对应项开关
+     * @param {String} key 场景内容项键名
+     */
     function contentChanged(key) {
       viewModel.setSceneContent(key, formItem[key]);
     }
 
-    // 参数改变
+    /**
+     * @description 参数改变，根据 key 调用 viewModel 更新对应配置项
+     * @param {String} key 参数键名
+     */
     function paramsChanged(key) {
       switch (key) {
         case "skyBoxStyle":
@@ -2214,7 +2284,7 @@ Object.defineProperty(exports, "default", ({
     return _SceneSet.default;
   }
 }));
-var _SceneSet = _interopRequireDefault(__webpack_require__(12322));
+var _SceneSet = _interopRequireDefault(__webpack_require__(40544));
 var _SceneSetViewModel = _interopRequireDefault(__webpack_require__(43826));
 var _init = _interopRequireDefault(__webpack_require__(20455));
 /*

package/scenetohdimage/index.js

@@ -190,7 +190,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     function toHDImageHander() {
       viewModel && viewModel.sceneToImages();
     }
-    // 参数改变
+    /**
+     * @description 参数改变，调用 viewModel 更新对应配置项
+     * @param {String} key 参数键名
+     */
     function paramsChanged(key) {
       if (!viewModel || !viewModel._options) return;
       viewModel._options[key] = formItem[key];
@@ -213,6 +216,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           break;
       }
     }
+    /**
+     * @description 根据容器尺寸初始化视图模型参数
+     * @param {String} id 视图容器的 DOM id
+     */
     function intViewModelParams(id) {
       var bodyW = 1920,
         bodyH = 1024;
@@ -629,14 +636,23 @@ var _jspdf = _interopRequireDefault(__webpack_require__(65515));
 
 class SceneToHDImageViewModel {
   // 输出图片区域
+  /**
+   * @description 构造函数，初始化场景高清出图视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} options 表单参数对象
+   */
   constructor(scenceView, options) {
     this._viewer = null;
+    // Cesium 视图对象
     this._options = null;
+    // 表单参数对象
     this._canvasToImage = null;
+    // 场景出图类
     this._exportPictureRegion = null;
     this._viewer = scenceView._viewer;
     this._options = options;
-    this._viewer.enabledFXAA = true;
+    this._viewer.enabledFXAA = true; // 启用 FXAA 抗锯齿
+
     this._exportPictureRegion = document.createElement("div");
     this._exportPictureRegion.class = "export-picture-region";
     this._exportPictureRegion.id = "exportPictureRegion";
@@ -671,8 +687,10 @@ class SceneToHDImageViewModel {
     };
     var canvas = null;
     if (width == resolutionWidth && height == resolutionHeight) {
+      // 出图尺寸与分辨率一致：直接使用场景 canvas
       canvas = this._viewer.scene.canvas;
     } else {
+      // 出图尺寸与分辨率不一致：从场景 canvas 裁剪指定区域
       this._viewer.render();
       var startX = (resolutionWidth - width) / 2,
         startY = (resolutionHeight - height) / 2;
@@ -683,7 +701,8 @@ class SceneToHDImageViewModel {
       newCtx.drawImage(this._viewer.canvas, startX, startY, width, height, 0, 0, width, height);
     }
     if (this._options.imgFormat === "pdf") {
-      let base64 = this._canvasToImage.convertToImage(canvas, {
+      // 输出 PDF：使用 jsPDF 生成并保存
+      const base64 = this._canvasToImage.convertToImage(canvas, {
         width: width,
         //图片宽度
         height: height,
@@ -701,6 +720,7 @@ class SceneToHDImageViewModel {
         pdf.save(datetimeCode + ".pdf");
       }, 100);
     } else {
+      // 其它格式：直接保存为图片
       this._canvasToImage.saveAsimages(canvas, options);
     }
   }