@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/pointcloudrender/index.js

@@ -156,8 +156,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const {
       t
     } = (0, _useGlobalConfig.useLocale)();
-    let viewModel = null;
-    let tiles = (0, _vue.ref)([]);
+    let viewModel = null; // 点云渲染视图模型实例
+    let tiles = (0, _vue.ref)([]); // 所有点云图层对象列表
     // 获取组件传参
     const props = __props;
     // 组件容器Ref
@@ -174,7 +174,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       value: "2",
       src: _constImage.GREEN_TO_BLUE_URL
     }];
-    let renderList = (0, _vue.ref)([]);
+    let renderList = (0, _vue.ref)([]); // 分类渲染颜色列表
 
     //模型滤镜参数
     let formItem = (0, _vue.reactive)({
@@ -214,7 +214,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // 生成组件默认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) => {
@@ -257,6 +258,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.pointCloudStyleSettings");
       }
     };
+
+    // 获取分类渲染列表的初始默认配置
     function getInitRenderList() {
       return [{
         value: 0,
@@ -353,7 +356,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }];
     }
 
-    //获取图片
+    /**
+     * @description 获取指定色带值对应的图片地址
+     * @param {String} value 色带值（"0"/"1"/"2"）
+     * @returns {String} 图片地址
+     */
     function getColorImage(value) {
       var imagePath = "";
       var image = colorImages.find(item => item.value === value);
@@ -362,7 +369,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
       return imagePath;
     }
+
+    /**
+     * @description 表单参数变化处理
+     * @param {String} value 变化的字段名（layer/density/classificationRender/color/ribbonRender/minHeight/maxHeight/colorImage/colorOpacity/EDL/radius/strength）
+     */
     function paramsChanged(value) {
+      // 切换图层时重置表单参数
       if (value == "layer") reset();
       if (formItem.layerId || props.layerId) {
         switch (value) {
@@ -373,6 +386,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             viewModel.setDensity(formItem.density);
             break;
           case "classificationRender":
+            // 开启分类渲染时关闭色带渲染（互斥）
             if (formItem.isClassificationRender && formItem.isRibbonRender) {
               formItem.isRibbonRender = false;
               viewModel.setRibbonRender(false);
@@ -383,6 +397,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             viewModel.setClassificationRenderColor(renderList.value);
             break;
           case "ribbonRender":
+            // 开启色带渲染时关闭分类渲染（互斥）
             if (formItem.isRibbonRender && formItem.isClassificationRender) {
               formItem.isClassificationRender = false;
               viewModel.setClassificationRender(false);
@@ -390,6 +405,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             viewModel.setRibbonRender(formItem.isRibbonRender);
             break;
           case "minHeight":
+            // 最小高度大于最大高度时同步调整最大高度
             if (formItem.minHeight > formItem.maxHeight) {
               formItem.maxHeight = formItem.minHeight;
               viewModel.setMaxHeight(formItem.maxHeight);
@@ -397,6 +413,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             viewModel.setMinHeight(formItem.minHeight);
             break;
           case "maxHeight":
+            // 最小高度大于最大高度时同步调整最小高度
             if (formItem.minHeight > formItem.maxHeight) {
               formItem.minHeight = formItem.maxHeight;
               viewModel.setMinHeight(formItem.minHeight);
@@ -421,6 +438,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
           default:
             break;
         }
+
+        // 触发外部样式变化回调
         if (props.styleChanged) {
           let style = {
             density: 51 - formItem.density,
@@ -429,18 +448,21 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             isEDL: formItem.isEDL
           };
           if (style.isClassificationRender) {
+            // 分类渲染：附带渲染列表和条件
             style.renderList = JSON.parse(JSON.stringify(renderList.value));
             if (viewModel?._tileset?.style?.color) {
               style.conditions = JSON.parse(JSON.stringify(viewModel._tileset.style.color._conditions));
             }
           }
           if (style.isRibbonRender) {
+            // 色带渲染：附带高度范围和颜色配置
             style.minHeight = formItem.minHeight;
             style.maxHeight = formItem.maxHeight;
             style.color = formItem.color;
             style.colorOpacity = formItem.colorOpacity;
           }
           if (style.isEDL) {
+            // EDL照明：附带半径和强度
             style.radius = formItem.radius;
             style.strength = formItem.strength;
           }
@@ -448,6 +470,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       }
     }
+
+    // 重置表单参数为默认值
     function reset() {
       formItem.density = 35;
       formItem.isClassificationRender = false;
@@ -461,6 +485,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       formItem.radius = 1;
       formItem.strength = 1;
     }
+
+    // 清除选中图层样式
     function clear() {
       // reset();
       viewModel.clear();
@@ -938,6 +964,12 @@ var _constImage = __webpack_require__(4822);
 
 //点云样式设置逻辑类
 class PointCloudRenderViewModel {
+  // 当前选中的点云图层对象
+  /**
+   * @description 构造函数：初始化点云渲染视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} defaultOptions 默认参数对象
+   */
   constructor(scenceView, defaultOptions) {
     this._viewer = null;
     //三维viewer对象
@@ -948,9 +980,9 @@ class PointCloudRenderViewModel {
 
   // 查找所有3dtiles模型对象
   findLayers() {
-    let tilesets = [];
+    const tilesets = [];
     const primitives = this._viewer.scene.primitives._primitives;
-    let that = this;
+    const that = this;
     for (let m = 0; m < primitives.length; m++) {
       if (primitives[m] instanceof Cesium.Cesium3DTileset) {
         // 判断是否点云数据
@@ -967,15 +999,23 @@ class PointCloudRenderViewModel {
     }
     return tilesets;
   }
+
+  /**
+   * @description 判断tileset是否为点云图层
+   * @param {Object} tileset tileset对象
+   * @returns {Boolean} 是否为点云图层
+   */
   isPointCloudLayer(tileset) {
     let isPointCloud = false;
     if (tileset.root) {
       if (tileset.root._contentHeader) {
-        let uri = tileset.root._contentHeader.uri;
+        // 通过内容uri判断是否为.pnts点云文件
+        const uri = tileset.root._contentHeader.uri;
         if (uri && uri.indexOf('.pnts') > -1) {
           isPointCloud = true;
         }
       } else if (tileset.root.content) {
+        // 通过内容类型判断是否为空内容（视作点云）
         if (tileset.root.content instanceof Cesium.Empty3DTileContent) {
           isPointCloud = true;
         }
@@ -984,30 +1024,44 @@ class PointCloudRenderViewModel {
     return isPointCloud;
   }
 
+  /**
+   * @description 选择点云图层并同步表单参数
+   * @param {String} layerId 图层guid
+   * @param {Object} formItem 表单参数对象
+   * @param {Object} renderList 分类渲染列表ref
+   * @param {Boolean} isFly 是否飞行定位到图层
+   */
   // 选择点云图层
   setLayer(layerId, formItem, renderList, isFly) {
     this._tileset = this.findLayerById(layerId);
     if (this._tileset) {
       if (isFly) {
-        let that = this;
+        // 飞行定位到点云图层
+        const that = this;
         this._tileset.readyPromise.then(function (tileset) {
           that._viewer.camera.flyToBoundingSphere(tileset.boundingSphere, {
             offset: new Cesium.HeadingPitchRange(0.0, Cesium.Math.toRadians(-90.0), tileset.boundingSphere.radius * 2)
           });
         });
       }
+      // 同步密度参数
       formItem.density = 51 - this._tileset.maximumScreenSpaceError;
+
+      // 已存在分类渲染列表时同步分类渲染状态
       if (this._tileset.classificationRenderList) {
         formItem.isClassificationRender = true;
         renderList.value = this._tileset.classificationRenderList;
       }
+
+      // 已存在色带渲染配置时同步色带渲染状态
       if (this._tileset.coloringPointCloud) {
         if (this._tileset.coloringPointCloud.enableColoring) {
           formItem.isRibbonRender = true;
           formItem.minHeight = this._tileset.coloringPointCloud.minHeight;
           formItem.maxHeight = this._tileset.coloringPointCloud.maxHeight;
           formItem.colorOpacity = this._tileset.coloringPointCloud.alpha;
-          let colorImage = this._tileset.coloringPointCloud.colorImage;
+          // 根据色带图片url反推色带值
+          const colorImage = this._tileset.coloringPointCloud.colorImage;
           if (colorImage == _constImage.RED_TO_PURPLE_URL) {
             formItem.color = '0';
           } else if (colorImage == _constImage.PURPLE_TO_YELLOW_URL) {
@@ -1017,13 +1071,19 @@ class PointCloudRenderViewModel {
           }
         }
       }
+
+      // 同步EDL照明参数
       formItem.isEDL = this._tileset.pointCloudShading.attenuation;
       formItem.radius = this._tileset.pointCloudShading.eyeDomeLightingRadius;
       formItem.strength = this._tileset.pointCloudShading.eyeDomeLightingStrength;
     }
   }
 
-  //根据id获取tileset对象
+  /**
+   * @description 根据id获取tileset对象
+   * @param {String} id 图层guid
+   * @returns {Object} tileset对象
+   */
   findLayerById(id) {
     const primitives = this._viewer.scene.primitives._primitives;
     const tileset = primitives.find(function (item) {
@@ -1031,14 +1091,26 @@ class PointCloudRenderViewModel {
     });
     return tileset;
   }
+
+  /**
+   * @description 设置点云密度
+   * @param {Number} value 密度值
+   */
   setDensity(value) {
     if (this._tileset) this._tileset.maximumScreenSpaceError = 51 - Number(value);
   }
+
+  /**
+   * @description 设置是否启用分类渲染
+   * @param {Boolean} value 是否启用分类渲染
+   * @param {Array} renderList 分类渲染列表
+   */
   setClassificationRender(value, renderList) {
     if (this._tileset) {
       if (value) {
-        let renderListCopy = JSON.parse(JSON.stringify(renderList));
-        let conditions = [];
+        // 开启分类渲染：根据渲染列表构建3DTileStyle条件
+        const renderListCopy = JSON.parse(JSON.stringify(renderList));
+        const conditions = [];
         renderListCopy.forEach(render => {
           if (render.color) conditions.unshift(['${' + this._defaultOptions.renderField + '} ===' + render.value, 'color("' + render.color + '")']);
         });
@@ -1049,15 +1121,21 @@ class PointCloudRenderViewModel {
         });
         this._tileset.classificationRenderList = renderListCopy;
       } else {
+        // 关闭分类渲染：清除样式
         this._tileset.style = null;
         this._tileset.classificationRenderList = null;
       }
     }
   }
+
+  /**
+   * @description 设置分类渲染颜色
+   * @param {Array} value 分类渲染列表
+   */
   setClassificationRenderColor(value) {
     if (this._tileset) {
-      let renderList = JSON.parse(JSON.stringify(value));
-      let conditions = [];
+      const renderList = JSON.parse(JSON.stringify(value));
+      const conditions = [];
       renderList.forEach(render => {
         if (render.color) conditions.unshift(['${' + this._defaultOptions.renderField + '} ===' + render.value, 'color("' + render.color + '")']);
       });
@@ -1069,8 +1147,14 @@ class PointCloudRenderViewModel {
       this._tileset.classificationRenderList = renderList;
     }
   }
+
+  /**
+   * @description 设置是否启用色带渲染（懒加载色带渲染对象）
+   * @param {Boolean} value 是否启用色带渲染
+   */
   setRibbonRender(value) {
     if (this._tileset) {
+      // 不存在色带渲染对象时创建一个
       if (!this._tileset.coloringPointCloud) {
         this._tileset.coloringPointCloud = new Cesium.Kq3dColoringPointCloud({
           viewer: this._viewer,
@@ -1086,32 +1170,67 @@ class PointCloudRenderViewModel {
       this._tileset.coloringPointCloud.enableColoring = value;
     }
   }
+
+  /**
+   * @description 设置色带渲染最小高度
+   * @param {Number} value 最小高度
+   */
   setMinHeight(value) {
     if (this._tileset && this._tileset.coloringPointCloud) {
       this._tileset.coloringPointCloud.minHeight = Number(value);
     }
   }
+
+  /**
+   * @description 设置色带渲染最大高度
+   * @param {Number} value 最大高度
+   */
   setMaxHeight(value) {
     if (this._tileset && this._tileset.coloringPointCloud) {
       this._tileset.coloringPointCloud.maxHeight = Number(value);
     }
   }
+
+  /**
+   * @description 设置色带渲染图片
+   * @param {String} value 色带图片地址
+   */
   setColorImage(value) {
     if (this._tileset && this._tileset.coloringPointCloud) {
       this._tileset.coloringPointCloud.colorImage = value;
     }
   }
+
+  /**
+   * @description 设置色带渲染不透明度
+   * @param {Number} value 不透明度（0-1）
+   */
   setColorOpacity(value) {
     if (this._tileset && this._tileset.coloringPointCloud) {
       this._tileset.coloringPointCloud.alpha = Number(value);
     }
   }
+
+  /**
+   * @description 设置是否启用EDL照明
+   * @param {Boolean} value 是否启用EDL照明
+   */
   setEDL(value) {
     if (this._tileset) this._tileset.pointCloudShading.attenuation = value;
   }
+
+  /**
+   * @description 设置EDL照明半径
+   * @param {Number} value 半径值
+   */
   setRadius(value) {
     if (this._tileset) this._tileset.pointCloudShading.eyeDomeLightingRadius = Number(value);
   }
+
+  /**
+   * @description 设置EDL照明强度
+   * @param {Number} value 强度值
+   */
   setStrength(value) {
     if (this._tileset) this._tileset.pointCloudShading.eyeDomeLightingStrength = Number(value);
   }

package/radarscananalysis/index.js

@@ -49,8 +49,14 @@ Object.defineProperty(exports, "__esModule", ({
 exports["default"] = void 0;
 class RadarScanAnalysisViewModel {
   // 扫描对象
+  /**
+   * @description 构造函数：初始化雷达扫描分析视图模型
+   * @param {Object} scenceView 场景视图对象
+   * @param {Object} option 表单参数对象
+   */
   constructor(scenceView, option) {
     this._viewer = null;
+    //三维viewer对象
     //参数
     this._options = {
       heading: 0,
@@ -82,6 +88,11 @@ class RadarScanAnalysisViewModel {
     Object.assign(this._options, option);
     this._drawManager = scenceView._drawManager;
   }
+  /**
+   * @description 获取颜色rgba值
+   * @param {Object} color Cesium.Color对象
+   * @returns {String} rgba颜色字符串
+   */
   //获取颜色rgba值
   getRgba(color) {
     var red = color.red * 255;
@@ -90,6 +101,12 @@ class RadarScanAnalysisViewModel {
     var alpha = color.alpha;
     return 'rgba(' + red + ',' + green + ',' + blue + ',' + alpha + ')';
   }
+  /**
+   * @description 渐变纹理
+   * @param {Array} values 渐变停止点位置数组
+   * @param {Boolean} isVertical 是否为垂直渐变
+   * @returns {HTMLCanvasElement} 渐变纹理canvas
+   */
   //渐变纹理
   getColorRamp(values, isVertical) {
     var sectorColor0 = Cesium.Color.fromCssColorString(this._options.sectorColor).withAlpha(.6);
@@ -104,9 +121,15 @@ class RadarScanAnalysisViewModel {
     grd.addColorStop(values[0], color0);
     grd.addColorStop(values[1], color1);
     ctx.fillStyle = grd;
+
+    // 垂直方向填充1x100，水平方向填充100x1
     if (isVertical) ctx.fillRect(0, 0, 1, 100);else ctx.fillRect(0, 0, 100, 1);
     return ramp;
   }
+  /**
+   * @description 参数切换
+   * @param {String} key 变化的字段名
+   */
   // 参数切换
   paramsChanged(key) {
     if (!this._radarScan) return;
@@ -136,6 +159,7 @@ class RadarScanAnalysisViewModel {
         this._radarScan.sectorOutlineColor = Cesium.Color.fromCssColorString(this._options.sectorOutlineColor).withAlpha(Number(this._options[key]));
         break;
       default:
+        // 默认：直接以数值形式赋值（如radius等）
         this._radarScan[key] = Number(this._options[key]);
         break;
     }
@@ -160,6 +184,7 @@ class RadarScanAnalysisViewModel {
           });
           //实例化
           if (!that._radarScan) {
+            // 不存在扫描对象时：创建新的RadarScan
             that._radarScan = new RadarScan({
               viewer: that._viewer,
               longitude: that._options.longitude,
@@ -175,6 +200,7 @@ class RadarScanAnalysisViewModel {
               sectorOutlineColor: Cesium.Color.fromCssColorString(that._options.sectorOutlineColor).withAlpha(that._options.sectorOutlineColorAlpha)
             });
           } else {
+            // 已存在扫描对象时：仅更新位置
             Object.assign(that._radarScan, {
               longitude: that._options.longitude,
               latitude: that._options.latitude
@@ -299,6 +325,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     } = (0, _useGlobalConfig.useLocale)();
     // 获取组件传参
     const props = __props;
+
+    //雷达扫描分析表单参数
     let formItem = (0, _vue.reactive)({
       collapseValue: props?.settingParams?.collapseValue ?? "setting",
       // 默认展开属性设置
@@ -324,14 +352,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 扇形颜色边框颜色
       sectorOutlineColorAlpha: props?.settingParams?.sectorOutlineColorAlpha ?? 0.9 // 扇形颜色边框透明度
     });
-    let viewModel = null;
+    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) => {
@@ -359,7 +388,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.radarScanAnalysisTitle");
       }
     };
-    // 切换参数
+    /**
+     * @description 切换参数处理
+     * @param {String} key 变化的字段名（radius/ellipsoidColor/ellipsoidColorAlpha/ellipsoidOutlineColor/ellipsoidOutlineColorAlpha/sectorColor/sectorColorAlpha/sectorOutlineColor/sectorOutlineColorAlpha）
+     */
     function paramsChanged(key) {
       if (!viewModel) return;
       viewModel._options[key] = formItem[key];

package/resetview/index.js

@@ -201,6 +201,10 @@ exports["default"] = void 0;
 // 重置视图
 class ResetViewViewModel {
   //三维viewer对象
+  /**
+   * @description 构造函数：初始化重置视图视图模型
+   * @param {Object} viewer 三维viewer对象
+   */
   constructor(viewer) {
     this._viewer = null;
     this._viewer = viewer;
@@ -309,8 +313,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       locale
     } = (0, _useGlobalConfig.useLocale)();
     const props = __props;
-    let viewModel = null;
-    let btn = (0, _vue.ref)(null);
+    let viewModel = null; // 重置视图视图模型实例
+    let btn = (0, _vue.ref)(null); // 按钮Ref
+
     (0, _vue.onMounted)(() => {
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
@@ -318,7 +323,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         }
       });
     });
-    // 按钮点击事件
+    /**
+     * @description 按钮点击事件：失焦按钮并重置视角
+     * @param {Object} e 事件对象
+     */
     function btnClick(e) {
       btn.value.$el.blur();
       viewModel && viewModel.resetView();
@@ -440,11 +448,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;
 
 /***/ })