Class: ImageryLayer

ImageryLayer

new ImageryLayer(imageryProvider)

影像图层类，用于显示影像提供者的瓦片影像数据。

Name Type Default Description
imageryProvider ImageryProvider

指定的影像提供者。
options.rectangle Rectangle imageryProvider.rectangle 可选

图层的矩形范围,此矩形限制了影像可见范围。
options.alpha Number | function 1.0 可选

图层透明度值，取值范围为0.0~1.0。
options.brightness Number | function 1.0 可选

图层亮度值。值为1.0表示使用原图；值大于1.0时影像将变亮；值小于1.0时影像将变暗。
options.contrast Number | function 1.0 可选

图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。
options.hue Number | function 0.0 可选

图层色调。值为0.0表示使用原图。
options.saturation Number | function 1.0 可选

图层饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。
options.gamma Number | function 1.0 可选

图层伽马校正。值为1.0表示使用原图。
options.show Boolean true 可选

指定图层是否显示，true表示显示此图层，false表示不显示。
options.splitDirection ImagerySplitDirection | function ImagerySplitDirection.NONE 可选

指定影像图层分割方向。
options.minimumTerrainLevel Number 可选

最小地形细节层次。level 0是最小细节层次。
options.maximumTerrainLevel Number 可选

最大地形细节层次。
Example
var  imageryProvider = new SuperMap3D.SuperMapImageryProvider({
		    url : ‘http://localhost:8090/iserver/services/datas/China’
     });
     //通过影像提供者创建影像图层
var imageryLayer = new SuperMap3D.ImageryLayer(imageryProvider);

Members

alphaNumber

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

Default Value:
1.0

ancestorMaximumLevelNumber

获取或者设置控制影像在目标层级未就绪时，允许向上查找最大层级进行渲染。

Default Value:
undefined 默认不限制向上查找层级
Example
ImageryLayer.ancestorMaximumLevel = 2(建议向上查找2层影像)

brightnessNumber

图层亮度值。值为1.0表示使用原图；值大于1.0时影像将变亮；值小于1.0时影像将变暗。

colorToAlphaColor

应设置为透明的颜色值。

colorToAlphaThresholdNumber

颜色到阿尔法的归一化（0-1）阈值。

contrastNumber

图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。

cutoutRectangleRectangle

这一层图像中的矩形剪切。

filterColorColor

滤镜颜色，设置后将与影像颜色进行混合，内部计算规则为：color=color*filterColor。

gammaNumber

图层伽马校正。值为1.0表示使用原图。

hueNumber

图层色调。值为0.0表示使用原图。

indexedDBSettingObject

获取或者设置影像的indexedDB瓦片是否开启(IE浏览器不支持)

Example
//设置是否保存影像瓦片到浏览器的indexedDB数据库
var imageryLayer = viewer.imageryLayers.get(1);
imageryLayer.indexedDBSetting.isOpen = true;

invertColorEnableBoolean

是否对影像颜色进行取反，内部计算规则为：color=1.0-color。

Default Value:
false

lodOffsetNumber

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

Default Value:
0

magnificationFilterTextureMagnificationFilter

应用于此层的TextureMagnificationFilter。 可能的值包括TextureMagnificationFilter.LINEAR（默认值）和TextureMagnificationFilter.NEAREST。

为了使其生效，必须在添加图像层后立即设置此属性。一旦加载了纹理，就无法更改所使用的纹理过滤器。

Default Value:
ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilterTextureMinificationFilter

应用于此层的TextureMinificationFilter。 可能的值包括 TextureMinificationFilter.LINEAR（默认值）和 TextureMinificationFilter.NEAREST。

为了使其生效，必须在添加图像层后立即设置此属性。一旦纹理加载完成，就无法更改所使用的纹理过滤器。

Default Value:
ImageryLayer.DEFAULT_MINIFICATION_FILTER

nameString

获取影像图层中provider的名称。

Example
var name = ImageryLayer.name;

saturationNumber

图层饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。

showBoolean

指定当前图层是否显示。

Default Value:
true

splitDirectionImagerySplitDirection

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

swipeEnabledBoolean

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

swipeRegionRectangle

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

transparentBackColorColor

设置影像透明色。

transparentBackColorToleranceNumber

设置影像透明色容限，取值范围为0.0~1.0。0.0表示不透明。

Methods

destroy(){undefined}

释放对象占用的资源。

See:
Returns:
Type Description
undefined 返回undefined。
Example
imageryLayer = imageryLayer && imageryLayer.destroy();

getViewableRectangle(){Promise}

获取图层的可见范围。

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

getVisibleInViewport(index){Boolean}

获得图层对应视口可见性

Name Type Description
index Number

索引
Throws:

the index is 0~8

Type
DeveloperError
Returns:
Type Description
Boolean visible 可见性

isBaseLayer(){Boolean}

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

基础图层是特殊的，它被视为具有全局矩形。

Returns:
Type Description
Boolean true表示为基础图层; false则为非基础图层。
Example
var isBaseLayer = imageryLayer.isBaseLayer();

isDestroyed(){Boolean}

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

See:
Returns:
Type Description
Boolean 是否释放占用的资源。

setVisibleInViewport(index, visible)

设置图层对应视口可见性

Name Type Description
index Number

索引
visible Boolean

可见性
Throws:

the index is 0~8

Type
DeveloperError