layer~TerrainLayer(name, terrainUrl, options)

地形图层。用来接入.terrain格式的瓦片数据。数据标准为https://github.com/CesiumGS/quantized-mesh。暂不支持数据中扩展的解析与接入，即不支持数据中Extensions的解析渲染。
terrain的瓦片规则TMS的global-geodetic，4326坐标系切片原点(-180,-90)，zoom大小比地图的大小减1。
注：暂只支持4326坐标系，不处理小于海平面数据。

Extends:

Summary

Methods:
fromHMapPlatform

通过空间信息服务平台元数据创建图层
clearLocalStorage

清空本地存储的数据，当初始化参数useLocalStorage为true时有效
getExaggeration

获取地形夸张系数
setDrawMode

设置绘制模式，图层添加到地图（map）上有效
setExaggeration

设置地形夸张系数

Constructor

new TerrainLayer(name, terrainUrl, options)

Parameters:
Name Type Description
name String

地形图层的名称
terrainUrl String

地形数据文件的路径
options Object
Name Type Description
terrainMinLevel Number

地形瓦片的最小层级。默认使用地图不小于0的最小层级
terrainMaxLevel Number

地形瓦片的最大层级。默认使用地图的最大层级
terrainOrigin module:basetype~Coordinate

地形瓦片的切片原点。默认为new hmap.basetype.Coordinate(-180,-90)
imgUrl String

地形使用的影像瓦片路径，默认为null，即不使用影像瓦片。影像瓦片作为地形瓦片的纹理使用。影像瓦片支持TMS。
dataFormat String

影像瓦片的格式，支持“png”|“jpg"|"bmp"。默认为“png”
imgZoomOffset Number

影像瓦片的层级偏移，默认为0。影像瓦片的层级计算为imgZoom=map.getZoom()+imgZoomOffset。
imgMinLevel Number

影像瓦片的最小层级。默认使用地图大于0的最小层级
imgMaxLevel Number

影像瓦片的最大层级。默认使用地图的最大层级
matrixOrigin module:basetype~Coordinate

影像瓦片的切图原点。默认为地图的左上角。
terrainColor module:style~Color

不使用影像瓦片作为纹理或地形数据层级超出影像层级范围时，地形options.colorAltitude使用的颜色。
floorColor module:style~Color

不使用影像瓦片作为纹理或地形数据层级超出影像层级范围时，地形海拔为0点使用的颜色。
colorAltitude Number

地形颜色线性混合的海拔高度。颜色计算方式为：①根据当前海拔计算颜色权重w=Math.min(当前海拔/colorAltitude,1);②根据权重计算输出地形颜色color=terrainColorw+floorColor(1-w);
enableLight Number

是否使用地图光照，增强对地形的渲染，默认为true。
fixCrack Boolean

是否修补地形裂缝，注意ctb三角算法下的地形数据需要开启该选项。
exaggeration Number

地形夸张系数。大于0的数值，默认为1。
showHeightLine Boolean

是否显示等高线，默认为false。
heightLineInterval Number

等高线显示间隔，地理单位，可以通过地图对象上的getDegreePerMeter和getMeterPerDegree方法，对地图单位进行度和米的转换，默认为0.001。
heightLineWidth Number

等高线的宽度，单位像素，默认为1。
heightLineColor module:style~Color

等高线颜色，默认为红色。
heightLineMinHeight Number

等高线显示的最小高度，默认为0。
colorsByHeight Array.<Object>

根据高度对地形进行着色，默认为空数组，即不进行高度着色。数组中单个元素为{minHeight:0, maxHeight:0.002, color:new hmap.style.Color(179,200,137,1)}，即高度分段的最小高度、最大高度和其对应的颜色。
colorsByGlope Array.<Object>

根据坡度着色，默认为空数组，即不进行坡度着色。数组中单个元素为{glope:0, color:new hmap.style.Color(0,247,0,1)}，即坡度值和其对应的颜色。
colorsByGlopeDirection Array.<Object>

根据坡向着色，默认为空数组，即不进行坡向着色。数组中单个元素为{angle:0, color:new hmap.style.Color(0, 255, 255, 1)}，即坡向范围角度值和其对应的颜色。
useLocalStorage Boolean

是否启用客户端存储。若启用，浏览地图时请求的地形瓦片和纹理图片将存储在客户端，再次浏览时将不再向服务端请求。默认true。
useWebWorker Boolean

是否开启多线程，开启多线程后，会自动开启客户端缓存useLocalStorage，默认为true。
baseGroundLayer Boolean

是否三维基础图层，如果设置成三维基础图层，贴地绘制的图层将会绘制到该图层上。
checkCameraCollisions Boolean

是否开启与相机的碰撞检测，开启后，控件交互时，相机不会进入场景内部。
collisionHeight Number

碰撞检测的高度阈值，当相机高度小于场景高度与碰撞高度之和时，判断相机与图层发生了碰撞。

Members

depthTest

获取图层的深度测试属性
return {Boolean} 深度测试属性

Overrides:

Methods

static fromHMapPlatform(metadataUrl, options) → {Promise}

通过空间信息服务平台元数据创建图层

Parameters:
Name Type Description
metadataUrl String

空间信息服务平台服务对应的元数据地址
options options

可选项，对空间信息服务平台元数据不包含的可选项进行补充，若传入的可选项与元数据中重复，以元数据为准。
Returns:
Promise -

图层创建的promise，resolve返回图层实例

clearLocalStorage() → {Promise}

清空本地存储的数据，当初始化参数useLocalStorage为true时有效

Returns:
Promise -

返回清空本地数据的信息（message）

getExaggeration() → {Number}

获取地形夸张系数

Returns:
Number -

地形夸张系数

setDrawMode(mode)

设置绘制模式，图层添加到地图（map）上有效

Parameters:
Name Type Description
mode String

模式，枚举类型包括"line"，"point","triangle" 三种，不设置或者设置其他使用"triangle"

setExaggeration(exag)

设置地形夸张系数

Parameters:
Name Type Description
exag Number

地形夸张系数。大于0的数值，小于0或非数值类型则不进行更改