mars3d 3.11.10 → 3.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +60 -100
  2. package/mars3d.css +2 -2
  3. package/mars3d.d.ts +25 -3
  4. package/mars3d.js +3 -3
  5. package/package.json +1 -1
package/README.md CHANGED
@@ -1,9 +1,10 @@
1
-
1
+ # Mars3D 三维地球客户端开发平台
2
+
2
3
  <p align="center">
3
4
  <img src="http://mars3d.cn/logo.png" width="200px" />
4
5
  </p>
5
6
 
6
- <p align="center">🌎 一款基于WebGL技术实现的三维地球客户端开发平台</p>
7
+ <p align="center">🌎 一款基于 WebGL 技术实现的三维地球客户端开发平台</p>
7
8
 
8
9
  <p align="center">
9
10
  <a target="_black" href="https://www.npmjs.com/package/mars3d">
@@ -20,129 +21,88 @@
20
21
  </a>
21
22
  </p>
22
23
 
23
-
24
-
25
- 当前仓库包含SDK更新日志、和其他仓库导航。
26
-
27
- Github：[https://github.com/marsgis/mars3d](https://github.com/marsgis/mars3d)
28
-
29
- 国内Gitee：[https://gitee.com/marsgis/mars3d](https://gitee.com/marsgis/mars3d)
30
-
31
- 更新日志: [CHANGE.md](./CHANGE.md)
32
-
33
-
24
+ [**English**](./README_EN.md) | [**中文**](./README.md)
34
25
 
35
26
  ## 平台介绍
36
-
37
- `Mars3D平台` 是一款基于 WebGL 技术实现的三维客户端开发平台，基于[Cesium](https://cesium.com/cesiumjs/)优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。
38
-
39
-
40
-
41
- ## 学习资料
42
-
43
- - Mars3D官网：[http://mars3d.cn](http://mars3d.cn)
44
- - 开发教程：[http://mars3d.cn/docs/](http://mars3d.cn/docs/)
45
- - API文档：[http://mars3d.cn/api/](http://mars3d.cn/api/)
46
-
47
-
48
- ### 反馈问题
49
- 为了方便交流及留存，所有bug及建议均统一提交至：[github issues](https://github.com/marsgis/mars3d/issues) 或
50
- [国内gitee issues](https://gitee.com/marsgis/mars3d/issues)
51
-
52
-
53
-
54
-
55
-
56
- ## 功能示例
57
- 对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。
58
-
59
- | 说明 | 教程 | 视频 |Github源码 | 国内Gitee源码 |
60
- | ----|---- | ---- | ----| ---- |
61
- |Vue版 |[查看](http://mars3d.cn/docs/guide/example-vue/) |[查看](https://www.bilibili.com/video/BV1PL41177SS/)、[高级篇](https://www.bilibili.com/video/BV1Xv4y1a74P/)| [mars3d-vue-example](https://github.com/marsgis/mars3d-vue-example) |[mars3d-vue-example](https://gitee.com/marsgis/mars3d-vue-example) |
62
- |原生JS版 | [查看](http://mars3d.cn/docs/guide/example-es5/) | [查看](https://www.bilibili.com/video/BV1Hg411o7Js/) | [mars3d-es5-example](https://github.com/marsgis/mars3d-es5-example) |[mars3d-es5-example](https://gitee.com/marsgis/mars3d-es5-example) |
63
- |React版 |[查看](http://mars3d.cn/docs/guide/example-react/)|[查看](https://www.bilibili.com/video/BV1xY4y1t7NR/)、[高级篇](https://www.bilibili.com/video/BV1tX4y1Q7v7/) | [mars3d-react-example](https://github.com/marsgis/mars3d-react-example) |[mars3d-react-example](https://gitee.com/marsgis/mars3d-react-example) |
64
-
65
-
66
- ## 最简项目模板
67
- 提供了面向不同技术栈的最简项目模板，您可以直接使用或参考这些项目模板，了解SDK类库在不同技术栈项目中如何引入使用，快速搭建开发自己的项目。
68
-
69
- | 说明 | 视频 | Github源码 | 国内Gitee源码 |
70
- | ----| ----|----| ---- |
71
- |Vue技术栈 |[查看](https://www.bilibili.com/video/BV17P4y1F7gv/)| [mars3d-vue-template](https://github.com/marsgis/mars3d-vue-template) |[mars3d-vue-template](https://gitee.com/marsgis/mars3d-vue-template) |
72
- |原生JS技术栈 |[查看](https://www.bilibili.com/video/BV1za41177ZW/)| [mars3d-es5-template](https://github.com/marsgis/mars3d-es5-template) |[mars3d-es5-template](https://gitee.com/marsgis/mars3d-es5-template) |
73
- |React技术栈 |[查看](https://www.bilibili.com/video/BV1nZ4y1b7W7/)| [mars3d-react-template](https://github.com/marsgis/mars3d-react-template) |[mars3d-react-template](https://gitee.com/marsgis/mars3d-react-template) |
74
- |Angular技术栈 |[查看](https://www.bilibili.com/video/BV13Y411K7xs/) | [mars3d-angular-template](https://github.com/marsgis/mars3d-angular-template) |[mars3d-angular-template](https://gitee.com/marsgis/mars3d-angular-template) |
75
- |CS桌面端程序 |[查看](https://www.bilibili.com/video/BV1N94y1R7ds/)| [mars3d-electron](https://github.com/marsgis/mars3d-electron) |[mars3d-electron](https://gitee.com/marsgis/mars3d-electron) |
76
- |uni-app移动端程序 |[查看](https://www.bilibili.com/video/BV18F41157qR/)|[mars3d-uni-app](https://github.com/marsgis/mars3d-uni-app) |[mars3d-uni-app](https://gitee.com/marsgis/mars3d-uni-app) |
77
-
78
-
79
-
80
- ## 通用项目模版
81
- 通用项目模版是具备一个GIS项目常见功能的项目模板，只用更换数据及叠加业务即可完成项目交付。
82
- 如果需要更多功能可以考虑购买[付费项目模板](http://mars3d.cn/buy.html?product=template)。
83
-
84
- |说明 |教程 |视频 | Github源码 | 国内Gitee源码 |
85
- |----|---- |---- | ----| ---- |
86
- |Vue通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-vue/) |[查看](https://www.bilibili.com/video/BV1JF411q7Ut/)、[高级篇](https://www.bilibili.com/video/BV1rM411j78s/) | [mars3d-vue-project](https://github.com/marsgis/mars3d-vue-project) |[mars3d-vue-project](https://gitee.com/marsgis/mars3d-vue-project) |
87
- | 原生JS通用项目模版 |[查看](http://mars3d.cn/docs/guide/project-es5/) | [查看](https://www.bilibili.com/video/BV1nF41157Rn/)| [mars3d-es5-project](https://github.com/marsgis/mars3d-es5-project) |[mars3d-es5-project](https://gitee.com/marsgis/mars3d-es5-project) |
88
- |React通用项目模版|[查看](http://mars3d.cn/docs/guide/project-react/) |[查看](https://www.bilibili.com/video/BV1n3411u7Dm/)、[高级篇](https://www.bilibili.com/video/BV1d84y1E7gR/) | [mars3d-react-project](https://github.com/marsgis/mars3d-react-project) |[mars3d-react-project](https://gitee.com/marsgis/mars3d-react-project) |
89
- |APP项目模版(Vue3+H5)| [查看](http://mars3d.cn/docs/guide/project-app/) | [查看](https://www.bilibili.com/video/BV1iY4y1t7jk/)、[高级篇](https://www.bilibili.com/video/BV1CD4y137jK/) | [mars3d-vue-app](https://github.com/marsgis/mars3d-vue-app) |[mars3d-vue-app](https://gitee.com/marsgis/mars3d-vue-app) |
90
-
91
27
 
28
+ Mars3D 是一款基于 WebGL 技术实现的三维地球客户端开发平台，基于 [Cesium](https://cesium.com/cesiumjs/) 优化提升与 B/S 架构设计，支持多行业扩展的轻量级高效能 GIS 开发平台。能够免安装、无插件地在浏览器中高效运行，快速接入多种 GIS 数据与三维模型，完成三维空间可视化与行业应用。
92
29
 
30
+ - 官网：[http://mars3d.cn](http://mars3d.cn)
31
+ - 开发教程：[http://mars3d.cn/docs/](http://mars3d.cn/docs/)
32
+ - API 文档：[http://mars3d.cn/api/](http://mars3d.cn/api/)
33
+ - 更新日志：[CHANGE.md](./CHANGE.md)
34
+ - 问题反馈：[GitHub Issues](https://github.com/marsgis/mars3d/issues) ｜ [Gitee Issues](https://gitee.com/marsgis/mars3d/issues)
93
35
 
94
36
 
95
-
96
37
 
97
-
38
+ ## 示例、模板与项目导航
98
39
 
99
- ## 平台相关效果
100
- 功能示例：
101
- ![image](http://marsgis.cn/img/project/mars3d-doc/example1.jpg)
102
-
103
- 通用项目-Vue版：[在线体验](http://mars3d.cn/project/vue/)
104
-
105
- ![image](https://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-project/1.jpg)
106
-
107
- 通用项目-原生JS版：[在线体验](http://mars3d.cn/project/es5/)
40
+ ### 功能示例
108
41
 
109
- ![image](https://cdn.marsgis.cn/mars3d-product/template/mars3d-es5-project/1.jpg)
42
+ 对平台每个功能编写的案例代码，可以阅读每个示例代码来学习各功能，与官网功能示例一致效果。
110
43
 
111
- 通用项目-React版：[在线体验](http://mars3d.cn/project/react/)
44
+ | 说明 | 教程 | 视频 | Github 源码 | 国内 Gitee 源码 |
45
+ |---|---|---|---|---|
46
+ | Vue 版 | [查看](http://mars3d.cn/docs/guide/example-vue/) | [查看](https://www.bilibili.com/video/BV1PL41177SS/)、[高级篇](https://www.bilibili.com/video/BV1Xv4y1a74P/) | [mars3d-vue-example](https://github.com/marsgis/mars3d-vue-example) | [mars3d-vue-example](https://gitee.com/marsgis/mars3d-vue-example) |
47
+ | 原生 JS 版 | [查看](http://mars3d.cn/docs/guide/example-es5/) | [查看](https://www.bilibili.com/video/BV1Hg411o7Js/) | [mars3d-es5-example](https://github.com/marsgis/mars3d-es5-example) | [mars3d-es5-example](https://gitee.com/marsgis/mars3d-es5-example) |
48
+ | React 版 | [查看](http://mars3d.cn/docs/guide/example-react/) | [查看](https://www.bilibili.com/video/BV1xY4y1t7NR/)、[高级篇](https://www.bilibili.com/video/BV1tX4y1Q7v7/) | [mars3d-react-example](https://github.com/marsgis/mars3d-react-example) | [mars3d-react-example](https://gitee.com/marsgis/mars3d-react-example) |
112
49
 
113
- ![image](https://cdn.marsgis.cn/mars3d-product/template/mars3d-react-project/1.jpg)
50
+ ### 最简项目模板
114
51
 
115
- 三维地球-APP版：[在线体验](http://mars3d.cn/project/app/)
52
+ 提供 Vue、原生 JS、React、Angular、Electron、uni-app 等技术栈的最简项目模板，已统一维护在一个仓库：
116
53
 
117
- ![image](http://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-app/1.jpg)
54
+ - Github：[mars3d-templates](https://github.com/marsgis/mars3d-templates)
55
+ - Gitee：[mars3d-templates](https://gitee.com/marsgis/mars3d-templates)
118
56
 
57
+ 可直接使用或参考这些模板，快速了解 SDK 在不同技术栈项目中如何引入。
119
58
 
120
- 工厂园区项目：[在线体验](http://mars3d.cn/project/vue-gcyq/)
121
59
 
122
- ![image](http://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-gcyq/1.jpg)
60
+ ### 通用项目模板
123
61
 
124
- 美丽乡村项目：[在线体验](http://mars3d.cn/project/vue-mlxc/)
62
+ 通用项目模板具备一个 GIS 项目常见功能，只需更换数据及叠加业务即可完成项目交付。更多功能可考虑[付费项目模板](http://mars3d.cn/buy.html?product=template)。
125
63
 
126
- ![image](https://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-mlxc/1.jpg)
127
-
128
-
129
- 图层配置工具：[在线体验](http://studio.mars3d.cn/project-map/offline-layer.html)
64
+ | 说明 | 教程 | 视频 | Github 源码 | 国内 Gitee 源码 |
65
+ |---|---|---|---|---|
66
+ | Vue 通用项目模板 | [查看](http://mars3d.cn/docs/guide/project-vue/) | [查看](https://www.bilibili.com/video/BV1JF411q7Ut/)、[高级篇](https://www.bilibili.com/video/BV1rM411j78s/) | [mars3d-vue-project](https://github.com/marsgis/mars3d-vue-project) | [mars3d-vue-project](https://gitee.com/marsgis/mars3d-vue-project) |
67
+ | 原生 JS 通用项目模板 | [查看](http://mars3d.cn/docs/guide/project-es5/) | [查看](https://www.bilibili.com/video/BV1nF41157Rn/) | [mars3d-es5-project](https://github.com/marsgis/mars3d-es5-project) | [mars3d-es5-project](https://gitee.com/marsgis/mars3d-es5-project) |
68
+ | React 通用项目模板 | [查看](http://mars3d.cn/docs/guide/project-react/) | [查看](https://www.bilibili.com/video/BV1n3411u7Dm/)、[高级篇](https://www.bilibili.com/video/BV1d84y1E7gR/) | [mars3d-react-project](https://github.com/marsgis/mars3d-react-project) | [mars3d-react-project](https://gitee.com/marsgis/mars3d-react-project) |
69
+ | APP 项目模板（Vue3+H5） | [查看](http://mars3d.cn/docs/guide/project-app/) | [查看](https://www.bilibili.com/video/BV1iY4y1t7jk/)、[高级篇](https://www.bilibili.com/video/BV1CD4y137jK/) | [mars3d-vue-app](https://github.com/marsgis/mars3d-vue-app) | [mars3d-vue-app](https://gitee.com/marsgis/mars3d-vue-app) |
130
70
 
131
- ![image](http://cdn.marsgis.cn/mars3d-product/template/mars3d-studio-layer/1.jpg)
71
+ ### 在线效果
132
72
 
133
-
134
- 图上标绘工具：[在线体验](http://studio.mars3d.cn/project-map/offline-plot.html)
73
+ | 项目 | 在线体验 | 截图 |
74
+ |---|---|---|
75
+ | 功能示例 | [查看](http://mars3d.cn/example) | ![示例](http://marsgis.cn/img/project/mars3d-doc/example1.jpg) |
76
+ | 通用项目 Vue 版 | [查看](http://mars3d.cn/project/vue/) | ![Vue](https://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-project/1.jpg) |
77
+ | 通用项目原生 JS 版 | [查看](http://mars3d.cn/project/es5/) | ![es5](https://cdn.marsgis.cn/mars3d-product/template/mars3d-es5-project/1.jpg) |
78
+ | 通用项目 React 版 | [查看](http://mars3d.cn/project/react/) | ![React](https://cdn.marsgis.cn/mars3d-product/template/mars3d-react-project/1.jpg) |
79
+ | 三维地球 APP 版 | [查看](http://mars3d.cn/project/app/) | ![APP](http://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-app/1.jpg) |
80
+ | 工厂园区项目 | [查看](http://mars3d.cn/project/vue-gcyq/) | ![园区](https://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-gcyq/1.jpg) |
81
+ | 美丽乡村项目 | [查看](http://mars3d.cn/project/vue-mlxc/) | ![乡村](https://cdn.marsgis.cn/mars3d-product/template/mars3d-vue-mlxc/1.jpg) |
135
82
 
136
- ![image](http://cdn.marsgis.cn/mars3d-product/template/mars3d-studio-plot/1.jpg)
83
+ ### 在线工具
137
84
 
85
+ | 工具 | 地址 |
86
+ |---|---|
87
+ | 图层配置工具 | [studio.mars3d.cn](http://studio.mars3d.cn/project-map/offline-layer.html) |
88
+ | 图上标绘工具 | [studio.mars3d.cn](http://studio.mars3d.cn/project-map/offline-plot.html) |
89
+ | 地图场景配置工具 | [studio.mars3d.cn](http://studio.mars3d.cn/project-map/offline-map.html) |
138
90
 
139
- 地图场景配置工具：[在线体验](http://studio.mars3d.cn/project-map/offline-map.html)
91
+ ## 授权协议
140
92
 
141
- ![image](http://cdn.marsgis.cn/mars3d-product/template/mars3d-studio-map/1.jpg)
93
+ Mars3D SDK 采用 **“社区免费版 + 商业授权版”** 双重授权。
142
94
 
95
+ [![License](https://img.shields.io/badge/license-Apache--2.0%20%2B%20Mars3D%20Additional%20Terms-blue)](./LICENSE)
143
96
 
97
+ - **社区免费版**：基于 **Apache License 2.0**，并附加《Mars3D 免费版附加条款》。可免费用于学习、开发与商业项目，但**必须保留**软件运行时页面周边的 **Mars3D Logo** 和浏览器 **F12 控制台**输出的版权信息，**不得移除、遮挡、修改或通过任何技术手段规避**。
98
+ - **商业授权版**：付费后可**去除页面 Logo**，F12 控制台信息替换为贵单位/项目名称，并提供盖章授权文件、专属技术支持与缺陷修复服务；**不限制项目数、节点数、用户数和使用期限**，按 SDK 大版本授权。
144
99
 
145
- ## 版权说明
146
- 1. Mars3D平台由[mars3d团队](http://mars3d.cn/)自主研发，拥有所有权利。
147
- 2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。
100
+ | | 社区免费版 | 商业授权版 |
101
+ | --- | --- | --- |
102
+ | 页面 Logo | ✅ 必须保留 | ❌ 已移除 |
103
+ | F12 控制台信息 | 通用版权信息（须保留） | 显示贵单位名称 |
104
+ | 授权费用 | 免费 | 按大版本一次性付费 |
105
+ | 数量 / 期限限制 | 无 | 无 |
106
+ | 商业交付 / 招投标 | 须保留署名 | 提供盖章授权，合规无忧 |
148
107
 
108
+ 📘 完整协议：[`LICENSE`](./LICENSE) ｜ [购买授权](http://mars3d.cn/buy.html)
package/mars3d.css CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Mars3D三维可视化平台 mars3d 免费公开版
3
- * 版本信息：v3.11.10
4
- * 编译日期：2026-11-01 20:35 ZX
3
+ * 版本信息：v3.12.0
4
+ * 编译日期：2026-11-01 21:41 ZX
5
5
  * 版权所有：Copyright by http://mars3d.cn
6
6
  *
7
7
  * Apache-2.0 WITH Mars3D Additional Terms | https://mars3d.cn
package/mars3d.d.ts CHANGED
@@ -1,8 +1,8 @@
1
1
 
2
2
  /**
3
3
  * Mars3D三维可视化平台 mars3d 免费公开版
4
- * 版本信息：v3.11.10
5
- * 编译日期：2026-11-01 20:35 ZX
4
+ * 版本信息：v3.12.0
5
+ * 编译日期：2026-11-01 21:41 ZX
6
6
  * 版权所有：Copyright by http://mars3d.cn
7
7
  *
8
8
  * Apache-2.0 WITH Mars3D Additional Terms | https://mars3d.cn
@@ -9795,6 +9795,12 @@ declare class DivGraphic extends BaseGraphic {
9795
9795
  * 中心点坐标（笛卡尔坐标）
9796
9796
  */
9797
9797
  readonly center: Cesium.Cartesian3 | Cesium.SampledPositionProperty;
9798
+ /**
9799
+ * 对象添加到图层前创建一些对象的钩子方法，
9800
+ * 只会调用一次
9801
+ * @returns 无
9802
+ */
9803
+ _mountedHook(): void;
9798
9804
  }
9799
9805
 
9800
9806
  declare namespace DivLightPoint {
@@ -10029,6 +10035,12 @@ declare class DivPlane extends DivGraphic {
10029
10035
  * 父容器DOM对象
10030
10036
  */
10031
10037
  readonly parentContainer: HTMLElement;
10038
+ /**
10039
+ * 对象添加到图层前创建一些对象的钩子方法，
10040
+ * 只会调用一次
10041
+ * @returns 无
10042
+ */
10043
+ _mountedHook(): void;
10032
10044
  }
10033
10045
 
10034
10046
  declare namespace DivUpLabel {
@@ -30883,6 +30895,14 @@ declare class MouseEvent {
30883
30895
  * @returns 无
30884
30896
  */
30885
30897
  clearMoveTargetDelay(): void;
30898
+ /**
30899
+ * 获取 屏幕XY坐标 对应的 笛卡尔三维坐标
30900
+ * @param position - 屏幕坐标
30901
+ * @param [pickedObject] - 已拾取到的对象，传入后不再重复 scene.pick
30902
+ * @param [skipPick = false] - 调用方已完成拾取时跳过内部 scene.pick（每次 pick 都是一次渲染+回读）
30903
+ * @returns 坐标
30904
+ */
30905
+ getCurrentMousePosition(position: Cesium.Cartesian2, pickedObject?: any, skipPick?: boolean): Cesium.Cartesian3 | undefined | null;
30886
30906
  /**
30887
30907
  * 获取拾取到的Cesium选中对象
30888
30908
  * @param event - 单击或鼠标移入事件对象
@@ -31820,9 +31840,11 @@ declare class Map extends BaseClass {
31820
31840
  /**
31821
31841
  * 获取 屏幕XY坐标 对应的 笛卡尔三维坐标
31822
31842
  * @param position - 屏幕XY坐标（如鼠标所在位置)
31843
+ * @param [pickedObject] - 已拾取到的对象，传入后不再重复 scene.pick
31844
+ * @param [skipPick = false] - 调用方已完成拾取时跳过内部 scene.pick（避免又一次拾取渲染+回读）
31823
31845
  * @returns 笛卡尔三维坐标
31824
31846
  */
31825
- getCurrentMousePosition(position: Cesium.Cartesian2): Cesium.Cartesian3;
31847
+ getCurrentMousePosition(position: Cesium.Cartesian2, pickedObject?: any, skipPick?: boolean): Cesium.Cartesian3;
31826
31848
  /**
31827
31849
  * 取地图屏幕中心点坐标
31828
31850
  * @param [toCartesian] - 返回Cesium.Cartesian3格式坐标