ImageryLayer

new Cesium.ImageryLayer(imageryProvider, options)
Scene/ImageryLayer.js 71

在Globe上显示来自单个图像提供器的瓦片图像数据的图像图层。
Name Type Description
imageryProvider 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。
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表示使用原图。
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 是否显示该图层。
maximumAnisotropy Number maximum supported optional 用于纹理滤波的最大各向异性（anisotropy）级别。 如果未指定此参数，将使用WebGL堆栈支持的最大各向异性。较大的值使图像在地平线上看起来更好。
minimumTerrainLevel Number optional 用于显示该图像图层的最小地形细节级别，或如果未定义则显示所有级别。级别0是最不详细的级别。
maximumTerrainLevel Number optional 用于显示该图像图层的最大地形细节级别，或如果未定义则显示所有级别。级别0是最不详细的级别。
cutoutRectangle Rectangle optional 裁剪此图层的矩形范围。（在图层上挖洞的效果）
colorToAlpha Color optional 颜色用作alpha。
colorToAlphaThreshold Number 0.004 optional color-to-alpha的阈值。

Members

staticCesium.ImageryLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number
Scene/ImageryLayer.js 293

默认的color-to-alpha阈值。
Default Value: 0.004

staticCesium.ImageryLayer.DEFAULT_BRIGHTNESS : Number
Scene/ImageryLayer.js 237

默认的亮度值。此值不修改图像的亮度。
Default Value: 1.0

staticCesium.ImageryLayer.DEFAULT_CONTRAST : Number
Scene/ImageryLayer.js 244

默认的对比度值。此值不修改图像的对比度。
Default Value: 1.0

staticCesium.ImageryLayer.DEFAULT_GAMMA : Number
Scene/ImageryLayer.js 265

默认的伽马校正值。此值不修改图像的伽马校正。
Default Value: 1.0

staticCesium.ImageryLayer.DEFAULT_HUE : Number
Scene/ImageryLayer.js 251

默认的色调值。此值不修改图像的色调。
Default Value: 0.0

staticCesium.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
Scene/ImageryLayer.js 286

默认的纹理放大过滤器。
Default Value: TextureMagnificationFilter.LINEAR

staticCesium.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
Scene/ImageryLayer.js 279

默认的纹理缩小过滤器。
Default Value: TextureMinificationFilter.LINEAR

staticCesium.ImageryLayer.DEFAULT_SATURATION : Number
Scene/ImageryLayer.js 258

默认的饱和度值。此值不修改图像的饱和度。
Default Value: 1.0

staticCesium.ImageryLayer.DEFAULT_SPLIT : ImagerySplitDirection
Scene/ImageryLayer.js 272

默认的图像拆分位置。
Default Value: ImagerySplitDirection.NONE

alpha : Number
Scene/ImageryLayer.js 82

该图层的alpha混合值，0.0表示完全透明，1.0表示完全不透明。
Default Value: 1.0

brightness : Number
Scene/ImageryLayer.js 90

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

colorToAlpha : Color
Scene/ImageryLayer.js 195

颜色值，应设置为透明。

colorToAlphaThreshold : Number
Scene/ImageryLayer.js 202

color-to-alpha的归一化(0-1)阈值。

contrast : Number
Scene/ImageryLayer.js 98

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

cutoutRectangle : Rectangle
Scene/ImageryLayer.js 188

裁剪此图层的矩形范围。（在图层上挖洞的效果）

gamma : Number
Scene/ImageryLayer.js 122

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

hue : Number
Scene/ImageryLayer.js 106

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

readonlyimageryProvider : ImageryProvider
Scene/ImageryLayer.js 213

获取此图层的imageryProvider。

magnificationFilter : TextureMagnificationFilter
Scene/ImageryLayer.js 150

应用于该图层的TextureMagnificationFilter。（值为TextureMagnificationFilter.LINEAR或者TextureMagnificationFilter.NEAREST）。 必须在添加图层之后立即设置此属性。一旦一个纹理被加载，它将不可能改变使用的纹理过滤器。
Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter
Scene/ImageryLayer.js 140

应用于该图层的TextureMinificationFilter（值为TextureMinificationFilter.LINEAR或者TextureMinificationFilter.NEAREST）。 必须在添加图层之后立即设置此属性。一旦一个纹理被加载，它将不可能改变使用的纹理过滤器。
Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

readonlyrectangle : Rectangle
Scene/ImageryLayer.js 225

获取该图层的矩形显示范围。如果这个矩形小于ImageryProvider的矩形，则只显示图像提供器的一部分。

saturation : Number
Scene/ImageryLayer.js 114

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

show : Boolean
Scene/ImageryLayer.js 158

是否显示该图层。
Default Value: true

splitDirection : ImagerySplitDirection
Scene/ImageryLayer.js 130

应用于该图层的ImagerySplitDirection。可控制影像图层仅在分割条的左边或右边区域显示。
Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

destroy()
Scene/ImageryLayer.js 331

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

一旦对象被销毁，它将不能在使用；调用除isDestroyed之外的任何函数都会导致DeveloperError异常。 因此，将返回值(undefined)赋给对象，如示例所示。
Throws:
Example:
layerCollection = layerCollection && layerCollection.destroy();
See:

getViewableRectangle() → Promise.<Rectangle>
Scene/ImageryLayer.js 369

计算此图层的矩形与图像提供器的可用矩形的交集，生成此图层可以生成的图像的总体边界。 即：获取图层的可见范围。
Returns:
一个矩形的promise，它定义了这个图层可以产生的图像的整体边界。
Example:
// 缩放到一个图像图层。
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer() → Boolean
Scene/ImageryLayer.js 301

获取一个值，该值指示此图层是否为ImageryLayerCollection中的基础图层。基础图层在所有其他图层的之下。 它的特殊之处在于，它被当作一个全球矩形来处理，即使它实际上并没有，通过在整个地球中拉伸纹理的边缘来处理。
Returns:
true if this is the base layer; otherwise, false.

isDestroyed() → Boolean
Scene/ImageryLayer.js 314

如果该对象没被销毁，返回false。

如果该对象已经被销毁，使用isDestroyed 会触发 DeveloperError 异常.
Returns:
false
See: