ImageryLayer

new SuperMap3D.ImageryLayer(imageryProvider, options)

影像图层类，用于显示影像提供者的瓦片影像数据。
Name Type Description
imageryProvider SuperMapImageryProvider 指定的影像提供者。
options Object optional 对象具有以下属性:
Name Type Default Description
rectangle Rectangle imageryProvider.rectangle optional 图层的矩形范围,此矩形限制了影像可见范围。
alpha Number | function 1.0 optional 图层透明度值，取值范围为0.0~1.0。
brightness Number | function 1.0 optional 图层亮度值。值为1.0表示使用原图；值大于1.0时影像将变亮；值小于1.0时影像将变暗。
contrast Number | function 1.0 optional 图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。
hue Number | function 0.0 optional 图层色调。值为0.0表示使用原图。
saturation Number | function 1.0 optional 图层饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。
gamma Number | function 1.0 optional 图层伽马校正。值为1.0表示使用原图。
show Boolean true optional 指定图层是否显示，true表示显示此图层，false表示不显示。
splitDirection ImagerySplitDirection | function ImagerySplitDirection.NONE optional 指定影像图层分割方向。
minimumTerrainLevel Number optional 最小地形细节层次。level 0是最小细节层次。
maximumTerrainLevel Number optional 最大地形细节层次。
Example:
var  imageryProvider = new SuperMap3D.SuperMapImageryProvider({
		    url : ‘http://localhost:8090/iserver/services/datas/China’
     });
     //通过影像提供者创建影像图层
var imageryLayer = new SuperMap3D.ImageryLayer(imageryProvider);

Members

alpha : Number

图层透明度值，取值范围为0.0~1.0。0.0表示完全透明；1.0表示完全不透明。
Default Value: 1.0

brightness : Number

图层亮度值。值为1.0表示使用原图；值大于1.0时影像将变亮；值小于1.0时影像将变暗。
Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

contrast : Number

图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。
Default Value: ImageryLayer.DEFAULT_CONTRAST

enableUpsample : Boolean

子瓦片的影像请求失败时会采用父瓦片的影像，默认值：true（当四个子tile中只有部分有数据时，可设置为false，防止影像错乱）

gamma : Number

图层伽马校正。值为1.0表示使用原图。
Default Value: ImageryLayer.DEFAULT_GAMMA

hue : Number

图层色调。值为0.0表示使用原图。
Default Value: ImageryLayer.DEFAULT_HUE

indexedDBSetting : Object

获取或者设置影像的indexedDB瓦片是否开启(IE浏览器不支持)
Example:
//设置是否保存影像瓦片到浏览器的indexedDB数据库
var imageryLayer = viewer.imageryLayers.get(1);
imageryLayer.indexedDBSetting.isOpen = true;

lodOffset : Number

获取或设置加载影像图层时的偏移量。这里的偏移是指细节层次上的偏移，值越大，细节层越往上偏移，加载的影像图层越精细，影像越清晰，值为负时更影像模糊。 注：这里的值只能设置为整数。默认值为0，不偏移。
Default Value: 0

name : String

获取影像图层中provider的名称。
Example:
var name = ImageryLayer.name;

saturation : Number

图层饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。
Default Value: ImageryLayer.DEFAULT_SATURATION

show : Boolean

指定当前图层是否显示。
Default Value: true

splitDirection : ImagerySplitDirection

指定影像图层分割方向ImagerySplitDirection，可控制影像图层仅在分割条的左侧或右侧区域显示。
Default Value: ImageryLayer.DEFAULT_SPLIT

swipeEnabled : Boolean

获取或者设置是否开启卷帘功能。

swipeRegion : Rectangle

获取或者设置卷帘的四边形区域。

transparentBackColor : Color

设置影像透明色。
Default Value: ImageryLayer.DEFAULT_TRANSPARENTBACKCOLOR

transparentBackColorTolerance : Number

设置影像透明色容限，取值范围为0.0~1.0。0.0表示不透明。
Default Value: ImageryLayer.DEFAULT_TRANSPARENTBACKCOLORTOLERANCE

Methods

destroy() → undefined

释放对象占用的资源。
Returns:
返回undefined。
Example:
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

getViewableRectangle() → Promise

获取图层的可见范围。
Returns:
矩形对象，表示图层可见范围。
Example:
// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer() → Boolean

判断该图层是否为影像图层集合ImageryLayerCollection中的基础图层。

基础图层是特殊的，它被视为具有全局矩形。
Returns:
true表示为基础图层; false则为非基础图层。
Example:
var isBaseLayer = imageryLayer.isBaseLayer();

isDestroyed() → Boolean

返回是否释放对象占用的资源。
Returns:
是否释放占用的资源。
See:

setVisibleInViewport(index, visible)

根据索引设置图层对应视口可见性。
Name Type Description
index Number 视口的索引。
visible Boolean 视口的可见性。
Throws: