# ContourLine
查阅Cesium API

#### new mars3d.thing.ContourLine(options)
thing/terrain/ContourLine.js 6

等高线

参数名称 | 类型 | 描述信息
--- | --- | ---
`options` | object | 可选 参数对象，包括以下：
参数名称 | 类型 | 默认值 | 描述信息
--- | --- | --- | ---
`area` | Array.<object> |  | 可选 多区域数组对象, 示例： [{ positions: [[108.959062, 34.220134, 397], [108.959802, 34.220147, 397], [108.959106, 34.21953, 398]] }]
`positions` | Array.<Array> | Array.<string> | Array.<LngLatPoint> | Array.<Cesium.Cartesian3> |  | 可选 坐标位置数组，只显示单个区域【单个区域场景时使用】
`contourShow` | boolean | `true` | 可选 是否显示等高线
`spacing` | number | `100.0` | 可选 等高线 间隔（单位：米）
`width` | number | `1.5` | 可选 等高线 线宽（单位：像素）
`color` | Cesium.Color | string | `Cesium.Color.RED` | 可选 等高线 颜色
`shadingType` | string | `'none'` | 可选 地表渲染效果，可选值: 无none, 高程 elevation, 坡度slope, 坡向aspect
`shadingAlpha` | number | `0.6` | 可选 地表渲染透明度，0.0-1.0
`colorScheme` | object |  | 可选 地表渲染配色方案,默认值为： { elevation: { step: [0.0, 0.045, 0.1, 0.15, 0.37, 0.54, 1.0], color: ['#000000', '#2747E0', '#D33B7D', '#D33038', '#FF9742', '#FF9742', '#ffd700'], }, slope: { step: [0.0, 0.29, 0.5, Math.sqrt(2) / 2, 0.87, 0.91, 1.0], color: ['#000000', '#2747E0', '#D33B7D', '#D33038', '#FF9742', '#FF9742', '#ffd700'], }, aspect: { step: [0.0, 0.2, 0.4, 0.6, 0.8, 0.9, 1.0], color: ['#000000', '#2747E0', '#D33B7D', '#D33038', '#FF9742', '#FF9742', '#ffd700'], }, }
`showElseArea` | boolean | `true` | 可选 是否显示区域外的地图
`minHeight` | number | `-414.0` | 可选 地表渲染配色方案中的 最低海拔高度
`maxHeight` | number | `8777` | 可选 地表渲染配色方案中的 最高海拔高度
`id` | string | number | `createGuid()` | 可选 对象的id标识
`enabled` | boolean | `true` | 可选 对象的启用状态
`eventParent` | BaseClass | boolean |  | 可选 指定的事件冒泡对象，默认为所加入的map对象，false时不冒泡事件

### 继承自

- TerrainEditBase

### 属性值

#### 只读 area : Array.<object>
thing/terrain/TerrainEditBase.js 45

区域 列表

继承自:
  - TerrainEditBase#area

#### color : Cesium.Color|string
thing/terrain/ContourLine.js 156

等高线 颜色

#### contourShow : boolean
thing/terrain/ContourLine.js 87

是否显示等高线

#### 只读 length : number
thing/terrain/TerrainEditBase.js 66

已添加的区域个数

继承自:
  - TerrainEditBase#length

#### maxHeight : number
thing/terrain/ContourLine.js 186

地表渲染配色方案中的 最高海拔高度

#### minHeight : number
thing/terrain/ContourLine.js 171

地表渲染配色方案中的 最低海拔高度

#### positions : Array.<Array>|Array.<string>|Array.<LngLatPoint>|Array.<Cesium.Cartesian3>
thing/terrain/TerrainEditBase.js 78

坐标位置数组，只显示单个区域【单个区域场景时使用】

继承自:
  - TerrainEditBase#positions

#### shadingAlpha : number
thing/terrain/ContourLine.js 113

地表渲染透明度，0.0-1.0

#### shadingType : string
thing/terrain/ContourLine.js 100

地表渲染效果，可选值: 无none, 高程 elevation, 坡度slope, 坡向aspect

#### showElseArea : boolean
thing/terrain/ContourLine.js 201

是否显示区域外的地图

#### spacing : number
thing/terrain/ContourLine.js 141

等高线 间隔（单位：米）

#### width : number
thing/terrain/ContourLine.js 126

等高线 线宽（单位：像素）

### 方法

#### addArea(positions, options) → object
thing/terrain/TerrainEditBase.js 236

添加单个区域

参数名称 | 类型 | 默认值 | 描述信息
--- | --- | --- | ---
`positions` | Array.<string> | Array.<Array> | Array.<LngLatPoint> | Array.<Cesium.Cartesian3> |  | 坐标位置数组
`options` | object | `{}` | 可选 控制的参数
参数名称 | 类型 | 描述信息
--- | --- | ---
`height` | number | 可选 地形压平时，高度值
`diffHeight` | number | 可选 地形开挖和抬升时，墙体的高度值
`minHeight` | number | 可选 地形开挖和抬升时，墙体的顶部高度，默认计算positions贴地插值坐标后的最低点高度。
`simplify` | object | 可选 是否简化坐标点位，为空时不简化
参数名称 | 类型 | 默认值 | 描述信息
--- | --- | --- | ---
`tolerance` | number | `0.0001` | 可选 简化的程度，传值是经纬度的小数位
`highQuality` | boolean | `true` | 可选 是否花更多的时间用不同的算法创建更高质量的简化
`mutate` | boolean | `true` | 可选 是否允许对输入进行变异（如果为true，则显著提高性能）
`id` | number | string | 可选 外部自定义ID，注意不用有重复值。默认内部自动赋予

##### 返回值:

添加区域的记录对象

继承自:
  - TerrainEditBase#addArea

#### clear() → void
thing/terrain/TerrainEditBase.js 134

清除所有区域

##### 返回值:

无

继承自:
  - TerrainEditBase#clear

#### getAreaById(id) → object
thing/terrain/TerrainEditBase.js 145

根据id获取区域对象

参数名称 | 类型 | 描述信息
--- | --- | ---
`id` | number | string | id值

##### 返回值:

区域对象

继承自:
  - TerrainEditBase#getAreaById

#### hideArea(id) → void
thing/terrain/TerrainEditBase.js 160

隐藏单个区域

参数名称 | 类型 | 描述信息
--- | --- | ---
`id` | number | string | 区域id值

##### 返回值:

无

继承自:
  - TerrainEditBase#hideArea

#### async reload() → void
thing/terrain/TerrainEditBase.js 322

重新加载数据（会重新按当前地形服务计算，如切换地形后可以调用）

##### 返回值:

无

继承自:
  - TerrainEditBase#reload

#### removeArea(item) → void
thing/terrain/TerrainEditBase.js 201

移除单个区域

参数名称 | 类型 | 描述信息
--- | --- | ---
`item` | number | string | object | 区域的id值，或 addArea返回的区域对象

##### 返回值:

无

继承自:
  - TerrainEditBase#removeArea

#### showArea(id) → void
thing/terrain/TerrainEditBase.js 179

显示单个区域

参数名称 | 类型 | 描述信息
--- | --- | ---
`id` | number | string | 区域id值

##### 返回值:

无

继承自:
  - TerrainEditBase#showArea