sat-earth 0.0.2-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 @沉淀
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,79 @@
+## What is SatEarth?
+  [SatEarth](https://gitee.com/gengkaibo/sat-earth)是延续了 [vite2-vue3-ts-quick-start](https://gitee.com/gengkaibo/vite2-vue3-ts-quick-start) 底层技术，基于 [航天星云](https://www.satcloud.com.cn/#/index) · 数字地球技术中台的功能及UI风格以及 [mars3d](http://mars3d.cn/) 和 [cesium](https://cesium.com/) 的底层API，实现的一个开源三维地球组件库，目的是支持开发人员快速搭建三维场景，目前尚在搭建中，后续会封装符合扩展性、通用性、健壮性的组件，以及完善guide文档。
+
+  实景三维中国建设是落实数字中国、智慧中国、数字经济战略的重要举措，是落实国家新型基础设施建设的具体部署，是服务生态文明建设和经济社会发展的基础支撑。当前我国实景三维市场呈现出飞速发展的态势，预计至2025年，我国实景三维市场规模累计可达到260亿至500亿若叠加相关延伸业务，则市场空间更加广阔。随着实景三维中国建设由试点向全国拓展，航天海鹰第一时间发布了《航天科工实景三维中国白皮书》与《实景三维中国建设航天方案》等材料，研发了基于数字地球平台体系的“实景三维应用服务”系统，支撑实景三维中国工程建设。
+
+  航天星云数字地球平台综合利用时空大数据存储技术构建数据中台，封装工具和业务组件构建技术中台，优化训练各类城市信息模型构建AI智能识别中台，汇聚综合解决方案建设应用中台，打通数据、工具、组件、应用场景、解决方案的全链路数字孪生大中台架构，统筹空间载体、物联感知数据、支撑环境，为实景三维中国建设提供有力支撑。
+- 具备海量多源数据展示场景，面向用户提供基础地图、行业专题、其他专题的综合展示与个性化定制服务。打造“天空地一体化、二三维一体化、地上地下一体化、室内室外一体化、离线在线一体化”等多源高自由度应用形式。
+- 支持卫星数据库加载、卫星轨道仿真、高空气象图层接入、低空无人机禁飞区加载等天基资源综合一体化场景配置服务，为用户打造商业用天新势力，助力实景三维智能泛在。
+- 在高精度影像底图基础上叠加倾斜摄影、人工建模、BIM模型、城市白膜等4大类，10小类三维场景，并支持用户自动定制三维场景的渲染方式，拉升城市维度。
+- 将北斗监测设备、农业智慧杆、卫星地面站接入系统，以二三维实景地球为基础，打通实时数据交互链路，为三维感知赋能。内嵌了天地图、高德、腾讯、百度在内的十余种几十类在线地图切换展示功能，并且支持用户触发实景地图，联通遥感影像与三维实景，感受二三维场景动态互联。
+- 背靠多年技术与项目沉淀，面向自然资源、城市、农业、交通、应急、环保、水利、林业、审计、安监等十余个行业，提供58类专题解决方案，助力实景三维业务化落地;为各类三维场景，编译了包含量测、出图、数据转换、空间分析、地形分析在内的多种工具，为用户提供实景三维“空间量尺”。
+- 面向三维场景，提供空间标绘、空间灾害仿真救援、空间大地智能信息提取等核心功能，真正实现以需求为牵引、以创新为驱动、统一设计、多源投入、协同实施、边建边用的技术方针，促进实景三维业务在城市化进程中快速落地。
+
+## 尝鲜
+- 首先在命令行执行如下命令添加 `sat-earth` 的依赖
+```bash
+npm i sat-earth
+```
+
+- 将 `node_modules/mars3d-cesium/Build/Cesium` 目录拷贝到我们开发目录中的public下
+然后在index.html中引入 `cesium` 库
+```html
+<!--引入cesium基础lib-->
+<link href="/Cesium/Widgets/widgets.css" rel="stylesheet" type="text/css" />
+<script src="/Cesium/Cesium.js" type="text/javascript"></script>
+```
+
+- 在 `main.[jt]s` 中全量引入我们的 `sat-earth` 资源
+```ts
+import { createApp } from "vue"
+import App from "./app.vue"
+import satEarth from 'sat-earth'
+import 'sat-earth/dist/style.css'
+const app = createApp(App)
+
+app.use(satEarth)
+app.mount("#app")
+
+```
+或者按需加载
+```ts
+import { createApp } from "vue"
+import App from "./app.vue"
+import { SatGlobe } from 'sat-earth'
+import 'sat-earth/dist/style.css'
+const app = createApp(App)
+
+app.use(SatGlobe)
+app.mount("#app")
+
+```
+
+- 开始使用，调用组件化`<SatGlobe></SatGlobe>`，或者调用 `satEarth` 暴露的方法
+
+## 如何贡献
+你可以[提一个 issue](https://gitee.com/gengkaibo/sat-earth/issues) 或者提交一个 Pull Request。
+
+#### Pull Request
+
+1. Fork 代码!
+2. 创建自己的分支: `git checkout -b feat/xxxx`
+3. 提交你的修改: `git commit -am 'feat(function): add xxxxx'`
+4. 推送您的分支: `git push origin feat/xxxx`
+5. 提交`pull request`
+
+#### Git 贡献提交规范，参考 [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) 规范
+  - `feat` 增加新功能
+  - `fix` 修复问题/BUG
+  - `style` 代码风格相关无影响运行结果的
+  - `perf` 优化/性能提升
+  - `refactor` 重构
+  - `polish` 修改
+  - `revert` 撤销修改
+  - `test` 测试相关
+  - `docs` 文档/注释
+  - `chore` 依赖更新/脚手架配置修改等
+  - `workflow` 工作流改进
+  - `ci` 持续集成
+  - `types` 类型定义文件更改