OpenSource
/
dc-sdk
spogulis no https://github.com/dvt3d/dc-sdk
Vērot 4
Pievienot zvaigznīti 0
Atdalīts 0
Kods Problēmas 0 Laidieni 92 Vikivietne Aktivitāte
Pārlūkot izejas kodu

add docs

tags/3.0.0
Caven Chen pirms 2 gadiem
vecāks
03bf5537bd
revīzija
1a049b5505
10 mainītis faili ar 192 papildinājumiem un 1562 dzēšanām
Dalītais skats Rādīt salīdzināšanas statistiku
  1. 0
    4
      docs/.vuepress/config.yml
  2. 0
    478
      docs/analysis/README.md
  3. 28
    11
      docs/layer/README.md
  4. 0
    190
      docs/third-part/README.md
  5. 16
    16
      docs/tile/README.md
  6. 44
    59
      docs/tools/README.md
  7. 0
    538
      docs/zh/analysis/README.md
  8. 49
    0
      docs/zh/layer/README.md
  9. 0
    201
      docs/zh/third-part/README.md
  10. 55
    65
      docs/zh/tools/README.md

+ 0
- 4
docs/.vuepress/config.yml Parādīt failu

@@ -29,8 +29,6 @@ themeConfig: {
{ text: 'Materials', link: '/material/' },
{ text: 'Effects', link: '/effect/' },
{ text: 'Tools', link: '/tools/' },
{ text: 'Analysis', link: '/analysis/' },
{ text: 'ThirdPart', link: '/third-part/' },
],
},
{
@@ -83,8 +81,6 @@ themeConfig: {
{ text: '材质属性', link: '/zh/material/' },
{ text: '效果动画', link: '/zh/effect/' },
{ text: '实用工具', link: '/zh/tools/' },
{ text: '场景分析', link: '/zh/analysis/' },
{ text: '第三方集成', link: '/zh/third-part/' },
],
},
{

+ 0
- 478
docs/analysis/README.md Parādīt failu

@@ -1,478 +0,0 @@
---
sidebar: auto
---

# Analysis 🌎

## DC.Measure

> viewer measure

### example

```js
viewer.use(new DC.Measure())
```

### creation

- **_constructor()_**

- returns `measure`

### methods

- **_angle([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_area([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_areaSurface([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_distance([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_distanceSurface([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_heading([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_height([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_triangleHeight([options])_**

- parameters
- `{Object} options`
- returns `this`

- **_activate(type,[options])_**

- parameters
- `{String} type`
- `{Object} options`
- returns `this`

```json
// options(optional)
{
"icon_center": "**.png",
"icon_anchor": "**.png",
"icon_midAnchor": "**.png",
"icon_size": [12, 12],
"clampToModel": false
}
```

- **_deactivate()_**

- returns `this`

## DC.Analysis

> Viewer analysis

### example

```js
viewer.use(new DC.Analysis())
```

### creation

- **_constructor()_**

- returns `analysis`

### methods

- **_contourLine(lineColor, lineWidth, lineSpacing)_**

Contour Line Analysis

- parameters
- `{Color} lineColor`
- `{Number} lineWidth`
- `{Number} lineSpacing`
- returns `this`

- **_shadows(startTime, multiplier)_**

Daylight Analysis

- parameters
- `{Date} startTime`
- `{Number} multiplier`
- returns `this`

- **_sightLine(startPosition, endPosition, excludes, lerpNum)_**

Through-view analysis (line)

- parameters
- `{Position|Array|String|Object} startPosition`
- `{Position|Array|String|Object} endPosition`
- `{Array<Overlay>} excludes`
- `{Number} lerpNum`: Number of Interpolation, default: 10, the larger the number the more accurate, and at the same time the amount of calculation will increase
- returns `this`

- **_sightCircle(center, radius, excludes, lerpNum)_**

Through-view analysis (circle)

- parameters
- `{Position|Array|String|Object} center`
- `{Number} radius`
- `{Array<Overlay>} excludes`
- `{Number} lerpNum`: Number of Interpolation, default: 10, the larger the number the more accurate, and at the same time the amount of calculation will increase
- returns `this`

- **_viewshed(position, radius, fov, aspectRatio, options)_**

View-Shed Analysis

- parameters
- `{Position|Array|String|Object} position`
- `{Number} radius`
- `{Number} fov`
- `{Number} aspectRatio`
- `{Object} options`
- returns `this`

```json
//options(optional)
{
"mixNum":1,
"visibleColor"：DC.Color.GREEN,
"disVisibleColor"：DC.Color.RED,
"showHelp": false,
"gridColor": DC.Color.YELLOW,
"lineColor": DC.Color.YELLOW.withAlpha(0.3)
}
```

- **_deactivate([type])_**

- parameters
- `{String} type`：Refer to `DC.AnalysisType`. When the type is empty, all analyses will be deactivated
- returns `this`

## DC.CameraVideoLayer

> Inherited from [Layer](../layer/#layer)

### example

```js
let layer = new DC.CameraVideoLayer('id')
viewer.addLayer(layer)
```

### creation

- **_constructor(id)_**

- parameters
- `{String} id`
- returns `videoLayer`

### methods

- **_showHelp(show, videoOverlay, color)_**

- parameters
- `{Boolean} show`
- `{Overlay} videoOverlay`
- `{Color} color`
- returns `this`

## DC.CameraVideo

> Inherited from [Overlay](../overlay/#overlay)

### example

```js
let position = new DC.Position(120, 20, 200, -20, 19)
let videoEl = new document.getElementById('video')
let cameraVideo = new DC.CameraVideo(position, videoEl)
layer.addOverlay(cameraVideo)
```

### creation

- **_constructor(position, video,[maskUrl])_**

- parameters
- `{Position} position`
- `{Element} video`
- `{String} [maskUrl]`
- returns `cameraVideo`

### properties

- `{Position} position`
- `{Element} video`
- `{String} maskUrl`

### methods

- **_setStyle(style)_**

- parameters
- `{Object} style`
- returns `this`

```json
// style(optional)
{
"fov": 60,
"near": 1,
"far": 5000,
"aspectRatio": 1,
"alpha": 1,
"clearBlack": true,
"disViewColor": DC.Color.WHITE
}
```

## DC.PlaneVideoLayer

> Inherited from [Layer](../layer/#layer)

### example

```js
let layer = new DC.PlaneVideoLayer('id')
viewer.addLayer(layer)
```

### creation

- **_constructor(id)_**

- parameters
- `{String} id`
- returns `videoLayer`

### methods

- **_showHelp(show, videoOverlay, color)_**

- parameters
- `{Boolean} show`
- `{Overlay} videoOverlay`
- `{Color} color`
- returns `this`

## DC.PlaneVideo

> Inherited from [Overlay](../overlay/#overlay)

### example

```js
let position = new DC.Position(120, 20, 200, -20, 19)
let videoEl = new document.getElementById('video')
let cameraVideo = new DC.PlaneVideo(position, videoEl)
layer.addOverlay(cameraVideo)
```

### creation

- **_constructor(position, video)_**

- parameters
- `{Position} position`
- `{Element} video`
- returns `cameraVideo`

### properties

- `{Position} position`
- `{Element} video`

### methods

- **_setStyle(style)_**

- parameters
- `{Object} style`
- returns `this`

```json
// style(optional)
{
"fov": 60,
"near": 1,
"far": 5000,
"aspectRatio": 1
}
```

## DC.GeoTools

> Geometry Tool

### example

```js
let coords = DC.GeoTools.pointBuffer(
'120.71259021075333,31.22148081085083',
100
)

let coords1 = DC.GeoTools.polygonBuffer(
'120.71259021075333,31.22148081085083;120.71611354431036,31.221447256684566;120.7140691869497,31.21875584696343',
150
)
```

### static methods

- **_pointBuffer(position, radius, steps)_**

- parameters
- `{Array|String|Position} position`
- `{Number} radius`
- `{Number} steps` default:8
- returns `array`

- **_polylineBuffer(positions, radius, steps)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} radius`
- `{Number} steps` default:8
- returns `array`

- **_polygonBuffer(positions, radius, steps)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} radius`
- `{Number} steps` default:8
- returns `array`

- **_transformPolylineScale(positions, factor)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} factor`
- returns `array`

- **_transformPolygonScale(positions, factor)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} factor`
- returns `array`

- **_transformPolylineRotate(positions, angle)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} angle`
- returns `array`

- **_transformPolygonRotate(positions, angle)_**

- parameters
- `{Array|String|Array<Position>} positions`
- `{Number} angle`
- returns `array`

## DC.GlobClipping

> Glob Clipping

### example

```js
let globClipping = new DC.GlobClipping(viewer)
```

### creation

- **_constructor(viewer,[options])_**

- parameters
- `{Viewer} viewer`
- `{Object} options`
- returns `globClipping`

```json
// options(optional)
{
"edgeWidth": 0,
"edgeColor": DC.Color.WHITE
}
```

### properties

- `{Array<Position>} positions`
- `{Number} distance`
- `{Boolean} enable`
- `{String} state` **_`readonly`_**

## DC.TerrainClipping

> Terrain Clipping

### example

```js
let terrainClipping = new DC.TerrainClipping(viewer)
```

### creation

- **_constructor(viewer,[options])_**

- parameters
- `{Viewer} viewer`
- `{Object} options`
- returns `terrainClipping`

```json
// options(optional)
{
"edgeWidth": 0,
"edgeColor": DC.Color.WHITE,
"lerpInterval": 50,
"bottomImage": "",
"sideImage": ""
}
```

### properties

- `{Array<Position>} positions`
- `{Number} height`
- `{Boolean} enable`
- `{String} state` **_`readonly`_**

+ 28
- 11
docs/layer/README.md Parādīt failu

@@ -641,31 +641,48 @@ viewer.addLayer(layer)
- `{Object} options`
- returns `windLayer`

## DC.S3MLayer
## DC.ChartLayer

> SInherited from [Layer](#layer)
> Inherited from [Layer](../layer/#layer)

### example

```js
let layer = new DC.S3MLayer('id','**.scp')
viewer.addLayer(layer)
let chartLayer = new DC.ChartLayer('layer')
viewer.addLayer(chartLayer)
```

:::warning
The chart layer depends on the echarts library, please make sure that echarts is available in the global variables before using it.
:::

### creation

- **_constructor(id,url,[options])_**
- **_constructor([id],[option])_**

- parameters
- `{String} id`
- `{String} url`
- `{Object} options`
- returns `windLayer`
- `{Object} option` [echarts](https://www.echartsjs.com/zh/option.html#title)
- returns `chartLayer`

```json
//options(optional)
// options
{
"maxVisibleDistance"：Number.MAX_VALUE,
"minVisibleDistance"：0,
"animation": false, //required
"GLMap": {},
"series": [
{
"coordinateSystem": "GLMap"
}
]
}
```

### methods

- **_setOption(option)_**

- parameters
- `{Object} option` [echarts](https://www.echartsjs.com/zh/option.html#title)
- returns `this`


+ 0
- 190
docs/third-part/README.md Parādīt failu

@@ -1,190 +0,0 @@
---
sidebar: auto
---

# Third Part 🌎

Adding a third-party map library to a 3D scene

## DC.ChartLayer

> Inherited from [Layer](../layer/#layer)

### example

```js
let chartLayer = new DC.ChartLayer('layer')
viewer.addLayer(chartLayer)
```

:::warning
The chart layer depends on the echarts library, please make sure that echarts is available in the global variables before using it.
:::

### creation

- **_constructor([id],[option])_**

- parameters
- `{String} id`
- `{Object} option` [echarts](https://www.echartsjs.com/zh/option.html#title)
- returns `chartLayer`

```json
// options
{
"animation": false, //required
"GLMap": {},
"series": [
{
"coordinateSystem": "GLMap"
}
]
}
```

### methods

- **_setOption(option)_**

- parameters
- `{Object} option` [echarts](https://www.echartsjs.com/zh/option.html#title)
- returns `this`

## DC.MapvDataSet

### example

```js
let geoCoordMap = {
上海: [121.4648, 31.2891],
东莞: [113.8953, 22.901],
东营: [118.7073, 37.5513],
中山: [113.4229, 22.478],
临汾: [111.4783, 36.1615],
}
let data = []
for (let key in geoCoordMap) {
let geoCoord = geoCoordMap[key]
data.push({
geometry: {
type: 'Point',
coordinates: [
geoCoord[0] - 2 + Math.random() * 4,
geoCoord[1] - 2 + Math.random() * 4,
],
},
count: 30 * Math.random(),
})
}

let dataset = new DC.MapvDataSet(data)
```

### creation

- **_constructor(data)_**

- parameters
- `{Array<Object>} data` [DataSet](https://github.com/huiyan-fe/mapv/blob/master/src/data/DataSet.md)
- returns `dataset`

```json
{
"geometry": {
"type": "Point",
"coordinates": [123, 23]
},
"count": 30,
"time": 100 * Math.random()
}
```

## DC.MapvLayer

> Inherited from [Layer](../layer/#layer)

### example

```js
let options = {
fillStyle: 'rgba(55, 50, 250, 0.8)',
shadowColor: 'rgba(255, 250, 50, 1)',
shadowBlur: 20,
size: 40,
globalAlpha: 0.5,
label: {
show: true,
fillStyle: 'white',
},
animation: {
type: 'time',
stepsRange: {
start: 0,
end: 100,
},
trails: 10,
duration: 4,
},
gradient: {
0.25: 'rgb(0,0,255)',
0.55: 'rgb(0,255,0)',
0.85: 'yellow',
1.0: 'rgb(255,0,0)',
},
draw: 'grid',
}
let layer = new DC.MapvLayer('layer', options)
viewer.addLayer(layer)
```

### creation

- **_constructor(id,[options])_**

- parameters
- `{String} id`
- `{Object} options`
- returns `mapvLayer`

```json
// options(optional)
{
"fillStyle": "rgba(55, 50, 250, 0.8)",
"shadowColor": "rgba(255, 250, 50, 1)",
"shadowBlur": 20,
"size": 40,
"globalAlpha": 0.5,
"globalCompositeOperation": "lighter",
"label": {
"show": true,
"fillStyle": "white"
},
"animation": {
"type": "time",
"stepsRange": {
"start": 0,
"end": 100
},
"trails": 10,
"duration": 4
},
"lineWidth": 0.7,
"lineDash": [15],
"gradient": {
0.25: "rgb(0,0,255)",
0.55: "rgb(0,255,0)",
0.85: "yellow",
1.0: "rgb(255,0,0)"
},
"draw": "grid"
}
```

### methods

- **_setDataSet(dataset)_**

- parameters
- `{MapvDataSet} dataset`
- returns `this`

+ 16
- 16
docs/tile/README.md Parādīt failu

@@ -28,98 +28,98 @@ viewer.addBaseLayer(baseLayer, {

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createBaiduImageryLayer(options)_**

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createGoogleImageryLayer(options)_**

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createTdtImageryLayer(options)_**

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createTencentImageryLayer(options)_**

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createArcGisImageryLayer(options)_**

- parameters
- `{Object} options` [ArcGis](http://resource.dvgis.cn/cesium-docs/ArcGisMapServerImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createSingleTileImageryLayer(options)_**

- parameters
- `{Object} options` [Single](http://resource.dvgis.cn/cesium-docs/SingleTileImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createWMSImageryLayer(options)_**

- parameters
- `{Object} options` [WMS](http://resource.dvgis.cn/cesium-docs/WebMapServiceImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createWMTSImageryLayer(options)_**

- parameters
- `{Object} options` [WMTS](http://resource.dvgis.cn/cesium-docs/WebMapTileServiceImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createXYZImageryLayer(options)_**

- parameters
- `{Object} options` [X/Y/Z](http://resource.dvgis.cn/cesium-docs/UrlTemplateImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createCoordImageryLayer(options)_**

- parameters
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createGridImageryLayer(options)_**

- parameters
- `{Object} options` [Grid](http://resource.dvgis.cn/cesium-docs/GridImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createMapboxImageryLayer(options)_**

- parameters
- `{Object} options` [Mapbox](http://resource.dvgis.cn/cesium-docs/MapboxImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createMapboxStyleImageryLayer(options)_**

- parameters
- `{Object} options` [Mapbox Style](http://resource.dvgis.cn/cesium-docs/MapboxStyleImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createTMSImageryLayer(options)_**

- parameters
- `{Object} options` [TMS](http://resource.dvgis.cn/cesium-docs/TileMapServiceImageryProvider.html#.ConstructorOptions)
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

- **_createImageryLayer(type, options)_**

- parameters
- `{String} type`，DC.ImageryType
- `{Object} options`
- returns `baseLayer`
- returns `Promise<baseLayerProvider>`

```json
//options(optional)

+ 44
- 59
docs/tools/README.md Parādīt failu

@@ -60,106 +60,91 @@ plot.draw(DC.OverlayType.POINT, (overlay) => {}, {})

- returns `this`

## DC.PositionEditor

> Position Editor Tool
## DC.Measure

> viewer measure

### example

```js
let positionEditor = new DC.PositionEditor(viewer)
viewer.use(new DC.Measure())
```

### creation

- **_constructor(viewer,[options])_**

- parameters
- `{Viewer} viewer`
- `{Object} options`
- returns `positionEditor`

```json
// options(optional)
{
"arrow": true, // whether the auxiliary axis is an arrow
"width": 8, // auxiliary axis width
"depthFail": true, // whether the auxiliary axis supports depth test
"axisLineScale": 1 // auxiliary axis scale
}
```

### properties
- **_constructor()_**

- `{Overlay} overlay` **_`readonly`_**
- returns `measure`

### methods

- **_activate(type, callback)_**
- **_angle([options])_**

- parameters
- `{String} type`
- `{Function} callback` parameter ：position
- `{Object} options`
- returns `this`

- **_deactivate()_**
- **_area([options])_**

- parameters
- `{Object} options`
- returns `this`

## DC.ModelManager

> Model Manager Tool

### example

```js
let manager = new DC.ModelManager(viewer, layer.getOverlays())
```
- **_areaSurface([options])_**

### creation
- parameters
- `{Object} options`
- returns `this`

- **_constructor(viewer,models,[options])_**
- **_distance([options])_**

- parameters
- `{Viewer} viewer`
- `{Array} models`
- `{Object} options`
- returns `manager`
- returns `this`

```json
// options(optional)
{
"disappearHeight": 1000,
"disappearSeconds": 0.5,
"appearSeconds": 0.5
}
```
- **_distanceSurface([options])_**

### properties
- parameters
- `{Object} options`
- returns `this`

- `{Array} models`
- **_heading([options])_**

### methods
- parameters
- `{Object} options`
- returns `this`

- **_spread(height, seconds)_**
- **_height([options])_**

- parameters
- `{Number} height`
- `{Number} seconds`
- `{Object} options`
- returns `this`

- **_combine(seconds)_**
- **_triangleHeight([options])_**

- parameters
- `{Number} seconds`
- `{Object} options`
- returns `this`

- **_showModel(modelIndex)_**
- **_activate(type,[options])_**

- parameters
- `{Number} modelIndex`
- `{String} type`
- `{Object} options`
- returns `this`

- **_restore()_**
```json
// options(optional)
{
"icon_center": "**.png",
"icon_anchor": "**.png",
"icon_midAnchor": "**.png",
"icon_size": [12, 12],
"clampToModel": false
}
```

- **_deactivate()_**

- returns `this`

+ 0
- 538
docs/zh/analysis/README.md Parādīt failu

@@ -1,538 +0,0 @@
---
sidebar: auto
---

# 场景分析 🌎

## DC.Measure

> 三维空间分析

### example

```js
let measure = new DC.Measure(viewer)
```

### creation

- **_constructor()_**

构造函数

- 返回值 `measure`

### methods

- **_angle([options])_**

角度

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_area([options])_**

面积

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_areaSurface([options])_**

表面面积

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_distance([options])_**

距离

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_distanceSurface([options])_**

表面距离

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_heading([options])_**

偏航角

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_height([options])_**

高度

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_triangleHeight([options])_**

三角测量

- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_activate(type,[options])_**

根据类型分析

- 参数
- `{String} type`：分析类型，参考 `DC.MeasureType`,
- `{Object} options`：配置
- 返回值 `this`

```json
//属性参数(可选)
{
"icon_center": "**.png", // 自定义的中心点图标
"icon_anchor": "**.png", //自定义的锚点图标
"icon_midAnchor": "**.png", //自定义的中心锚点图标
"icon_size": [12, 12], //自定义的中心锚点大小
"clampToModel": false //点位是否获取模型表面坐标
}
```

- **_deactivate()_**

释放空间分析

- 返回值 `this`

## DC.Analysis

> 三维场景分析

### example

```js
let analysis = new DC.Analysis(viewer)
```

### creation

- **_constructor()_**

构造函数

- 返回值 `analysis`

### methods

- **_contourLine(lineColor, lineWidth, lineSpacing)_**

等高线

- 参数
- `{Color} lineColor`：颜色
- `{Number} lineWidth`：宽度
- `{Number} lineSpacing`：间隔
- 返回值 `this`

- **_shadows(startTime, multiplier)_**

日照分析

- 参数
- `{Date} startTime`：日期
- `{Number} multiplier`：倍率
- 返回值 `this`

- **_sightLine(startPosition, endPosition, excludes, lerpNum)_**

通视分析(线)

- 参数
- `{Position|Array|String|Object} startPosition`：起点
- `{Position|Array|String|Object} endPosition`：终点
- `{Array<Overlay>} excludes`：非包含覆盖物
- `{Number} lerpNum`：插值数量，默认：10，数量越大越准确，同时计算量也会增加
- 返回值 `this`

- **_sightCircle(center, radius, excludes, lerpNum)_**

通视分析(圆)

- 参数
- `{Position|Array|String|Object} center`：圆心
- `{Number} radius`：半径
- `{Array<Overlay>} excludes`：非包含覆盖物
- `{Number} lerpNum`：插值数量，默认：10，数量越大越准确，同时计算量也会增加
- 返回值 `this`

- **_viewshed(position, radius, fov, aspectRatio, options)_**

可视域分析

- 参数
- `{Position|Array|String|Object} position`：视点
- `{Number} radius`：半径
- `{Number} fov`：横向视角
- `{Number} aspectRatio`：横纵比例
- `{Object} options`：属性设置
- 返回值 `this`

```json
//属性参数
{
"mixNum":1, // 混合度
"visibleColor"：DC.Color.GREEN,//可见颜色
"disVisibleColor"：DC.Color.RED,//不可见颜色
"showHelp": false, //显示辅助覆盖物
"gridColor": DC.Color.YELLOW, //辅助覆盖物格子颜色
"lineColor": DC.Color.YELLOW.withAlpha(0.3) //辅助覆盖物边线颜色
}
```

- **_deactivate([type])_**

释放分析

- 参数
- `{String} type`：分析类型，参考 `DC.AnalysisType`。类型为空时，将清除所有分析
- 返回值 `this`

## DC.CameraVideoLayer

> 视频图层，继承于[Layer](../layer/#layer)

### example

```js
let layer = new DC.CameraVideoLayer('id')
viewer.addLayer(layer)
```

### creation

- **_constructor(id)_**

构造函数

- 参数
- `{String} id`：图层唯一标识
- 返回值 `videoLayer`

### methods

- **_showHelp(show, videoOverlay, color)_**

是否显示辅助视锥

- 参数
- `{Boolean} show`：是否显示
- `{Overlay} videoOverlay`：视频覆盖物
- `{Color} color`：边线颜色
- 返回值 `this`

## DC.CameraVideo

> 视频融合要素，继承于[Overlay](../overlay/#overlay)

### example

```js
let position = new DC.Position(120, 20, 200, -20, 19)
let videoEl = new document.getElementById('video')
let cameraVideo = new DC.CameraVideo(position, videoEl)
layer.addOverlay(cameraVideo)
```

### creation

- **_constructor(position, video,[maskUrl])_**

构造函数

- 参数
- `{Position} position`：坐标
- `{Element} video`：视频节点
- `{String} [maskUrl]`: 羽化图片地址
- 返回值 `cameraVideo`

### properties

- `{Position} position`：坐标
- `{Element} video`：视频节点
- `{String} maskUrl`: 羽化图片地址

### methods

- **_setStyle(style)_**

设置样式

- 参数
- `{Object} style`：样式
- 返回值 `this`

```json
// 样式参数(可选)
{
"fov": 60, //视场角
"near": 1, //近平面的距离
"far": 5000, //远平面的距离
"aspectRatio": 1, //视锥的宽度与高度的纵横比
"alpha": 1, //透明度
"clearBlack": true, //清除空白
"disViewColor": DC.Color.WHITE //设置视频不可见颜色
}
```

## DC.PlaneVideoLayer

> 平面视频图层，继承于[Layer](../layer/#layer)

### example

```js
let layer = new DC.PlaneVideoLayer('id')
viewer.addLayer(layer)
```

### creation

- **_constructor(id)_**

构造函数

- 参数
- `{String} id`：图层唯一标识
- 返回值 `videoLayer`

### methods

- **_showHelp(show, videoOverlay, color)_**

是否显示辅助视锥

- 参数
- `{Boolean} show`：是否显示
- `{Overlay} videoOverlay`：视频覆盖物
- `{Color} color`：边线颜色
- 返回值 `this`

## DC.PlaneVideo

> 平面视频要素，继承于[Overlay](../overlay/#overlay)

### example

```js
let position = new DC.Position(120, 20, 200, -20, 19)
let videoEl = new document.getElementById('video')
let cameraVideo = new DC.PlaneVideo(position, videoEl)
layer.addOverlay(cameraVideo)
```

### creation

- **_constructor(position, video)_**

构造函数

- 参数
- `{Position} position`：坐标
- `{Element} video`：视频节点
- 返回值 `cameraVideo`

### properties

- `{Position} position`：坐标
- `{Element} video`：视频节点

### methods

- **_setStyle(style)_**

设置样式

- 参数
- `{Object} style`：样式
- 返回值 `this`

```json
// 样式参数(可选)
{
"fov": 60, //视场角
"near": 1, //近平面的距离
"far": 5000, //远平面的距离
"aspectRatio": 1 //视锥的宽度与高度的纵横比
}
```

## DC.GeoTools

> 要素工具

### example

```js
let coords = DC.GeoTools.pointBuffer(
'120.71259021075333,31.22148081085083',
100
)

let coords1 = DC.GeoTools.polygonBuffer(
'120.71259021075333,31.22148081085083;120.71611354431036,31.221447256684566;120.7140691869497,31.21875584696343',
150
)
```

### static methods

- **_pointBuffer(position, radius, steps)_**

点缓冲

- 参数
- `{Array|String|Position} position`：坐标
- `{Number} radius`：半径
- `{Number} steps`：步数，默认：8
- 返回值 `array`

- **_polylineBuffer(positions, radius, steps)_**

线缓冲

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} radius`：半径
- `{Number} steps`：步数，默认：8
- 返回值 `array`

- **_polygonBuffer(positions, radius, steps)_**

面缓冲

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} radius`：半径
- `{Number} steps`：步数，默认：8
- 返回值 `array`

- **_transformPolylineScale(positions, factor)_**

比例线

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} factor`：比例
- 返回值 `array`

- **_transformPolygonScale(positions, factor)_**

比例面

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} factor`：比例
- 返回值 `array`

- **_transformPolylineRotate(positions, angle)_**

旋转线

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} angle`：角度
- 返回值 `array`

- **_transformPolygonRotate(positions, angle)_**

旋转面

- 参数
- `{Array|String|Array<Position>} positions`：坐标串
- `{Number} angle`：角度
- 返回值 `array`

## DC.GlobClipping

> 地球裁剪

### example

```js
let globClipping = new DC.GlobClipping(viewer)
```

### creation

- **_constructor(viewer,[options])_**

构造函数

- 参数
- `{Viewer} viewer`：场景
- `{Object} options`：属性
- 返回值 `globClipping`

```json
// 属性参数(可选)
{
"edgeWidth": 0, // 边缘宽度
"edgeColor": DC.Color.WHITE // 边缘颜色
}
```

### properties

- `{Array<Position>} positions`：坐标串
- `{Number} distance`: 距离
- `{Boolean} enable`: 是否启用
- `{String} state`: 状态 **_`readonly`_**

## DC.TerrainClipping

> 地形裁剪

### example

```js
let terrainClipping = new DC.TerrainClipping(viewer)
```

### creation

- **_constructor(viewer,[options])_**

构造函数

- 参数
- `{Viewer} viewer`：场景
- `{Object} options`：属性
- 返回值 `terrainClipping`

```json
// 属性参数(可选)
{
"edgeWidth": 0, // 边缘宽度
"edgeColor": DC.Color.WHITE, // 边缘颜色
"lerpInterval": 50, // 插值数量
"bottomImage": "", // 底部图片
"sideImage": "" // 侧边图片
}
```

### properties

- `{Array<Position>} positions`：坐标串
- `{Number} height`: 高度
- `{Boolean} enable`: 是否启用
- `{String} state`: 状态 **_`readonly`_**

+ 49
- 0
docs/zh/layer/README.md Parādīt failu

@@ -759,3 +759,52 @@ viewer.addLayer(layer)
"heightOffset":0,//高度偏移
}
```

## DC.ChartLayer

> 图表图层，继承于[Layer](../layer/#layer)

### example

```js
let chartLayer = new DC.ChartLayer('layer')
viewer.addLayer(chartLayer)
```

:::warning
图表图层依赖于 echarts 库，使用前请确保全局变量中能够获取到 echarts
:::

### creation

- **_constructor([id],[option])_**

构造函数

- 参数
- `{String} id`：唯一标识
- `{Object} option`：echarts 配置，详情参考：[echarts](https://www.echartsjs.com/zh/option.html#title)
- 返回值 `chartLayer`

```json
// options，其他的参数参考 echarts
{
"animation": false, // 必须要加
"GLMap": {}, //地图
"series": [
{
"coordinateSystem": "GLMap" // 坐标系统
}
]
}
```

### methods

- **_setOption(option)_**

设置点位

- 参数
- `{Object} option`：echarts 配置，详情参考：[echarts](https://www.echartsjs.com/zh/option.html#title)
- 返回值 `this`

+ 0
- 201
docs/zh/third-part/README.md Parādīt failu

@@ -1,201 +0,0 @@
---
sidebar: auto
---

# 第三方集成 🌎

在三维场景中添加第三方的地图库

## DC.ChartLayer

> 图表图层，继承于[Layer](../layer/#layer)

### example

```js
let chartLayer = new DC.ChartLayer('layer')
viewer.addLayer(chartLayer)
```

:::warning
图表图层依赖于 echarts 库，使用前请确保全局变量中能够获取到 echarts
:::

### creation

- **_constructor([id],[option])_**

构造函数

- 参数
- `{String} id`：唯一标识
- `{Object} option`：echarts 配置，详情参考：[echarts](https://www.echartsjs.com/zh/option.html#title)
- 返回值 `chartLayer`

```json
// options，其他的参数参考 echarts
{
"animation": false, // 必须要加
"GLMap": {}, //地图
"series": [
{
"coordinateSystem": "GLMap" // 坐标系统
}
]
}
```

### methods

- **_setOption(option)_**

设置点位

- 参数
- `{Object} option`：echarts 配置，详情参考：[echarts](https://www.echartsjs.com/zh/option.html#title)
- 返回值 `this`

## DC.MapvDataSet

### example

```js
let geoCoordMap = {
上海: [121.4648, 31.2891],
东莞: [113.8953, 22.901],
东营: [118.7073, 37.5513],
中山: [113.4229, 22.478],
临汾: [111.4783, 36.1615],
}
let data = []
for (let key in geoCoordMap) {
let geoCoord = geoCoordMap[key]
data.push({
geometry: {
type: 'Point',
coordinates: [
geoCoord[0] - 2 + Math.random() * 4,
geoCoord[1] - 2 + Math.random() * 4,
],
},
count: 30 * Math.random(),
})
}

let dataset = new DC.MapvDataSet(data)
```

### creation

- **_constructor(data)_**

构造函数

- 参数
- `{Array<Object>} data`：数据数组，详情参考：[DataSet](https://github.com/huiyan-fe/mapv/blob/master/src/data/DataSet.md)
- 返回值 `dataset`

```json
// 数据说明
{
"geometry": {
"type": "Point", // 类别，有：Point、Polygon、LineString
"coordinates": [123, 23] // 坐标，线和面是二位数组
},
"count": 30, // 用于阈值计算
"time": 100 * Math.random() // 步长 用于动画
}
```

## DC.MapvLayer

> 数据可视化图层，继承于[Layer](../layer/#layer)

### example

```js
let options = {
fillStyle: 'rgba(55, 50, 250, 0.8)',
shadowColor: 'rgba(255, 250, 50, 1)',
shadowBlur: 20,
size: 40,
globalAlpha: 0.5,
label: {
show: true,
fillStyle: 'white',
},
animation: {
type: 'time',
stepsRange: {
start: 0,
end: 100,
},
trails: 10,
duration: 4,
},
gradient: {
0.25: 'rgb(0,0,255)',
0.55: 'rgb(0,255,0)',
0.85: 'yellow',
1.0: 'rgb(255,0,0)',
},
draw: 'grid',
}
let layer = new DC.MapvLayer('layer', options)
viewer.addLayer(layer)
```

### creation

- **_constructor(id,options)_**

构造函数

- 参数
- `{String} id`：图层唯一标识
- `{Object} options`：属性
- 返回值 `mapvLayer`

```json
// 属性参数（可选）
{
"fillStyle": "rgba(55, 50, 250, 0.8)", //颜色
"shadowColor": "rgba(255, 250, 50, 1)", // 阴影颜色
"shadowBlur": 20, // 阴影扩散
"size": 40, // 点大小
"globalAlpha": 0.5, //
"globalCompositeOperation": "lighter",
"label": {
"show": true,
"fillStyle": "white"
}, // 文字
"animation": {
"type": "time",
"stepsRange": {
"start": 0,
"end": 100
},
"trails": 10,
"duration": 4
}, //动画
"lineWidth": 0.7, // 线宽
"lineDash": [15], // 虚线
"gradient": {
0.25: "rgb(0,0,255)",
0.55: "rgb(0,255,0)",
0.85: "yellow",
1.0: "rgb(255,0,0)"
}, //渐变
"draw": "grid" //展现方式 有：simple：简单、intensity：强度、honeycomb：蜂巢、grid：格子等
}
```

### methods

- **_setDataSet(dataset)_**

设置点位

- 参数
- `{MapvDataSet} dataset`： 数据配置
- 返回值 `this`

+ 55
- 65
docs/zh/tools/README.md Parādīt failu

@@ -68,122 +68,112 @@ plot.draw(DC.OverlayType.POINT, (overlay) => {}, {})

- 返回值 `this`

## DC.PositionEditor
## DC.Measure

> 位置编辑工具
> 三维空间分析

### example

```js
let coords = new DC.PositionEditor(viewer)
let measure = new DC.Measure(viewer)
```

### creation

- **_constructor(viewer,[options])_**
- **_constructor()_**

构造函数

- 参数
- `{Viewer} viewer`：场景
- `{Object} options`：属性
- 返回值 `plot`

```json
//属性参数(可选)
{
"arrow": true, // 辅助轴线是否为箭头
"width": 8, // 辅助轴线宽度
"depthFail": true, // 辅助轴线是否支持深度检测
"axisLineScale": 1 // 辅助轴线比例
}
```

### properties

- `{Overlay} overlay`：覆盖物 **_`writeOnly`_**
- 返回值 `measure`

### methods

- **_activate(type, callback)_**
- **_angle([options])_**

激活
角度

- 参数
- `{String} type`：类型，`DC.PositionEditorType`
- `{Function} callback`：回调函数，参数为：position
- `{Object} options`：配置
- 返回值 `this`

- **_deactivate()_**
- **_area([options])_**

失效
面积

- 参数
- `{Object} options`：配置
- 返回值 `this`

## DC.ModelManager
- **_areaSurface([options])_**

> 模型管理工具
表面面积

### example
- 参数
- `{Object} options`：配置
- 返回值 `this`

```js
let manager = new DC.ModelManager(viewer, layer.getOverlays())
```
- **_distance([options])_**

### creation
距离

- **_constructor(viewer,models,[options])_**
- 参数
- `{Object} options`：配置
- 返回值 `this`

构造函数
- **_distanceSurface([options])_**

- 参数
- `{Viewer} viewer`：场景
- `{Array} models`：覆盖物
- `{Object} options`：属性
- 返回值 `manager`
表面距离

```json
//属性参数(可选)
{
"disappearHeight": 1000, // 消失高度
"disappearSeconds": 0.5, // 消失时间
"appearSeconds": 0.5 // 出现时间
}
```
- 参数
- `{Object} options`：配置
- 返回值 `this`

### properties
- **_heading([options])_**

- `{Array} models`：覆盖物
偏航角

### methods
- 参数
- `{Object} options`：配置
- 返回值 `this`

- **_spread(height, seconds)_**
- **_height([options])_**

展开
高度

- 参数
- `{Number} height`：高度
- `{Number} seconds`：时间
- `{Object} options`：配置
- 返回值 `this`

- **_combine(seconds)_**
- **_triangleHeight([options])_**

合并
三角测量

- 参数
- `{Number} seconds`：时间
- `{Object} options`：配置
- 返回值 `this`

- **_showModel(modelIndex)_**
- **_activate(type,[options])_**

展示模型
根据类型分析

- 参数
- `{Number} modelIndex`：模型索引，和数组索引一致
- `{String} type`：分析类型，参考 `DC.MeasureType`,
- `{Object} options`：配置
- 返回值 `this`

- **_restore()_**
```json
//属性参数(可选)
{
"icon_center": "**.png", // 自定义的中心点图标
"icon_anchor": "**.png", //自定义的锚点图标
"icon_midAnchor": "**.png", //自定义的中心锚点图标
"icon_size": [12, 12], //自定义的中心锚点大小
"clampToModel": false //点位是否获取模型表面坐标
}
```

- **_deactivate()_**

还原
释放空间分析

- 返回值 `this`

Rakstīt Priekšskatītījums
Notiek ielāde…
Atcelt
Saglabāt