ImageryLayer - Cesium Documentation

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:

ImageryLayer#isDestroyed

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 than isDestroyed will result in a DeveloperError exception.

Returns:

如果资源被释放返回true，否则返回false

See:

ImageryLayer#destroy