@mapgis/webclient-cesium-plugin 17.8.1 → 17.10.9

package/README.md

@@ -1,675 +1,513 @@
-# 1、获取 MapGIS 3DClient for WebGL 开发包
+# 1、获取 MapGIS Client for JavaScript（Cesium）开发包
 
-开发时需要引入MapGIS 3DClient for WebGL（即 MapGIS Client for JavaScript (Cesium)）开发包；其中包括必备的 CSS 文件和 JS 文件；
+MapGIS Client for JavaScript（Cesium）是 WebClient 面向 Cesium 引擎的三维地图插件包，承接 `@mapgis/webclient-common` 的地图、图层、几何、符号和工具等通用接口，并完成三维场景下的引擎适配。
 
-开发库分为正式发行版和Beta版;
+该包提供 Cesium 引擎下的核心能力扩展，覆盖三维场景、地形、M3D/模型、空间分析、可视化和交互编辑等 WebGIS 应用能力。
 
-* 正式版：面向公网用户，半年发行一次，发行后不会增加新功能，仅会修订BUG
-* Beta版：面向内网用户，每周发行一次，会修订BUG并增加新功能
-下面分别介绍两种版本包的获取方式：
+- 示例站点：[http://webclient.smaryun.com](http://webclient.smaryun.com)
 
-## 1.1、正式发行版及其更新包
+## 1.1、获取方式
 
-### 1.1.1、文件方式引入
+### 1.1.1、npm 安装
 
-**前往**[司马云官网](http://smaryun.com/dev/download_detail.html#/download828)**下载MapGIS 3DClient for WebGL开发库**
+推荐在现代工程中通过 npm 安装插件包和 Cesium 引擎包：
 
-以10.6.2.10为例，其中：
-
-* mapgis-client-for-javascript-dist-v10.6.2.10.rar为开发库
-* mapgis-client-for-javascript-all-v10.6.2.10.rar为开发库+示例站点
-**MapGIS 3DClient for WebGL所需开发包位于如下文件夹中**
-
-* webclient-cesium-plugin库：`mapgis-client-for-javascript-all-v10.6.2.10\dist\cdn\zondyclient\webclient-cesium-plugin.min.js`
-* Cesium库：`mapgis-client-for-javascript-all-v10.6.2.10\dist\cdn\cesium`
-**之后请将webclient-cesium-plugin.min.js文件和cesium文件夹拷贝出来，放入项目的静态资源目录**
-
-### 1.1.2、npm 方式引入
-
-**通过****公网****NPM的方式进行安装**
-
-```plain
-npm install @mapgis/cesium
-npm install @mapgis/webclient-cesium-plugin
+```typescript
+npm install @mapgis/webclient-common @mapgis/webclient-cesium-plugin @mapgis/cesium
 ```
 
-**安装中需要注意的事项：**
-
-* 其中@mapgis/cesium库，目前版本仅支持ES5的打包方式，因此请以NPM的方式下载开发包，npm安装完成后，请将开发包从node_modules里的@mapgis/cesium文件夹里拷贝出来，放入项目的静态资源目录中
-<center>
-  <img src="http://webclient.smaryun.com/static/modules/cesium/source/img/开发指南_3.png" style="zoom:100%;" />
-</center>
-
-
-## 1.2、Beta版
-
-### 1.2.1、文件方式引入
-
-**前往内网****npm****开发库下载MapGIS 3DClient for WebGL相关开发包**
-
-* [@mapgis/webclient-cesium-plugin](http://192.168.11.130:4873/-/web/detail/@mapgis/webclient-cesium-plugin)
-* [@mapgis/cesium](http://192.168.11.130:4873/-/web/detail/@mapgis/cesium)
-以 16.1.26版本为例进行说明
+`@mapgis/webclient-cesium-plugin` 负责 WebClient 三维能力扩展，`@mapgis/cesium` 提供 Cesium 引擎运行时和静态资源。
 
-1.在该网页中请先选择要下载的版本
+### 1.1.2、静态资源引入
 
-<center>
-  <img src="http://webclient.smaryun.com/static/modules/cesium/source/img/开发指南_1.png" style="zoom:100%;" />
-</center>
+如果项目暂时不接入构建链，可以直接使用发布包中的静态资源：
 
+如果需要通过 CDN 格式开发包或离线示例站点集成，可前往：[http://smaryun.com/dev/download_detail.html#/download828](http://smaryun.com/dev/download_detail.html#/download828)。
 
-2.点击相应的版本号，在右侧点击下载按钮，下载压缩包
+- `dist/esm/webclient-cesium-plugin.js`
+- `dist/umd/webclient-cesium-plugin.min.js`
+- `dist/webclient-cesium-plugin-resource`
+- `@mapgis/cesium` 发布包中的 Cesium 引擎目录
 
-<center>
-  <img src="http://webclient.smaryun.com/static/modules/cesium/source/img/开发指南_2.png" style="zoom:100%;" />
-</center>
+常见做法是将 Cesium 引擎目录、`webclient-cesium-plugin.min.js` 和插件资源目录拷贝到项目静态资源目录，再通过 `<script>` 和 `<link>` 加载。
 
+## 1.2、能力范围
 
-MapGIS 3DClient for WebGL所需开发包位于如下文件夹：
+- `view`：三维场景视图、图层视图和视图交互
+- `layer`：地图、影像、地形、模型、场景、矢量和三维瓦片图层
+- `analysis`：通视、剖面、淹没、填挖方、日照和空间量算分析
+- `visualization`：专题图、热力图、风场和三维效果表达
+- `editor`：绘制、草图编辑和三维交互编辑
+- `engineExtensions`：Cesium 引擎扩展、资源适配和 MapGIS 能力桥接
+- `resource`：插件纹理、样式、Worker 和运行时资源
 
-* webclient-cesium-plugin库：`webclient-cesium-plugin-16.1.26\package\dist\webclient-cesium-plugin.min.js`
-* cesium库：`cesium-16.1.26\package\dist`
+# 2、引入方式
 
+## 2.1、ESM 引入
 
-**请将**`cesium-16.1.26\package\dist`**文件夹改名为“cesium”，之后将**`webclient-cesium-plugin.min.js`**文件和cesium文件夹拷贝出来，放入项目的静态资源目录。**
-
-### 1.2.2、npm 方式引入
-
-**请先将npm源切换为内网：**
+现代工程建议使用 ESM 方式引入插件 API，并在页面中加载 Cesium 引擎资源：
 
 ```typescript
-npm set registry http://192.168.11.130:4873/
+import { Map as ZondyMap } from '@mapgis/webclient-common'
+import { SceneView, IGSSceneLayer } from '@mapgis/webclient-cesium-plugin'
 ```
 
-**通过内网NPM的方式进行安装**
+Cesium 引擎包需要按项目构建策略复制到静态资源目录，并在入口 HTML 中加载：
 
-```plain
-npm install @mapgis/cesium
-npm install @mapgis/webclient-cesium-plugin
+```html
+<script src="/static/cesium/Cesium.js"></script>
+<link rel="stylesheet" href="/static/cesium/Widgets/widgets.css" />
+<link rel="stylesheet" href="/static/cesium/MapGIS/css/mapgis.css" />
 ```
 
-**安装中需要注意的事项：**
-
-* 其中@mapgis/cesium开发包仅支持通过文件的方式引入，不支持模块化通过import的方式引入，npm安装完成后，请将开发包从node_modules里的@mapgis/cesium文件夹里拷贝出来，放入项目的静态资源目录中
-![图片](data:image/png;base64,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)
+## 2.2、全局引入
+
+如果使用传统页面或旧工程，可直接挂载全局对象：
+
+```html
+<script src="/static/cesium/Cesium.js"></script>
+<link rel="stylesheet" href="/static/cesium/Widgets/widgets.css" />
+<link rel="stylesheet" href="/static/cesium/MapGIS/css/mapgis.css" />
+<script src="/static/libs/zondyclient/webclient-common.min.js"></script>
+<script src="/static/libs/zondyclient/webclient-cesium-plugin.min.js"></script>
+<script>
+  const { Map: ZondyMap } = window.MapGISWebClientCommon
+  const { SceneView } = window.MapGISWebClientCesiumPlugin
+  const legacyNamespace = window.zondy
+  const compatNamespace = window.Zondy
+</script>
+```
 
+全局对象同时保留新命名空间和 `window.zondy`、`window.Zondy` 兼容入口，便于旧代码迁移。
 
-# 2、引入开发库 
+# 3、快速开始
 
-## 2.1、文件方式引入
+下面示例展示三维场景视图的最小初始化方式。实际项目中，请将容器尺寸设置为可见区域高度。
 
-**在index.html中引入引擎库和插件库**
+## 3.1、创建场景视图
 
 ```typescript
-<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
-    <!--引擎库-->
-    <script src="http://{ip}:{port}/{你的路径}/cesium/Cesium.js"></script>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/Widgets/widgets.css"/>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/MapGIS/css/mapgis.css"/>
-    <!--插件库-->
-    <script src="http://{ip}:{port}/{你的路径}/webclient-cesium-plugin/webclient-cesium-plugin.min.js"></script>
-</head>
-</html>
-```
-
-## 2.1、npm 方式引入
-
-**由于目前@mapgis/cesium包不支持ES6的方式，因此通过文件方式引入引擎库**
-
-```plain
-<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
-    <!--引擎库-->
-    <script src="http://{ip}:{port}/{你的路径}/cesium/Cesium.js"></script>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/Widgets/widgets.css"/>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/MapGIS/css/mapgis.css"/>
-</head>
-</html>
-```
-
-**通过npm的方式安装@mapgis/webclient-cesium-plugin插件库**
+import { Map as ZondyMap } from '@mapgis/webclient-common'
+import { SceneView } from '@mapgis/webclient-cesium-plugin'
 
-```typescript
-npm install @mapgis/webclient-cesium-plugin
+const zondyMap = new ZondyMap()
+const sceneView = new SceneView({
+  viewId: 'scene-container',
+  map: zondyMap
+})
 ```
 
-# 3、初始化场景视图
-
-## 3.1、文件方式引入
-
-**在项目的css文件中设置场景视图容器的样式，否则场景视图无法显示**
+## 3.2、加载场景图层
 
 ```typescript
-/*设置场景视图的样式，一定要设置否则地图无法显示*/
-#你的场景视图的id {
-    width: 100%;
-    height: 100%;
-    position: absolute;
-}
-```
+import { Map as ZondyMap } from '@mapgis/webclient-common'
+import { IGSSceneLayer } from '@mapgis/webclient-cesium-plugin'
 
-**初始化场景视图对象**
+const zondyMap = new ZondyMap()
+const sceneLayer = new IGSSceneLayer({
+  url: 'http://server/igs/rest/g3d/SceneServer'
+})
 
-```typescript
-<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
-    <!--引擎库-->
-    <script src="http://{ip}:{port}/{你的路径}/cesium/Cesium.js"></script>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/Widgets/widgets.css"/>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/MapGIS/css/mapgis.css"/>
-    <!--插件库-->
-    <script src="http://{ip}:{port}/{你的路径}/webclient-cesium-plugin/webclient-cesium-plugin.min.js"></script>  
-    <style>
-      /*设置地图视图的样式，一定要设置否则地图无法显示*/
-      #你的场景视图的id {
-        width: 100%;
-        height: 100%;
-        position: absolute;
-      }
-    </style>
-    <script>
-      //初始化图层管理容器
-      const map = new zondy.Map();
-      //初始化场景视图对象
-      const sceneView = new zondy.SceneView({
-        //视图id
-        viewId: "你的场景视图的id",
-        //图层管理容器
-        map: map
-      });
-    </script>
-</head>
-<!--场景视图容器div-->
-<div id="你的场景视图的id">
-</div>
-</html>
+zondyMap.add(sceneLayer)
 ```
 
-## 3.2、npm 方式引入
-
-**以VUE项目为例，React和Angular类似**
-
-**在项目的css文件中设置场景视图容器的样式，否则场景视图无法显示**
-
-```typescript
-/*设置场景视图的样式，一定要设置否则地图无法显示*/
-#你的场景视图的id {
-    width: 100%;
-    height: 100%;
-    position: absolute;
-}
+## 3.3、全局方式
+
+```html
+<div id="scene-container"></div>
+<script>
+  const zondyMap = new zondy.Map()
+  const sceneView = new zondy.cesium.SceneView({
+    viewId: 'scene-container',
+    map: zondyMap
+  })
+</script>
 ```
 
-**找到项目的index.html文件，由于@mapgis/Cesium不支持ES6模式，因此在里面引入引擎库**
+# 4、@mapgis/webclient-cesium-plugin 版本说明
 
-```typescript
-<!DOCTYPE html>
-<html>
-<head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
-    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no">
-    <!--引擎库-->
-    <script src="http://{ip}:{port}/{你的路径}/cesium/Cesium.js"></script>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/Widgets/widgets.css"/>
-    <link rel="stylesheet" href="http://{ip}:{port}/{你的路径}/cesium/MapGIS/css/mapgis.css"/>
-</head>
-<div id="app"></div>
-</html>
-```
+## v17.10.9
 
-**在你的vue组件的template中设置场景视图容器的div元素**
+1. 修复
 
-```typescript
-<!--场景视图容器div-->
-<div id="你的场景视图的id">
-</div>
-```
+- 修改分包配置，把commonjsHelpers单独打包成一个chunk，避免打入s3m中
 
-**引入需要的构造函数**
+## v17.10.7
 
-```typescript
-import { SceneView } from '@mapgis/webclient-cesium-plugin'
-import { Map } from "@mapgis/webclient-common"
-```
+1. 修复
 
-**在mounted生命周期中初始化场景视图**
+- 修改注释问题
 
-```typescript
-// 初始化图层管理容器
-const map = new Map();
-// 初始化地图视图对象
-const sceneView = new SceneView({
-  // 视图id
-  viewId: "你的场景视图的id",
-  // 图层管理容器
-  map: map
-});
-```
+## v17.10.6
 
+1. 修复
 
+- 三维点符号，切换符号样式后，旧的符号样式未删除
 
-# 4、@mapgis/webclient-cesium-plugin 版本说明
+## v17.10.4
 
-## 4.1、正式版
+1. 修复
 
-###  v17.8.1
+- 修复线符号 solid/none 样式切换失效以及同 id 图形缓存问题
 
-**更新说明：**
+## v17.10.2
 
-1. 功能优化
+1. 修复
 
-- 修复已知问题
+- 上下标+分式注记显示不全
+- 修复cesium-plugin中Style类未导出的问题
+- 导入 Marker 类型标绘对象后，Marker 的颜色属性未正确应用导入数据中的配置，仍保持默认值
 
-###  v17.8.0
-
-**更新说明：**
+## v17.10.0
 
 1. 新增
 
-- Cesium 地形剖切支持凹多边形
-- 新增路径漫游工具 RouteAnimationTool 支持实例化多个路径漫游工具
-- 地质体剖切功能支持 3D Tiles 格式数据（3D Tiles 1.0和 3D Tiles 1.1）
-- 环境特效增强，支持天气特效、水下特效、集群鸟类与动物、镜头特效
+- 支持地形裁剪抬升
+- 新增极端天气模拟-雷暴天气
+- 新增水面、水下特效；
+- 新增3D图形默认自定义材质
+- 新增 elevationInfo 到 Cesium ImageryLayer.classificationType 的转换逻辑，并在各类影像/瓦片/矢量瓦片图层创建及属性更新时生效，支持 onTheScene 模式下图层叠加到三维模型之上。
 
 2. 优化
 
-- 优化使用非 FID 属性时更新 Cesium3DTileStyle 场景渲染效率
+- 优化体积云性能
+- 优化栅格体元显示效率及效果
+- 地形开挖支持动态设置是否显示开挖侧面和底面
 
-###  v17.6.25
+3. 修复
 
-**更新说明：**
+- 修复已知问题
 
-1. 功能优化
+## v17.8.10
 
-- 修复 imageryLayer.imageryProvide 对象在不同版本 Cesium 上不兼容的问题
+1. 修复
 
-###  v17.6.24
+- 修复传编码的空间过滤参数后，空间过滤不生效的问题
+- 修复IGS地图服务一张图 POST 请求不生效的问题
 
-**更新说明：**
+## v17.8.9
 
-1. 功能优化
+1. 修复
 
 - 修复已知问题
 
-###  v17.6.23
+## v17.8.8
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 修复已知问题
 
-###  v17.6.22
-
-**更新说明：**
-
-1. 功能优化
+## v17.8.7
 
-- 修复天际线分析中颜色设置失败的问题
+1. 修复
 
-###  v17.6.21
+- 修复已知问题
 
-**更新说明：**
+## v17.8.6
 
-1. 功能优化
+1. 修复
 
-- 优化重复设置 Graphic 的 显隐属性值为 true 时场景卡顿的问题
+- 修复已知问题
 
-###  v17.6.20
+## v17.8.5
 
-**更新说明：**
+1. 修复
 
-1. 功能优化
+- 修复地图服务图层到一定级别不显示的问题
 
-- 解决地图缩放时，加载自定义裁图图层时中间状态出现闪烁的问题
-- 解决使用 startDrawing 添加广告牌时重复添加图元的问题
+## v17.8.4
 
-###  v17.6.19
+1. 修复
 
-**更新说明：**
+- 在一定视角下加载自定义裁图图层卡顿
 
-1. 功能优化
+## v17.8.3
 
-- 解决聚合专题图报错的问题
+1. 修复
 
-###  v17.6.18
+- 修复已知问题
 
-**更新说明：**
+## v17.8.2
 
-1. 功能优化
+1. 修复
 
-- 修复场景图层 hitTest 拾取报错的问题
+- 修复已知问题
 
-###  v17.6.17
+## v17.8.1
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 修复已知问题
 
-###  v17.6.16
+## v17.8.0
 
-**更新说明：**
+1. 新增
 
-1. 功能优化
+- Cesium 地形剖切支持凹多边形
+- 新增路径漫游工具 RouteAnimationTool 支持实例化多个路径漫游工具
+- 地质体剖切功能支持 3D Tiles 格式数据（3D Tiles 1.0和 3D Tiles 1.1）
+- 环境特效增强，支持天气特效、水下特效、集群鸟类与动物、镜头特效
 
-- 修复已知问题
+2. 修复
 
-###  v17.6.15
+- 优化使用非 FID 属性时更新 Cesium3DTileStyle 场景渲染效率
 
-**更新说明：**
+## v17.6.25
 
-1. 功能优化
+1. 修复
 
-- 插件库适配 Cesium.defaultValue 方法，以兼容官方 Cesium 的接口更新改动
-- 修复 Cesium Viewer 中设置默认底图报错的问题 
+- 修复 imageryLayer.imageryProvide 对象在不同版本 Cesium 上不兼容的问题
 
-###  v17.6.14
+## v17.6.24
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 修复已知问题
 
-###  v17.6.13
+## v17.6.23
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 修复已知问题
 
-###  v17.6.12
+## v17.6.22
 
-**更新说明：**
+1. 修复
 
-- 优化瓦片类型Provider上isStretchImage参数默认拉伸
+- 修复天际线分析中颜色设置失败的问题
 
-###  v17.6.11
+## v17.6.21
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 优化重复设置 Graphic 的 显隐属性值为 true 时场景卡顿的问题
 
-###  v17.6.10
+## v17.6.20
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 解决地图缩放时，加载自定义裁图图层时中间状态出现闪烁的问题
+- 解决使用 startDrawing 添加广告牌时重复添加图元的问题
 
-###  v17.6.9
+## v17.6.19
 
-**更新说明：**
+1. 修复
 
-- 此版本无更新
+- 解决聚合专题图报错的问题
 
-###  v17.6.8
+## v17.6.18
 
-**更新说明：**
+1. 修复
 
-1. 功能优化
+- 修复场景图层 hitTest 拾取报错的问题
 
-- 修复包含空格字符的图层访问令牌（token）认证失败问题
+## v17.6.16
 
-###  v17.6.7
+1. 修复
 
-**更新说明：**
+- 修复已知问题
 
-- 此版本无更新
+## v17.6.15
 
-###  v17.6.6
+1. 修复
 
-**更新说明：**
+- 插件库适配 Cesium.defaultValue 方法，以兼容官方 Cesium 的接口更新改动
+- 修复 Cesium Viewer 中设置默认底图报错的问题
 
-1. 功能优化
+## v17.6.12
 
-- 优化IGS地图服务一张图出图模式下闪烁和卡顿的问题
+1. 修复
 
-###  v17.6.5
+- 优化瓦片类型Provider上isStretchImage参数默认拉伸
 
-**更新说明：**
+## v17.6.8
 
-- 此版本无更新
+1. 修复
 
-###  v17.6.4
+- 修复包含空格字符的图层访问令牌（token）认证失败问题
 
-**更新说明：**
+## v17.6.6
 
-- 此版本无更新
+1. 修复
 
-###  v17.6.3
+- 优化IGS地图服务一张图出图模式下闪烁和卡顿的问题
 
-**更新说明：**
+## v17.6.3
 
-1. 功能优化
+1. 修复
 
 - 修复可视域分析视锥体未定义时的报错问题
 - 修复混合接口方式加载动态服务时，出图过滤条件报错的问题
 
-###  v17.6.2
+## v17.6.2
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 修复高频率更新流体模拟粒子数量时出现偶发报错的问题
 
-###  v17.6.1
-
-**更新说明：**
-
-- 此版本无更新
+## v17.6.0
 
-###  v17.6.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 支持三维仿真可视化：流体模拟仿真和水体效果可视化
 - 面积、长度、角度、三角、方位角测量工具支持显示多个测量结果
 - 新增IGS地图服务、ArcGIS地图服务、WMS服务一张图出图的服务接入Provider
 
-2. 功能优化
+2. 修复
+
 - 优化M3D2.0、2.1服务数据的加载性能和效果
 - 优化剖面分析工具和地形分析工具功能效果
 
+## v17.4.7
 
-###  v17.4.7
-
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 修复Graphic中半透明图元顺序异常的问题
 - 修复剖面分析工具接口异常的问题
 - 修复Popup弹窗接口异常的问题
 
-###  v17.4.6
+## v17.4.6
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 修复场景设置罗盘失败的问题
 - 修复剖切分析中绘制模型裁剪面功能中，配置剖切辅助面属性不生效的问题
 - 修复碰撞检测中多次开启漫游时，碰撞检测失效的问题
 
-###  v17.4.5
-
-**更新说明：**
+## v17.4.5
 
-1. 功能优化
+1. 修复
 
 - 修复CuttingTool无法剖切3D Tiles的问题
 
-###  v17.4.4
-
-**更新说明：**
+## v17.4.4
 
-1. 功能优化
+1. 修复
 
 - 优化 GraphicsLayer 图层中深度检测设置的默认值
 
-###  v17.4.3
+## v17.4.3
 
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 新增MapGIS网格要素容器类MapGISFeatureGridCollection
 
-2. 功能优化
+2. 修复
 
 - 优化面积测量工具图形外边线绘制效果
 
-###  v17.4.2
-
-**更新说明：**
+## v17.4.2
 
-1. 功能优化
+1. 修复
 
 - 优化Tooltip工具根据相对位置定位的问题
 - 增强对Cesium1.122版本的兼容
 - 修复Mapv热力图显示错误的问题
 
-###  v17.4.1 
+## v17.4.1
 
-**更新说明：**
-
-1. 功能优化
+1. 新增
 
-- 修复API文档中部分接口文档缺失的问题
 - 混合开发接口增强，支持MapGIS场景服务和S3M场景服务混合开发
 
-###  v17.4.0 
+2. 修复
 
-**更新说明：**
+- 修复API文档中部分接口文档缺失的问题
+
+## v17.4.0
 
-1. 功能新增
+1. 新增
 
 - 三维动态注记丰富避让策略设置
 - 支持S3M数据接入
 - 支持M3D2.1格式的栅格体元数据接入、配色方案设置、时态切换、透明度设置
 - 兼容Cesium1.122版本
 
-2. 功能优化
+2. 修复
 
 - 优化绘制辅助剖切面(体)显隐状态控制
 - 要素图层对接对gdbp数据的处理
 
-###  v17.2.8
+## v17.2.8
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.7
-
-**更新说明：**
+## v17.2.7
 
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.6
+## v17.2.6
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.5
-
-**更新说明：**
+## v17.2.5
 
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.4
-
-**更新说明：**
+## v17.2.4
 
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.3
+## v17.2.3
 
-**更新说明：**
+1. 新增
 
-1. 功能优化
+- 三维（Cesium）引擎中兼容高版本Cesium加载IGS服务支持设置header
 
-- 三维（Cesium）引擎修复填挖方计算接口问题
-- 三维（Cesium）引擎中兼容高版本cesium加载IGS服务支持设置header
+2. 修复
 
-###  v17.2.2
+- 三维（Cesium）引擎修复填挖方计算接口问题
 
-**更新说明：**
+## v17.2.2
 
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎修复已知问题
 
-###  v17.2.1 
+## v17.2.1
 
-**更新说明：**
-
-1. 功能优化
+1. 修复
 
 - 三维（Cesium）引擎优化命名空间结构
 - 三维（Cesium）引擎修复已知问题
 
+## v17.2.0
 
-###  v17.2.0 
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 三维（Cesium）引擎支持加载自定义裁图原点、自定义裁图方向的瓦片服务
 - 三维（Cesium）引擎实现多DEM服务聚合显示
 
-2. 功能优化
+2. 修复
 
 - 三维（Cesium）引擎优化坡向分析中的箭头效果
 
-###  v17.0.0 
-
-**更新说明：**
+## v17.0.0
 
-1. 功能新增
+1. 新增
 
 - 支持WebClient库与第三方Cesium库混合开发
 - 三维Cesium插件上支持聚合专题图
 
-2. 功能优化
+2. 修复
 
 - 提升Web端动态注记站立显示时性能Cesium引擎
 - 优化阴影分析速度
 - M3D2.0缓存加载流畅度优化
 
+## v16.8.0
 
-
-###  V16.8.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 地质体模型夸张显示（模型局部沿地心方向拉伸）
 - 模型缓存增加线框显示和轮廓显示样式
@@ -677,19 +515,15 @@ const sceneView = new SceneView({
 - 模型压平增加根据要素ID压平的功能。
 - 支持通过二次开发扩展的方式实现三维钻孔渲染、多视图漫游功能
 - Billbord支持播放动图（git图或图片序列）
-
-2. 功能优化
-
 - 支持在对数缓冲下进行可视域分析
-- 漫游功能优化
-
 
+2. 修复
 
-###  V16.6.0
+- 漫游功能优化
 
-**更新说明：**
+## v16.6.0
 
-1. 功能新增
+1. 新增
 
 - 新增三维场景碰撞检测功能
 - 新增键盘漫游功能
@@ -697,26 +531,15 @@ const sceneView = new SceneView({
 - 新增全局的请求拦截器
 - 新增水面倒影特效
 - 新增地表（半）透明时，影像图层透明度独立控制功能
-
-2. 功能优化
-
-- 卷帘增加对以下图层类型的支持：Cesium3DTilesModelCahceLayer、IGSFeatureLayer、WFSLayer、GeoJsonLayer、KML、KMZ、CZML
-
+- 卷帘增加对以下图层类型的支持：Cesium3DTilesModelCahceLayer、IGSFeatureLayer、WFSLayer、GeoJSONLayer、KML、KMZ、CZML
 - 模型编辑接口增加对 M3D、3DTiles 服务类型数据的支持
-
 - 洪水淹没分析支持水面倒影
-
 - 动态注记增加对含上下标、分式的三维标注的支持
-
 - 视频投放功能支持投放到指定的场景元素上
 
-  
-
-###  V16.4.0
+## v16.4.0
 
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 新增支持支持视频调绘功能，支持基于视频流的调绘、量算
 - M3D 模型缓存图层新增支持自定义着色器，支持白模泛光特效的实现
@@ -725,7 +548,7 @@ const sceneView = new SceneView({
 - 新增基于服务端的地图要素查询，支持空间查询、属性查询；客户端查询新增支持根据 OID 显隐图元（M3D 2.0），设置图元透明度（M3D）
 - 新增支持地图图片图层显示
 
-2. 功能优化
+2. 修复
 
 - 卷帘对比分析功能优化，支持纵向、横向常用的卷帘方式，支持矩形、小望远镜、多边形等自定义范围方式；
 - 地形剖切分析功能优化，支持纹理封边；
@@ -734,13 +557,9 @@ const sceneView = new SceneView({
 - 动态注记显示效果优化，支持在前端实时绘制矢量瓦片点要素动态注记，动态注记支持广告牌、贴地效果；支持避让；支持淡入淡出效果
 - 优化客户端可视化效果，包括专题图表达、基于 EChart 的可视化、基于 MapV 的可视化显示效果
 
+## v16.2.0
 
-
-###  V16.2.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 新增支持前端符号的二三维一体化管理
 - 新增行业标绘功能：支持基础、军事两类符号的交互式编辑，支持属性、生长、显隐、闪烁、路径、比例等动画类型，支持态势编辑、管理、推演等功能
@@ -759,44 +578,35 @@ const sceneView = new SceneView({
 - 动态剖切支持凹多边形折线
 - 支持模型凹凸纹理贴图和显示
 - 标注图层支持更丰富的注记样式：新增阴影、角度、空心、文字间距、文字轮廓、文字背景等 13 种样式
+- 路径漫游支持不同路段设置不同的速度
+- Cesium 量算工具，量算结果单位支持自定义
 
-2. 功能优化
+2. 修复
 
-- 路径漫游支持不同路段设置不同的速度
 - M3DServer、SceneServer 服务图层适配 M3D1.0 缓存数据
-- cesium 量算工具，量算结果单位支持自定义
 - M3D 效率优化
 
+## v16.0.0
 
-
-###  V16.0.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 新增瓦片错级机制
 - 长度测量，增加避让处理、单位转换等功能，支持样式配置
 - 注记图层增加控制可见性、显示文本长度等参数
 - 动画漫游新增获取模型的方法、设定点不同速度漫游场景等功能
+- 提升 MapGIS 矢量图层能力，提升 filter 查询、多区绘制、系统库设置等能力，支持设置线矢量图层的高度
 
-2. 功能优化
+2. 修复
 
-- 提升 MapGIS 矢量图层能力，提升 filter 查询、多区绘制、系统库设置等能力，支持设置线矢量图层的高度
 - 解决动画漫游设定速度和时间数组中方向向量计算问题
 - 优化地形图层、注记图层等图层定位、及显示显示
 - 优化测量，包括三角测量、贴地测量等功能
 - 优化阴影分析、动画漫游等分析功能
 - 优化多个接口，新增多个属性
 
+## v15.6.0
 
-
-###  V15.6.0
-
-**更新说明：**
-
-1. 功能新增
-
+1. 新增
 
 - 注记图层增加最大显示文本长度参数
 - 注记图层增加根据相机远近设置可见性的控制参数
@@ -805,18 +615,14 @@ const sceneView = new SceneView({
 - 新增雷达扫描后处理特效
 - 模型图层加载新增支持跳转动画
 
-2. 功能优化
+2. 修复
 
 - 解决地形剖切结果 echart 对象无法修改大小
 - 修改地形压平后为避免影响默认相机加载地形瓦片
 
+## v15.4.0
 
-
-### V15.4.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 新增 MapGIS 注记服务图层
 - 添加服务数据接口新增是否开启缓存参数
@@ -826,8 +632,9 @@ const sceneView = new SceneView({
 - 新增支持基于 indexDB 实现 M3D 2.0 数据的前端属性存储和查询功能
 - 新增支持 M3D 数据属性信息前端挂接
 - 新增支持 M3D 数据 OID 拾取
+- 新增多个三维示例
 
-2. 功能优化
+2. 修复
 
 - 优化 DrawElement 增加销毁对象方法
 - 优化使用缓存后，数据稍大交互后无法正确加载数据
@@ -838,41 +645,32 @@ const sceneView = new SceneView({
 - popup 的 visible 参数不支持 v-model
 - 解决加载 mapgis 三维地图文档服务时需要支持图层过滤
 
-3. 开发资源丰富
-
-- 新增多个三维示例
-
-
+## v15.2.0
 
-###  V15.2.0
-
-**更新说明：**
-
-1. 功能新增
+1. 新增
 
 - 实现模型压平功能,支持任意凸多边形的压平
-- 优化粒子特效：优化雨雪雾粒子效果，提升真实度；新增火焰、喷泉粒子特效、以及烟雾粒子特效
 - 提供解压 M3D 压缩数据流的功能，客户端支持将压缩的流进行高效解压，并渲染
 
-2. 性能优化
+2. 修复
 
+- 优化粒子特效：优化雨雪雾粒子效果，提升真实度；新增火焰、喷泉粒子特效、以及烟雾粒子特效
 - 海量倾斜摄影数据缓存结构优化策略升级，提高网络传输效率以及前端渲染效率
 - 加载渲染亿级 Las 格式点云数据，帧率在 15 帧以上，交互流畅；
 - 加载渲染亿级地质网格剖分结果数据，帧率在 15 帧以上，交互流畅；
 - 加载渲染千万级三角网单个地质体数据，帧率在 15 帧以上，交互流畅；
 - 加载渲染 500 平方公里以上倾斜模型，帧率在 15 帧以上，交互流畅；
-
-3. 站点维护
-
 - 示例说明文档美化
 
+## v15.0.0
 
-###  V15.0.0
-
-**更新说明：**
+1. 新增
 
 - 全面整合了 Cesium 等脚本库，代码模块化，采用最新的 JavaScript ES6 标准；
 - 提供 Cesium 开发库、示例、API，支持二三维数据可视化（含 M3D、OGC、MapGIS 地图服务、第三方地图服务等）、图形绘制、量算、模型漫游、三维查询与分析、场景特效，以及三维场景下的大数据可视化与分析等功能；
-- Cesium 示例全面优化，提供配套示例说明文档与 API；
 - 新增集成 Echarts、MapV 可视化库，支持在 Web 三维模式下实现大数据可视化、大数据分析功能；
 - 新增集成 Turf.js 客户端空间分析库，提供 Web 三维客户端空间计算能力。
+
+2. 修复
+
+- Cesium 示例全面优化，提供配套示例说明文档与 API；