ImageryLayer

在Globe上显示单个图像提供者的平铺图像数据的图像层。

new ImageryLayer(imageryProvider, options)

Parameters:

imageryProvider (ImageryProvider) 要使用的图像提供商。

options (Object)

Name	Description
options.rectangle `Rectangle` default `imageryProvider.rectangle`	层的矩形。此矩形可以限制图像提供者的可见部分。
options.alpha `(Number \| function)` default `1.0`	该层的alpha混合值，从0.0到1.0。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数将传递图像瓦片的当前帧状态、该层以及需要Alpha的图像瓦片的X、Y和级别坐标，并预期返回用于瓦片的Alpha值。
options.brightness `(Number \| function)` default `1.0`	该层的亮度。1.0使用未修改的图像颜色。小于1.0会使图像变暗，而大于1.0则会使图像变亮。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数传递图像瓦片的当前帧状态、该层以及需要亮度的图像瓦片的X、Y和级别坐标，并期望返回用于瓦片的亮度值。该函数针对每一帧和每一个瓦片执行，因此它必须是快速的。
options.contrast `(Number \| function)` default `1.0`	这层的对比度。1.0使用未修改的图像颜色。小于1.0会降低对比度，大于1.0则会增加对比度。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数传递当前帧状态、该层以及需要对比度的图像瓦片的X、Y和级别坐标，并期望返回用于瓦片的对比度值。该函数针对每一帧和每一个瓦片执行，因此它必须是快速的。
options.hue `(Number \| function)` default `0.0`	这层的色调。0.0使用未修改的图像颜色。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数传递图像瓦片的当前帧状态、该层以及需要色调的图像瓦片的X、Y和级别坐标，并期望返回用于瓦片的对比度值。该函数针对每一帧和每一个瓦片执行，因此它必须是快速的。
options.saturation `(Number \| function)` default `1.0`	这一层的饱和度。1.0使用未修改的图像颜色。小于1.0会降低饱和度，大于1.0则会增加饱和度。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数传递图像瓦片的当前帧状态、该层以及需要饱和度的图像瓦片的X、Y和级别坐标，并期望返回用于瓦片的对比度值。该函数针对每一帧和每一个瓦片执行，因此它必须是快速的。
options.gamma `(Number \| function)` default `1.0`	应用于该层的Gamma校正。1.0使用未修改的图像颜色。这可以是一个简单的数字，也可以是一个带有`function(frameState, layer, x, y, level)`签名的函数。该函数将传递图像瓦片的当前帧状态、该层以及需要gamma的图像瓦片的X、Y和级别坐标，并预期返回用于瓦片的gamma值。该函数针对每一帧和每一个瓦片执行，因此它必须是快速的。
options.splitDirection `(ImagerySplitDirection \| function)` default `ImagerySplitDirection.NONE`	`ImagerySplitDirection`拆分应用于此层。
options.minificationFilter `TextureMinificationFilter` default `TextureMinificationFilter.LINEAR`	应用于此层的纹理缩小过滤器。可能的值是`TextureMinificationFilter.LINEAR`和`TextureMinificationFilter.NEAREST`。
options.magnificationFilter `TextureMagnificationFilter` default `TextureMagnificationFilter.LINEAR`	应用于此层的纹理缩小过滤器。可能的值是`TextureMagnificationFilter.LINEAR`和`TextureMagnificationFilter.NEAREST`。
options.show `Boolean` default `true`	如果显示层，则为true；否则为false。
options.maximumAnisotropy `Number` default `maximum supported`	用于纹理过滤的最大各向异性级别。如果未指定此参数，将使用WebGL堆栈支持的最大各向异性。较大的值使图像在地平线视图中看起来更好。
options.minimumTerrainLevel `Number`	显示此图像层的最低详细地形级别，或未定义显示所有级别的最低详细地形级别。零级是最不详细的级别。
options.maximumTerrainLevel `Number`	显示此图像层的最大详细地形级别，或未定义显示所有级别的最大详细地形级别。零级是最不详细的级别。
options.cutoutRectangle `Rectangle`	用于剪切此图像层的一部分的绘图矩形。
options.colorToAlpha `Color`	要用作alpha的颜色。
options.colorToAlphaThreshold `Number` default `0.004`	颜色到alpha的阈值。

Members

(static) DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number

如果在构造期间或图像提供者未提供颜色到alpha，则该值用作颜色到alpha的默认阈值。

Default Value: 0.004

(static) DEFAULT_BRIGHTNESS : Number

如果在构建期间或图像提供者未提供图像层，则该值用作图像层的默认亮度。该值不会修改图像的亮度。

Default Value: 1.0

(static) DEFAULT_CONTRAST : Number

如果在构建期间或图像提供者未提供图像层，则该值用作图像层的默认对比度。该值不会修改图像的对比度。

Default Value: 1.0

(static) DEFAULT_GAMMA : Number

如果在构建期间或图像提供者未提供图像层，则该值将用作图像层的默认gamma。该值不会修改图像的gamma。

Default Value: 1.0

(static) DEFAULT_HUE : Number

如果在构建期间或图像提供者没有提供图像层，则该值将用作图像层的默认色调。该值不会修改图像的色调。

Default Value: 0.0

(static) DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果在构建期间或图像提供者未提供图像层，则该值用作图像层的默认纹理放大过滤器。

Default Value: TextureMagnificationFilter.LINEAR

(static) DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果在构建期间或图像提供者未提供纹理缩小过滤器，则该值用作图像层的默认纹理缩小过滤器。

Default Value: TextureMinificationFilter.LINEAR

(static) DEFAULT_SATURATION : Number

如果在构建期间或图像提供者未提供图像层，则该值用作图像层的默认饱和度。该值不会修改图像的饱和度。

Default Value: 1.0

(static) DEFAULT_SPLIT : ImagerySplitDirection

如果在构建期间或图像提供者未提供图像层，则该值用作图像层的默认分割。

Default Value: ImagerySplitDirection.NONE

alpha : Number

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

Default Value: 1.0

brightness : Number

该层的亮度。1.0使用未修改的图像颜色。小于1.0会使图像变暗，而大于1.0则会使图像变亮。

Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

colorToAlpha : Color

应设置为透明的颜色值。

colorToAlphaThreshold : Number

颜色到alpha的标准化（0-1）阈值。

contrast : Number

这层的对比度。1.0使用未修改的图像颜色。小于1.0会降低对比度，大于1.0则会增加对比度。

Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle

在这一层图像中的矩形切口。

gamma : Number

应用于该层的Gamma校正。1.0使用未修改的图像颜色。

Default Value: ImageryLayer.DEFAULT_GAMMA

hue : Number

这层的色调以弧度表示。0.0使用未修改的图像颜色。

Default Value: ImageryLayer.DEFAULT_HUE

(readonly) imageryProvider : ImageryProvider

获取此层的图像提供程序。

magnificationFilter : TextureMagnificationFilter

应用于该层的TextureMagnificationFilter。可能的值是TextureMagnificationFilter.LINEAR（默认值）和TextureMagnificationFilter.NEAREST。要生效，必须在添加图像层后立即设置此属性。加载纹理后，将无法更改所使用的纹理过滤器。

Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

应用于该层的TextureMinificationFilter。可能的值是TextureMinificationFilter.LINEAR（默认值）和TextureMinificationFilter.NEAREST。要生效，必须在添加图像层后立即设置此属性。加载纹理后，将无法更改所使用的纹理过滤器。

Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

(readonly) rectangle : 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()

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

一旦对象被破坏，就不应使用它；调用除isDestroyed以外的任何函数都将导致DeveloperError异常。因此，将返回值（undefined）赋给对象，如示例中所述。

Example

imageryLayer = imageryLayer && imageryLayer.destroy();

Throws

DeveloperError : 此对象已被销毁，即调用destroy（）。

See:

ImageryLayer#isDestroyed

getViewableRectangle() → {Promise.<Rectangle>}

计算该层矩形与图像提供者的可用性矩形的交集，生成该层可以生成的图像的整体边界。

Example

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

isBaseLayer() → {Boolean}

获取一个值，该值指示此层是否是ImageryLayerCollection中的基础层。底层是所有其他层的底层。它的特殊之处在于，它被视为具有全局矩形，即使它实际上不具有全局矩形，通过在整个地球的边缘拉伸texel。

isDestroyed() → {Boolean}

如果此对象被破坏，则返回true；否则返回false。

如果此对象被破坏，则不应使用它；调用除isDestroyed以外的任何函数将导致DeveloperError异常。

See:

ImageryLayer#destroy