ImageryLayer

new LSGlobe.ImageryLayer(imageryProvider, options)

在Globe上显示来自单个图像提供者的图像
Name Type Description
imageryProvider ImageryProvider 要使用的映像图层
options Object optional 对象具有以下属性:
Name Type Default Description
rectangle Rectangle imageryProvider.rectangle optional 图层的矩形范围,此矩形限制了影像可见范围
alpha Number | function 1.0 optional 这个图层的alpha值从0.0到1.0.这可以是一个简单的数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的alpha值，然后将返回的alpha值应用到瓦片上。
brightness Number | function 1.0 optional 图层的亮度。小于1.0图层变暗，大于1.0图层变亮。这个图层的亮度值这个值可以是一个简单数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的亮度值，然后将返回的亮度值应用到瓦片上。该函数每帧对每个瓦块都执行，因此它必须是快速的。
contrast Number | function 1.0 optional 图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。这个值可以是一个简单数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的对比度，然后将返回的对比度应用到瓦片上。该函数每帧对每个瓦块都执行，因此它必须是快速的。
hue Number | function 0.0 optional 图层色调。值为0.0表示使用原图颜色。这个值可以是一个简单数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的图层色调，然后将返回的图层色调应用到瓦片上。该函数每帧对每个瓦块都执行，因此它必须是快速的。
saturation Number | function 1.0 optional 图层饱和度。值为1.0表示使用原图；值大于1.0表示增加饱和度；值小于1.0表示降低饱和度。这个值可以是一个简单数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的饱和度，然后将返回的饱和度应用到瓦片上。该函数每帧对每个瓦块都执行，因此它必须是快速的。
gamma Number | function 1.0 optional 图层伽马校正。值为1.0表示使用原图。。这个值可以是一个简单数字，也可以是一个签名函数（frameState,layer,x,y,level）。该函数通过当前帧状态、图层、图层的xy值、瓦片的水平坐标需要的伽马值，然后将返回的伽马值应用到瓦片上。该函数每帧对每个瓦块都执行，因此它必须是快速的。
splitDirection ImagerySplitDirection | function ImagerySplitDirection.NONE optional ImagerySplitDirection 分割应用于此图层
minificationFilter TextureMinificationFilter TextureMinificationFilter.LINEAR optional 纹理缩小过滤器适用于此图层。可能的值是TextureMinificationFilter.LINEAR 和 TextureMinificationFilter.NEAREST
magnificationFilter TextureMagnificationFilter TextureMagnificationFilter.LINEAR optional 纹理放大过滤器适用于此图层。可能的值是TextureMagnificationFilter.LINEAR 和 TextureMagnificationFilter.NEAREST
show Boolean true optional 指定图层是否显示，true表示显示此图层，false表示不显示
maximumAnisotropy Number maximum supported optional 用于纹理过滤的最大各向异性水平。如果没有指定此参数，将使用WebGL堆栈支持的最大各向异性。更大的值使图像在地平线上看起来效果更好
minimumTerrainLevel Number optional 显示该图像层的最小地形细节级别，或未定义显示该图像的所有级别。0级是最不详细的级别
maximumTerrainLevel Number optional 显示该图像层的最大地形细节级别，或未定义显示该图像的所有级别。0级是最不详细的级别

Members

staticLSGlobe.ImageryLayer.DEFAULT_BRIGHTNESS : Number

如果在构建过程中或图像提供商未提供此值，则此值将用作影像图层的默认亮度。 该值不会修改图像的亮度
Default Value: 1.0

staticLSGlobe.ImageryLayer.DEFAULT_CONTRAST : Number

如果在构建过程中或图像提供商未提供此值，则此值将用作影像图层的默认对比度。 该值不会修改图像的对比度
Default Value: 1.0

staticLSGlobe.ImageryLayer.DEFAULT_GAMMA : Number

如果在构建过程中或图像提供者未提供此值，则此值将用作图像层的默认灰度系数。 该值不会修改图像的灰度系数
Default Value: 1.0

staticLSGlobe.ImageryLayer.DEFAULT_HUE : Number

如果在构建过程中或图像提供者未提供此值，则此值将用作图像层的默认色调。 该值不会修改图像的色调
Default Value: 0.0

staticLSGlobe.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果在构建期间或图像提供者没有提供该值，则该值将用作图像层的默认纹理放大过滤器
Default Value: TextureMagnificationFilter.LINEAR

staticLSGlobe.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果在构建期间或图像提供者没有提供该值，则该值将用作图像层的默认纹理缩小过滤器
Default Value: TextureMinificationFilter.LINEAR

staticLSGlobe.ImageryLayer.DEFAULT_SATURATION : Number

如果在构建过程中或图像提供者未提供此值，则此值将用作图像层的默认饱和度。 该值不会修改图像的饱和度
Default Value: 1.0

staticLSGlobe.ImageryLayer.DEFAULT_SPLIT : ImagerySplitDirection

如果在构建过程中或图像提供者未提供此值，则此值将用作图像层的默认Spliat
Default Value: ImagerySplitDirection.NONE

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

gamma : Number

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

hue : Number

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

readonlyimageryProvider : ImageryProvider

获取此图层的图像提供者

magnificationFilter : TextureMagnificationFilter

TextureMagnificationFilter应用于此图层。可能的值是TextureMagnificationFilter.LINEAR (the default)和 TextureMagnificationFilter.NEAREST.这个属性必须在添加图层之后立即设置才能生效，否则，一旦加载了纹理，就不能更改所使用的纹理过滤器
Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

TextureMinificationFilter应用于此图层。可能的值是TextureMinificationFilter.LINEAR (the default)和 TextureMinificationFilter.NEAREST.这个属性必须在添加图层之后立即设置才能生效，否则，一旦加载了纹理，就不能更改所使用的纹理过滤器
Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

readonlyrectangle : Rectangle

获取此图层的矩形。如果此矩形小于ImageryProvider的矩形，则只显示图像提供者的一部分

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

Methods

destroy() → undefined

销毁这个对象所持有的WebGL资源。销毁一个对象允许WebGl资源确定性释放，而不是依赖垃圾收集器来销毁这个对象

一旦对象被销毁，就不应该再使用它。调用isDestroyed以外的任何函数都会导致 DeveloperError异常。因此，将返回值(undefined) 赋给对象，如示例所示。
Returns:
Throws:
  • DeveloperError : 这个对象被销毁了，也就是说，调用了destroy()
Example:
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

getViewableRectangle() → Promise.<Rectangle>

获取图层的可见范围
Returns:
矩形对象，表示图层可见范围
Example:
// 放大到imageryLayer图层.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer() → Boolean

判断该图层是否为影像图层集合ImageryLayerCollection中的基础图层。 基础图层是特殊的，它被视为具有全局矩形。
Returns:
true表示为基础图层; false则为非基础图层

isDestroyed() → Boolean

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

If this object was destroyed, it should not be used; calling any function other thanisDestroyed will result in a DeveloperError exception.
Returns:
如果资源被释放返回true，否则返回false
See: