-
-
Notifications
You must be signed in to change notification settings - Fork 260
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
362 changed files
with
31,571 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
{ | ||
"root": true, | ||
"parser": "@babel/eslint-parser", | ||
"parserOptions": { | ||
"sourceType": "module" | ||
}, | ||
"env": { | ||
"es6": true, | ||
"node": true, | ||
"browser": true | ||
}, | ||
"plugins": ["prettier"], | ||
"extends": ["eslint:recommended", "plugin:prettier/recommended"], | ||
"globals": { | ||
"__namespace": false, | ||
"__cmdOut":false, | ||
"echarts": false, | ||
"mapv": false, | ||
"DC": false, | ||
"Cesium": false | ||
}, | ||
"rules": { | ||
"global-require": 0, | ||
"indent": 0, | ||
"no-new": 0, | ||
"camelcase": 0, | ||
"padded-blocks": 0, | ||
"no-unused-vars": 0, | ||
"no-trailing-spaces": 0, | ||
"no-mixed-spaces-and-tabs": 0, | ||
"space-before-function-paren": [0, "always"], | ||
"no-multiple-empty-lines": 0, | ||
"no-prototype-builtins": 0, | ||
"no-loss-of-precision":0 | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node | ||
# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions | ||
|
||
name: dev | ||
|
||
on: | ||
push: | ||
branches: [gulp] | ||
pull_request: | ||
branches: [gulp] | ||
|
||
jobs: | ||
build: | ||
runs-on: ubuntu-latest | ||
|
||
strategy: | ||
matrix: | ||
node-version: [16.x] | ||
|
||
steps: | ||
- uses: actions/checkout@v2 | ||
- name: Use Node.js ${{ matrix.node-version }} | ||
uses: actions/setup-node@v1 | ||
with: | ||
node-version: ${{ matrix.node-version }} | ||
- name: Build project | ||
run: yarn && yarn build | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,222 @@ | ||
# DC-SDK | ||
|
||
<p> | ||
<img src="https://img.shields.io/github/actions/workflow/status/dvgis/dc-sdk/build.yml"/> | ||
<img src="https://img.shields.io/badge/license-Apache%202-blue"/> | ||
<a href="https://www.npmjs.com/package/@dvgis/dc-sdk" target="_blank"> | ||
<img src="https://img.shields.io/npm/v/@dvgis/dc-sdk?color=orange&logo=npm" /> | ||
</a> | ||
<a href="https://www.npmjs.com/package/@dvgis/dc-sdk" target="_blank"> | ||
<img src="https://img.shields.io/npm/dt/@dvgis/dc-sdk?logo=npm"/> | ||
</a> | ||
<a href="https://resource.dvgis.cn/dc-docs/v2.x" target="_blank"> | ||
<img src="https://img.shields.io/badge/docs-online-yellow.svg"/> | ||
</a> | ||
<a href="http://dc.dvgis.cn" target="_blank"> | ||
<img src="https://img.shields.io/badge/demo-online-red.svg"/> | ||
</a> | ||
</p> | ||
|
||
|
||
[**🇨🇳 中文**](./README_zh.md) | [**🇬🇧English**](./README.md) | ||
|
||
`DC-SDK` is based on the open source project `Cesium` for the second development of two three-dimensional `WebGis` application framework , the framework optimizes the use of `Cesium` and adds some additional features , designed for developers to quickly build `WebGis` application. | ||
|
||
```warning | ||
Tips:This SDK is JS+GIS framework package. Developers need to have some front-end technology and GIS related technology | ||
``` | ||
|
||
|
||
## Run examples | ||
|
||
```shell | ||
yarn run build | ||
yarn run server | ||
``` | ||
|
||
## Installation | ||
|
||
`NPM / YARN` **_`(Recommend)`_** | ||
|
||
Installing with NPM or YARN is recommended and it works seamlessly with webpack. | ||
|
||
```shell | ||
yarn add @dvgis/dc-sdk | ||
------------------------- | ||
npm install @dvgis/dc-sdk | ||
``` | ||
|
||
```js | ||
import DC from '@dvgis/dc-sdk/dist/dc.base.min' | ||
import DcCore from '@dvgis/dc-sdk/dist/dc.core.min' | ||
import DcChart from '@dvgis/dc-sdk/dist/dc.chart.min' | ||
import DcMapv from '@dvgis/dc-sdk/dist/dc.mapv.min' | ||
import DcS3M from '@dvgis/dc-sdk/dist/dc.s3m.min' | ||
import '@dvgis/dc-sdk/dist/dc.core.min.css' | ||
``` | ||
|
||
`NPM / YARN` **_`(On-demand)`_** | ||
|
||
```shell | ||
yarn add @dvgis/dc-base | ||
yarn add @dvgis/dc-core | ||
yarn add @dvgis/dc-chart | ||
yarn add @dvgis/dc-mapv | ||
yarn add @dvgis/dc-s3m | ||
------------------------- | ||
npm install @dvgis/dc-base | ||
npm install @dvgis/dc-core | ||
npm install @dvgis/dc-chart | ||
npm install @dvgis/dc-mapv | ||
npm install @dvgis/dc-s3m | ||
``` | ||
|
||
```js | ||
import DC from '@dvgis/dc-base' | ||
import DcCore from '@dvgis/dc-core' | ||
import DcChart from '@dvgis/dc-chart' | ||
import DcMapv from '@dvgis/dc-mapv' | ||
import DcS3M from '@dvgis/dc-s3m' | ||
import '@dvgis/dc-core/dist/dc.core.min.css' | ||
``` | ||
|
||
`CDN` | ||
|
||
[Resources](https://github.com/dvgis/dc-sdk/releases) | ||
|
||
```html | ||
<script src="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.base.min.js"></script> | ||
<script src="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.core.min.js"></script> | ||
<script src="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.chart.min.js"></script> | ||
<script src="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.mapv.min.js"></script> | ||
<script src="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.s3m.min.js"></script> | ||
<link | ||
href="https://cdn.jsdelivr.net/npm/@dvgis/dc-sdk/dist/dc.core.min.css" | ||
rel="stylesheet" | ||
type="text/css" | ||
/> | ||
``` | ||
|
||
``` | ||
Please put the resources in the project root directory libs/dc-sdk, if you put it in other directory, the framework will not run properly. | ||
``` | ||
|
||
## Configuration | ||
|
||
> The configuration is mainly used in the `NPM / YARN` way | ||
Since the `DC` framework sets `CESIUM_BASE_URL` to `./libs/dc-sdk/resources/` , you need to copy `Cesium` related static resources files: `Assets` , `Workers` , `ThirdParty `to `libs/dc-sdk/resources` directory of the project to ensure that the 3D scene can be rendered properly. You can also use `DC.baseUrl` to set the static resource base related to `Cesium` . | ||
|
||
`Webpack` | ||
|
||
[Project Template](https://github.com/cavencj/dc-vue-app) | ||
|
||
```js | ||
// webpack.config.js | ||
const path = require('path') | ||
const CopywebpackPlugin = require('copy-webpack-plugin') | ||
const dvgisDist = './node_modules/@dvgis' | ||
|
||
module.exports = { | ||
plugins: [ | ||
new CopyWebpackPlugin([ | ||
{ | ||
from: path.join(dvgisDist, 'dc-sdk/dist/resources'), | ||
to: 'libs/dc-sdk/resources', | ||
}, | ||
]), | ||
], | ||
} | ||
``` | ||
|
||
`Vue2.x` | ||
|
||
[Project Template](https://github.com/dvgis/dc-vue) | ||
|
||
```js | ||
// vue.config.js | ||
const path = require('path') | ||
const CopywebpackPlugin = require('copy-webpack-plugin') | ||
const dvgisDist = './node_modules/@dvgis' | ||
module.exports = { | ||
chainWebpack: (config) => { | ||
config.plugin('copy').use(CopywebpackPlugin, [ | ||
[ | ||
{ | ||
from: path.join(dvgisDist, 'dc-sdk/dist/resources'), | ||
to: 'libs/dc-sdk/resources', | ||
}, | ||
], | ||
]) | ||
}, | ||
} | ||
``` | ||
|
||
`Vue3.x` | ||
|
||
[Project Template](https://github.com/dvgis/dc-vue-next) | ||
|
||
```js | ||
// vue.config.js | ||
const path = require('path') | ||
const CopywebpackPlugin = require('copy-webpack-plugin') | ||
const dvgisDist = './node_modules/@dvgis' | ||
module.exports = { | ||
chainWebpack: (config) => { | ||
config.plugin('copy').use(CopywebpackPlugin, [ | ||
{ | ||
patterns: [ | ||
{ | ||
from: path.join(dvgisDist, 'dc-sdk/dist/resources'), | ||
to: path.join(__dirname, 'dist', 'libs/dc-sdk/resources'), | ||
}, | ||
], | ||
}, | ||
]) | ||
}, | ||
} | ||
``` | ||
|
||
|
||
## Start | ||
|
||
```js | ||
global.DC = DC | ||
DC.use(DcCore) // node | ||
DC.ready(() => { | ||
let viewer = new DC.Viewer(divId) // divId is the Id attribute value of a div node. If it is not passed in, the 3D scene cannot be initialized | ||
}) | ||
``` | ||
|
||
## Demo | ||
|
||
| ![picture](http://dc.dvgis.cn/examples/images/baselayer/baidu.png?v=3) | ![picture](http://dc.dvgis.cn/examples/images/baselayer/tdt.png?v=2) | ![picture](http://dc.dvgis.cn/examples/images/baselayer/arcgis.png?v=3) | ![picture](http://dc.dvgis.cn/examples/images/mini-scene/china.gif) | | ||
| :-----------------------------------------------------------: | :-----------------------------------------------------------: | :------------------------------------------------------------------: | :--------------------------------------------------------------: | | ||
| ![picture](http://dc.dvgis.cn/examples/images/mini-scene/dfmz.gif) | ![picture](http://dc.dvgis.cn/examples/images/mini-scene/factory.gif?v=1) | ![picture](http://dc.dvgis.cn/examples/images/layer/cluster_circle.gif) | ![picture](http://dc.dvgis.cn/examples/images/model/shp_custom_shader.gif) | | ||
| ![picture](http://dc.dvgis.cn/examples/images/overlay/polyline_image_trail.gif) | ![picture](http://dc.dvgis.cn/examples/images/overlay/wall_trail.gif?v=1) | ![picture](http://dc.dvgis.cn/examples/images/overlay/water.gif?v=4) | ![picture](http://dc.dvgis.cn/examples/images/overlay/plot-overlay.png?v=4) | | ||
|
||
[More>>](http://dc.dvgis.cn/#/examples) | ||
|
||
## Copyright | ||
|
||
```warning | ||
1. The framework is a basic platform, completely open source, which can be modified and reconstructed by any individual or institution without our authorization. | ||
2. We are not responsible for any problems arising from the modification of the framework by individuals and organizations. | ||
3. Some industrial plug-ins and tools will be added in the later stage, and the code will be open source appropriately. | ||
4. The package released by us may be used permanently and free of charge by any person or organization subject to: | ||
1) complete package reference; | ||
2) reserve this copyright information in the console output | ||
We reserve the right of final interpretation of this copyright information. | ||
``` | ||
|
||
## Support | ||
|
||
> if dc-sdk can bring benefits to you, please support it ~ | ||
<p> | ||
<a href="https://www.paypal.com/paypalme/cavencj" target="_blank"> | ||
<img src="https://www.paypalobjects.com/images/shared/paypal-logo-129x32.svg" style="margin-top:10px" /> | ||
</a> | ||
</p> | ||
|
||
## Thanks |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
<!DOCTYPE html> | ||
<html lang=""> | ||
<head> | ||
<meta charset="utf-8"> | ||
<meta http-equiv="X-UA-Compatible" content="IE=edge"> | ||
<meta name="viewport" content="width=device-width,initial-scale=1.0"> | ||
<title>demo</title> | ||
<script src='/libs/dc-sdk/dc.min.js'></script> | ||
<link href='/libs/dc-sdk/dc.min.css' type='text/css' rel='stylesheet'> | ||
<style> | ||
*{ | ||
padding: 0; | ||
margin: 0; | ||
} | ||
html,body,#map-container{ | ||
width: 100%; | ||
height: 100%; | ||
overflow: hidden; | ||
} | ||
</style> | ||
</head> | ||
<body> | ||
<div id="map-container"> | ||
</div> | ||
</body> | ||
<script> | ||
DC.ready().then(()=>{ | ||
new DC.Viewer('map-container') | ||
}) | ||
</script> |
Oops, something went wrong.