Class: TMSLayer

layer~TMSLayer(name, layerUrl, options)

TMS瓦片地图服务。是tile map service的缩写，是一种瓦片地图服务，下文提到的切片等同于瓦片。TMS的算法思想是把投影后的世界地图按照层级进行四叉树切割，切割后的瓦片数量随层级指数式增长。
第n级比例尺下的瓦片片数量是Math.pow(2,n)。如果缩放过程中出现图片模糊的情况，建议把地图创建时的参数zoomInterval设置为1。

Summary

Methods:

destroy	销毁图层。
getLayerType	获取图层类型
getLayerZIndex	返回图层的zIndex值。
getMap	获取当前图层所在的地图。
getName	获取图层名称。
getOpacity	获取图层透明度。
getTileSize	获取单张瓦片的尺寸。
getVisibility	获取图层的可见性。
offMap	解除图层与地图的关联，即从图层去掉与地图对象有关的信息，同时在地图对象去掉与该图层有关的信息。关联解除后，图层依然存在，但与地图不再有关系。如果图层本身并未加载到地图上，那么该方法没有任何效果。
redraw	重新绘制图层
setLayerZIndex	设置图层在图层容器中的顺序。
setName	设置图层名称。
setOpacity	设置图层透明度。0表示完全透明，1表示完全不透明。
setVisibility	设置图层的可见性。仅设置该图层是否可见，而图层本身依然存在。

Constructor

new TMSLayer(name, layerUrl, options)

Parameters:

Name Type Description

name

String

图层名称。

layerUrl

String

TMS服务地址

options

Object

在图层上设置的附加属性。

Name	Type	Description
`matrixOrigin`	module:basetype~Coordinate	切片矩阵的原点坐标，也叫切片原点
`isReverse`	Boolean	表示级别z值是否为逆序（降序），默认值为false，即正序（顺序），如果是逆序，该值需赋值为true。
`zoomOffset`	Number	表示该图层的级别z相对于地图分辨率数组中的级别的偏移量，默认值为0。
`visibility`	Boolean	表示该图层的可见性。默认值为true，即图层可见。
`dataFormat`	String	切片格式，默认为‘png’。

Example

let matrixOrigin = new hmap.basetype.Coordinate(-180, 90);
let tmsOptions = {
        matrixOrigin: matrixOrigin,//切片原点
        dataFormat: "png"//切片格式
};
let tmsLayer = new hmap.layer.TMSLayer("TMS图层", "http://10.20.84.15:8080/GeoData/map/SpiritMap/vec/", tmsOptions);

Methods

destroy()

销毁图层。

getLayerType() → {String}

获取图层类型

Returns:

String -

图层类型

getLayerZIndex() → {Number}

返回图层的zIndex值。

Returns:

Number -

图层的zIndex

getMap() → {module:Map}

获取当前图层所在的地图。

Returns:

module:Map -

图层所属的地图对象

getName() → {String}

获取图层名称。

Returns:

String -

图层名称

getOpacity() → {Number}

获取图层透明度。

Returns:

Number -

透明度

getTileSize() → {module:basetype~Size}

获取单张瓦片的尺寸。

Returns:

module:basetype~Size -

单张瓦片的尺寸

getVisibility() → {Boolean}

获取图层的可见性。

Returns:

Boolean -

true表示可见，false表示不可见。

offMap()

解除图层与地图的关联，即从图层去掉与地图对象有关的信息，同时在地图对象去掉与该图层有关的信息。关联解除后，图层依然存在，但与地图不再有关系。
如果图层本身并未加载到地图上，那么该方法没有任何效果。

redraw(type)

重新绘制图层

Parameters:

Name	Type	Default	Description
`type`	Number	1	取值为0或1，0表示map调用redraw，1表示layer调用redraw，默认为1。

setLayerZIndex(zIndex)

设置图层在图层容器中的顺序。

Parameters:

Name	Type	Description
`zIndex`	Number	图层的zIndex,值越大，图层越靠近上方。但是该值改变不了图层容器的上下顺序。

setName(name)

设置图层名称。

Parameters:

Name	Type	Description
`name`	String	图层名称

Throws:

Error -

当name不是String类型时抛出异常。

setOpacity(opacity)

设置图层透明度。0表示完全透明，1表示完全不透明。

Parameters:

Name	Type	Default	Description
`opacity`	Number	1	图层透明度，介于0-1之间。

Throws:

TypeError -

当图层的透明度值不是一个0-1之间的数字时，抛出异常。

setVisibility(visible)

设置图层的可见性。仅设置该图层是否可见，而图层本身依然存在。

Parameters:

Name	Type	Default	Description
`visible`	Boolean	true	是否可见，默认为true，可见。

Throws:

TypeError -

当参数不是布尔类型时，抛出异常。