ImageryLayerCollection

new Cesium.ImageryLayerCollection()
Scene/ImageryLayerCollection.js 35

影像图层集合类。该类主要用于对影像类图层进行管理。
Demo:

Members

layerAdded : Event
Scene/ImageryLayerCollection.js 43

向图层集合中添加了图层后触发该事件。
Default Value: Event()

layerMoved : Event
Scene/ImageryLayerCollection.js 57

图层集合中某图层发生移动后触发该事件。
Default Value: Event()

layerRemoved : Event
Scene/ImageryLayerCollection.js 50

从图层集合中移除某图层后触发该事件。
Default Value: Event()

layerShownOrHidden : Event
Scene/ImageryLayerCollection.js 64

图层可见性设置ImageryLayer#show发生改变时触发该事件。
Default Value: Event()

length : Number
Scene/ImageryLayerCollection.js 73

获取图层集合中的图层数量。

Methods

add(layer, index)
Scene/ImageryLayerCollection.js 88

向图层集合添加一个图层。
Name Type Description
layer ImageryLayer optional 待添加的图层。
index Number optional 待添加图层的索引。
Throws:
  • DeveloperError : 索引值应大于等于0，且小于图层总数量。

addImageryProvider(imageryProvider, index) → ImageryLayer
Scene/ImageryLayerCollection.js 134

通过给定的影像服务提供者SuperMapImageryProvider来新建图层，并将其添加至图层集合中。
Name Type Description
imageryProvider ImageryProvider 指定的影像服务提供者。
index Number optional 待添加图层的索引。
Returns:
新创建的影像图层。
Example:
var imageryLayers = viewer.imageryLayers;
var labelImagery = new Cesium.WebMapTileServiceImageryProvider({
		url : 'http://[subdomain].tianditu.com/cia_w/wmts',
		layer : 'cia',
		style : 'default',
		format : 'tiles',
		tileMatrixSetID : 'w',
		credit : new Cesium.Credit('天地图全球影像中文注记服务'),
		subdomains : ['t0','t1','t2','t3','t4','t5','t6','t7']
	});
	imageryLayers.addImageryProvider(labelImagery);

contains(layer) → Boolean
Scene/ImageryLayerCollection.js 202

判断图层集合中是否包含指定图层。
Name Type Description
layer ImageryLayer 待检查的图层。
Returns:
集合中包含该图层返回true，否则返回false。

get(index) → ImageryLayer
Scene/ImageryLayerCollection.js 224

获取图层集合中指定索引的影像图层对象。
Name Type Description
index Number 索引值。
Returns:
影像图层对象。

indexOf(layer) → Number
Scene/ImageryLayerCollection.js 213

获取指定图层在图层集合中的索引值。
Name Type Description
layer ImageryLayer 指定的图层。
Returns:
图层索引值，若不存在则返回-1。

isDestroyed() → Boolean
Scene/ImageryLayerCollection.js 474

获取是否释放资源。

对象资源被释放后将不再可用，否则将提示DeveloperError。
Returns:
已释放资源返回true，否则返回false。
See:
  • ImageryLayerCollection#destroy

lower(layer)
Scene/ImageryLayerCollection.js 291

将此图层集合中指定图层往下移动一层。
Name Type Description
layer ImageryLayer 待移动的图层。
Throws:
  • DeveloperError : 图层集合中不存在该图层。
  • DeveloperError : This object was destroyed, i.e., destroy() was called.

lowerToBottom(layer)
Scene/ImageryLayerCollection.js 325

将此图层集合中指定图层移动到最底层。
Name Type Description
layer ImageryLayer 待移动的图层。
Throws:
  • DeveloperError : 图层集合中不存在该图层。
  • DeveloperError : This object was destroyed, i.e., destroy() was called.

raise(layer)
Scene/ImageryLayerCollection.js 278

将此图层集合中指定图层往上移动一层。
Name Type Description
layer ImageryLayer 待移动的图层。
Throws:
  • DeveloperError : 图层集合中不存在该图层。
  • DeveloperError : This object was destroyed, i.e., destroy() was called.

raiseToTop(layer)
Scene/ImageryLayerCollection.js 304

将此图层集合中指定图层移动到最顶层。
Name Type Description
layer ImageryLayer 待移动的图层。
Throws:
  • DeveloperError : 图层集合中不存在该图层。
  • DeveloperError : This object was destroyed, i.e., destroy() was called.

remove(layer, destroy) → Boolean
Scene/ImageryLayerCollection.js 153

移除集合中的一个图层。
Name Type Default Description
layer ImageryLayer 待移除的图层。
destroy Boolean true optional 移除时是否释放资源。
Returns:
移除成功返回true，否则返回false。

removeAll(destroy)
Scene/ImageryLayerCollection.js 179

移除图层集合中的所有图层。
Name Type Default Description
destroy Boolean true optional 移除时是否释放资源。