ImageryLayer

Members

alpha : Number

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

Default Value: 1.0

ancestorMaximumLevel

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

Default Value: undefined 默认不限制向上查找层级

Example:

ImageryLayer.ancestorMaximumLevel = 2(建议向上查找2层影像)

brightness : Number

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

contrast : Number

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

enableUpsample : Boolean

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

gamma : Number

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

hue : Number

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

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表示降低饱和度。

show : Boolean

指定当前图层是否显示。

Default Value: true

splitDirection : ImagerySplitDirection

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

swipeEnabled : Boolean

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

swipeRegion : Rectangle

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

transparentBackColor : Color

设置影像透明色。

transparentBackColorTolerance : Number

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

Methods

destroy() → undefined

释放对象占用的资源。

Returns:

返回undefined。

Example:

imageryLayer = imageryLayer && imageryLayer.destroy();

See:

• ImageryLayer#isDestroyed

getViewableRectangle() → Promise

获取图层的可见范围。

Returns:

矩形对象，表示图层可见范围。

Example:

// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

getVisibleInViewport(index) → Boolean

获得图层对应的视口的可见性。

Name	Type	Description
index	Number	视口的索引。

Returns:

visible 指定索引的视口的可见性。

Throws:

• DeveloperError : 索引为 0~3。

isBaseLayer() → Boolean

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

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

Returns:

true表示为基础图层; false则为非基础图层。

Example:

var isBaseLayer = imageryLayer.isBaseLayer();

isDestroyed() → Boolean

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

Returns:

是否释放占用的资源。

See:

• ImageryLayer#destroy

setLayerStatusParameters(v) → *

设置地图子图层的过滤条件。 注意：layerName对应的是桌面软件图层属性里的图层名称不是图层标题。

Name	Type	Description
v	Array	过滤条件的数组

Returns:

Promise

Throws:

• DeveloperError

Example:

普通服务过滤:
var layer = viewer.imageryLayers.addImageryProvider(new SuperMap3D.SuperMapImageryProvider({
                url: 'http/……/maps/……',
            }));
            var params = [{
                layerName: '线1',
                isVisible: true,
                displayFilter: "stadedate2<20131024"
            },
            {
                layerName: '线2',
                isVisible: false,
            }];
            layer.setLayerStatusParameters(params).then(res => {
                //dosomething
            })
图层组服务过滤:
var layer = viewer.imageryLayers.addImageryProvider(new SuperMap3D.SuperMapImageryProvider({
                url: 'http/……/maps/……',
            }));
            var layers = layerName; //子图层名字
            let params = [];
            for (var i = 0; i < layers.length; i++) {
                //图层组数组
                var layerGroupParams = {
                    layerName: layers[i].name,
                    isVisible: true,
                    subLayers: []
                }
                //子图层数组
                var subLayerParams = layers[i].subLayers.layers;
                for (var j = 0; j < subLayerParams.length; j++) {
                    var secondParam = {
                        type: "UGC",
                        layerName: subLayerParams[j].name,
                        isVisible: true,
                        displayFilter: 'SmID<4',
                    };
                    layerGroupParams.subLayers.push(secondParam)
                }

                params.push(layerGroupParams);
            }
            layer.setLayerStatusParameters(params).then(res => {
            })

setVisibleInViewport(index, visible)

根据索引设置图层对应视口可见性。

Name	Type	Description
index	Number	视口的索引。
visible	Boolean	视口的可见性。

Throws:

• DeveloperError : 索引为 0~3。