@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/modelexcavate/index.js

@@ -81,12 +81,19 @@ var _gisUtils = __webpack_require__(20064);
 //模型开挖逻辑类
 
 class ModelExcavateViewModel {
+  /**
+   * @description 构造函数，初始化viewer、地形参数、平整纹理对象、测量处理器及图层监听
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} options 配置参数对象
+   * @param {Function} callbackParams 回调函数，用于通知外部状态变化
+   */
   constructor(scenceView, options, callbackParams) {
     this._viewer = null;
     //三维viewer对象
     this._options = {};
     //Box裁剪存储参数对象
     this._Kq3dTerrainExcavation = null;
+    //地形开挖扩展对象
     this._removeEventListener = null;
     //绘制完成监听事件
     this._measureHandler = null;
@@ -116,14 +123,18 @@ class ModelExcavateViewModel {
     this._viewer = scenceView._viewer;
     this._options = options;
     this._viewer.scene.globe.depthTestAgainstTerrain = true; //开启深度检测
+    // 地形提供者存在时，对椭球地形请求顶点法线
     if (this._viewer.terrainProvider) {
       if (this._viewer.terrainProvider instanceof Cesium.EllipsoidTerrainProvider) {
         this._viewer.terrainProvider.requestVertexNormals = true;
       }
     }
     var that = this;
+
+    // 创建平整多边形纹理对象
     const kq3dFlattenning = new window.Cesium.Kq3dFlattenning(this._viewer, {});
     this.g_flattenedPolygonTexture = kq3dFlattenning.createFlattenedPolygonTexture();
+    // 实例化测量处理器
     this._measureHandler = new Cesium.Kq3dMeasureHandler(this._viewer, {
       selfIntersectTest: true
     });
@@ -137,10 +148,12 @@ class ModelExcavateViewModel {
         }
       };
     }
+    // 测量完成事件：保存测量结果并隐藏标签
     this._measureHandler.measureEvent.addEventListener(function (result) {
       that._measureResult = result;
       result.measureResult.label.show = false;
     });
+    // 测量激活状态变化事件：测量结束时触发开挖效果创建
     this._measureHandler.activeEvent.addEventListener(function (ret) {
       if (ret == false) {
         if (that._measureResult) {
@@ -193,6 +206,7 @@ class ModelExcavateViewModel {
   }
   createWallPrimitive() {
     if (!this._Kq3dTerrainExcavation) return;
+    // 若已存在墙体图元，先移除
     if (this._wallPrimitive) {
       this._viewer.scene.primitives.remove(this._wallPrimitive);
       this._wallPrimitive = undefined;
@@ -206,12 +220,16 @@ class ModelExcavateViewModel {
     });
     this._viewer.scene.primitives.add(this._wallPrimitive);
     let that = this;
+    // 通知外部开始分析
     this.callbackParams && this.callbackParams("start");
+    // 墙体图元准备就绪事件
     this._wallPrimitive._readyEvent.addEventListener(function (eventType) {
       if (eventType != "Ready") {
         return;
       }
+      // 通知外部分析结束
       that.callbackParams && that.callbackParams("end");
+      // 清除已有的平整多边形并基于开挖位置添加新的平整多边形
       that.g_flattenedPolygonTexture && that.g_flattenedPolygonTexture.removeAllFlattenedPolygon();
       var myPolygon = window.Cesium.PolygonGeometry.fromPositions({
         positions: that._options.positions,
@@ -220,7 +238,11 @@ class ModelExcavateViewModel {
       that.g_flattenedPolygonTexture && that.g_flattenedPolygonTexture.addFlattenedPolygon(myPolygon);
     });
   }
-  // 电锯效果
+  /**
+   * @description 创建电锯效果（带闪电材质的墙体和贴地折线）
+   * @param {Array} positions 坐标点数组
+   * @returns {Object} 贴地折线图元
+   */
   createPolyline(positions) {
     var material = window.Cesium.Material.fromType("Kq3dLightningMaterial", {});
     if (this.wall) {
@@ -265,6 +287,7 @@ class ModelExcavateViewModel {
     var flag = false;
     this.remove();
     var models = this._viewer.scene.primitives._primitives;
+    // 遍历所有3dtiles，对选中模型启用平整并附加纹理
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset && models[i]._url) {
         if (this.tiles.includes(models[i].guid)) {
@@ -280,6 +303,7 @@ class ModelExcavateViewModel {
       }
     }
     if (flag) {
+      // 存在模型时启动水平面积测量，触发后续开挖效果
       this._measureHandler.startMeasure(Cesium.Kq3dMeasureMode.HorizontalArea);
       // let that =this;
       // if (this._drawManager) {
@@ -293,6 +317,7 @@ class ModelExcavateViewModel {
       //   }, "ModelExcavateDraw");
       // }
     } else {
+      // 未添加模型时给出警告
       (0, _message.default)({
         message: this._language.value.webgl["addModelTips"],
         type: "warning"
@@ -306,7 +331,10 @@ class ModelExcavateViewModel {
       if (model.refresh) model.refresh(tileset, tile.content);
     }
   }
-  // 切换高度重新计算
+  /**
+   * @description 切换开挖深度并重新计算墙体高度
+   * @param {Number} val 开挖深度值
+   */
   setHeight(val) {
     this._options.height = Number(val);
     if (this._wallPrimitive) {
@@ -319,6 +347,7 @@ class ModelExcavateViewModel {
     if (!this._Kq3dTerrainExcavation) return;
     this.remove();
     var models = this._viewer.scene.primitives._primitives;
+    // 遍历所有3dtiles，对选中模型重新启用平整并刷新
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset && models[i]._url) {
         if (this.tiles.includes(models[i].guid)) {
@@ -336,6 +365,7 @@ class ModelExcavateViewModel {
   }
   resetModel() {
     var models = this._viewer.scene.primitives._primitives;
+    // 遍历所有3dtiles，取消平整并移除tileVisible监听
     for (let i = 0; i < models.length; i++) {
       if (models[i] instanceof Cesium.Cesium3DTileset && models[i]._url) {
         if (!models[i].refresh) models[i]?.tileVisible?.removeEventListener(this.tileVisible);
@@ -531,10 +561,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       lang,
       locale
     } = (0, _useGlobalConfig.useLocale)();
-    // Status
+    // 状态事件发送
     const emit = __emit;
     //语言
     let viewModel = null;
+    // 可选的3dtiles图层列表
     let tiles = (0, _vue.ref)([]);
     // 获取组件传参
     const props = __props;
@@ -583,18 +614,25 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         callbackParams("layer");
       }, 500);
     });
+    /**
+     * @description 回调函数，根据事件类型更新图层列表、加载状态并向外发送状态事件
+     * @param {String} key 事件类型：layer（图层更新）、start（开始分析）、end（分析结束）
+     */
     function callbackParams(key) {
       if (viewModel) {
         switch (key) {
+          // 图层更新：获取所有tileset并默认全选
           case "layer":
             tiles.value = viewModel?.findLayers?.() ?? []; // 获取所有tileset对象
             if (formItem.isCheckTilset) formItem.tileset = tiles.value.map(item => item.guid).filter(guid => guid);
             changeTilset(formItem.tileset);
             break;
+          // 开始分析：进入加载状态
           case "start":
             loadState.value = true;
             emit("callbackStatus", key);
             break;
+          // 分析结束：退出加载状态
           case "end":
             loadState.value = false;
             emit("callbackStatus", key);
@@ -613,7 +651,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.modelExcavateTitle");
       }
     };
-    // 切换模型
+    /**
+     * @description 切换开挖目标模型图层
+     * @param {Array} val 选中的tileset guid数组
+     */
     function changeTilset(val) {
       viewModel.tiles = formItem?.tileset ?? [];
     }
@@ -782,11 +823,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/modelfilter/index.js

@@ -104,6 +104,12 @@ var _gisUtils = __webpack_require__(20064);
 //模型滤镜逻辑类
 
 class ModelFilterViewModel {
+  /**
+   * @description 构造函数，合并默认参数与外部参数，初始化viewer及图层监听
+   * @param {Object} scenceView 三维场景视图对象
+   * @param {Object} options 外部传入的滤镜参数
+   * @param {Function} callbackParams 回调函数，用于通知外部状态变化
+   */
   constructor(scenceView, options, callbackParams) {
     this._viewer = null;
     //三维viewer对象
@@ -136,7 +142,7 @@ class ModelFilterViewModel {
   }
   // 查找所有3dtiles模型对象
   findLayers() {
-    let tilesets = [];
+    const tilesets = [];
     const primitives = this._viewer.scene.primitives._primitives;
     for (let m = 0; m < primitives.length; m++) {
       if (primitives[m] instanceof Cesium.Cesium3DTileset) {
@@ -150,7 +156,10 @@ class ModelFilterViewModel {
     return tilesets;
   }
 
-  // 设置过滤对象
+  /**
+   * @description 设置过滤对象：清除原滤镜，定位到目标图层并启用色彩校正
+   * @param {String} layerId 图层guid
+   */
   setLayer(layerId) {
     if (layerId) {
       this.clear();
@@ -160,7 +169,11 @@ class ModelFilterViewModel {
     }
   }
 
-  //根据id获取tileset对象
+  /**
+   * @description 根据id获取tileset对象
+   * @param {String} id 图层guid
+   * @returns {Object} tileset对象
+   */
   findLayerById(id) {
     const primitives = this._options.viewer.scene.primitives._primitives;
     const tileset = primitives.find(function (item) {
@@ -168,23 +181,38 @@ class ModelFilterViewModel {
     });
     return tileset;
   }
-  // 设置亮度
+  /**
+   * @description 设置亮度
+   * @param {Number} newValue 亮度值
+   */
   setBrightness(newValue) {
     this._options.tileset.brightness = Number(newValue);
   }
-  // 设置对比
+  /**
+   * @description 设置对比度
+   * @param {Number} newValue 对比度值
+   */
   setContrast(newValue) {
     this._options.tileset.contrast = Number(newValue);
   }
-  // 设置色调
+  /**
+   * @description 设置色调
+   * @param {Number} newValue 色调值
+   */
   setTone(newValue) {
     this._options.tileset.hue = Number(newValue);
   }
-  // 设置饱和
+  /**
+   * @description 设置饱和度
+   * @param {Number} newValue 饱和度值
+   */
   setSaturation(newValue) {
     this._options.tileset.saturation = Number(newValue);
   }
-  // 设置伽马
+  /**
+   * @description 设置伽马值
+   * @param {Number} newValue 伽马值
+   */
   setGamma(newValue) {
     this._options.tileset.gamma = Number(newValue);
   }
@@ -230,6 +258,7 @@ const __default__ = {
 };
 var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
   props: {
+    // 指定组件绑定的viewer对象的div的id
     mapTarget: {
       type: String
     },
@@ -280,6 +309,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     } = (0, _useGlobalConfig.useLocale)();
     let viewModel = null;
     let ref_box = (0, _vue.ref)();
+    // 可选的3dtiles图层列表
     let tiles = (0, _vue.ref)([]);
     // 获取组件传参
     const props = __props;
@@ -317,6 +347,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       //父组件ScenceView初始化完成后执行
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
+          // 组装滤镜参数初始化逻辑类
           let options = {
             tileset: formItem.tileset,
             brightness: formItem.brightness,
@@ -334,6 +365,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       }, 1000);
     });
+    /**
+     * @description 回调函数：图层数据变化时刷新可选图层列表并重置选中图层
+     * @param {String} key 事件类型
+     * @param {*} val 附加参数
+     */
     function callbackParams(key, val) {
       if (viewModel) {
         tiles.value = viewModel.findLayers(); // 获取所有tileset对象
@@ -350,9 +386,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.modelFilterPick");
       }
     };
+
+    /**
+     * @description 参数变化处理：根据变化类型调用对应的滤镜设置方法
+     * @param {String} value 变化的参数名：tileset/brightness/contrast/tone/saturation/gamma
+     */
     function paramsChanged(value) {
       if (formItem.tileset) {
         switch (value) {
+          // 切换图层时一次性应用全部滤镜参数
           case "tileset":
             viewModel.setLayer(formItem.tileset);
             viewModel.setBrightness(formItem.brightness);
@@ -379,6 +421,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       }
     }
+    // 清除滤镜并重置参数为默认值
     function clear() {
       viewModel.clear();
       formItem.brightness = 1;