ImageryLayer

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

一个图像层，它在 Globe 上显示来自单个图像提供者的平铺图像数据。
Name Type Description
imageryProvider ImageryProvider 要使用的图像提供程序。
options Object 具有以下属性的 可选 对象:
姓名 类型 默认 描述
rectangle 长方形 imageryProvider.rectangle 可选 图层的矩形。这个矩形可以限制图像提供者的可见部分。
alpha 号码 | 功能 1.0 可选 此图层的 alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、此图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于图块的 alpha 值。
nightAlpha 号码 | 功能 1.0 可选 此图层在地球夜晚一侧的 alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、此图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于图块的 alpha 值。这仅在 enableLighting 为 true 时生效。
dayAlpha 号码 | 功能 1.0 可选 此图层在地球日侧的 alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、此图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于图块的 alpha 值。这仅在 enableLighting 为 true 时生效。
brightness 号码 | 功能 1.0 可选 此图层的亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像更暗，而大于 1.0 会使图像更亮。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、该图层以及需要亮度的图像瓦片的 x、y 和级别坐标，并期望返回用于瓦片的亮度值。该函数针对每一帧和每一个图块执行，因此它必须是快速的。
contrast 号码 | 功能 1.0 可选 此层的对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度，而大于 1.0 会增加对比度。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、该图层以及需要对比度的图像瓦片的 x、y 和级别坐标，并期望返回用于瓦片的对比度值。该函数针对每一帧和每一个图块执行，因此它必须是快速的。
hue 号码 | 功能 0.0 可选 此图层的色调。 0.0 使用未修改的图像颜色。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、该图层以及需要色调的图像平铺的 x、y 和级别坐标，并且预计会返回用于平铺的对比度值。该函数针对每一帧和每一个图块执行，因此它必须是快速的。
saturation 号码 | 功能 1.0 可选 该层的饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度，而大于 1.0 会增加饱和度。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数会传递当前帧状态、该图层以及需要饱和度的图像平铺的 x、y 和级别坐标，并且预计会返回用于平铺的对比度值。该函数针对每一帧和每一个图块执行，因此它必须是快速的。
gamma 号码 | 功能 1.0 可选 应用于该层的伽马校正。 1.0 使用未修改的图像颜色。这可以是一个简单的数字，也可以是带有签名 function(frameState, layer, x, y, level) 的函数。该函数将传递当前帧状态、该层以及需要伽玛的图像瓦片的 x、y 和级别坐标，并且预期返回用于瓦片的伽玛值。该函数针对每一帧和每一个图块执行，因此它必须是快速的。
splitDirection 分割方向 | 功能 SplitDirection.NONE 可选 要应用于此层的 SplitDirection 拆分。
minificationFilter 纹理缩小过滤器 TextureMinificationFilter.LINEAR 可选 要应用于此图层的纹理缩小过滤器。可能的值为 TextureMinificationFilter.LINEAR 和 TextureMinificationFilter.NEAREST 。
magnificationFilter 纹理放大过滤器 TextureMagnificationFilter.LINEAR 可选 要应用于此图层的纹理缩小过滤器。可能的值为 TextureMagnificationFilter.LINEAR 和 TextureMagnificationFilter.NEAREST 。
show 布尔值 true 可选 如果图层显示为真；否则为假。
maximumAnisotropy 数字 maximum supported 可选 用于纹理过滤的最大各向异性级别。如果未指定此参数，将使用 WebGL 堆栈支持的最大各向异性。较大的值使图像在地平线视图中看起来更好。
minimumTerrainLevel 数字 可选 显示此影像图层的最小地形细节层次，或未定义以在所有层次上显示。零级是最不详细的级别。
maximumTerrainLevel 数字 可选 显示此影像图层的最大地形细节级别，或未定义以在所有级别显示。零级是最不详细的级别。
cutoutRectangle 长方形 可选 的制图矩形，用于切割此 ImageryLayer 的一部分。
colorToAlpha 颜色 可选 颜色用作 alpha。
colorToAlphaThreshold 数字 0.004 颜色到 alpha 的 可选 阈值。

Members

static Cesium.ImageryLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number
Scene/ImageryLayer.js 431

如果在构建期间或图像提供者未提供此值，则此值用作颜色到 Alpha 的默认阈值。
Default Value: 0.004

static Cesium.ImageryLayer.DEFAULT_BRIGHTNESS : Number
Scene/ImageryLayer.js 371

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

static Cesium.ImageryLayer.DEFAULT_CONTRAST : Number
Scene/ImageryLayer.js 378

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

static Cesium.ImageryLayer.DEFAULT_GAMMA : Number
Scene/ImageryLayer.js 399

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

static Cesium.ImageryLayer.DEFAULT_HUE : Number
Scene/ImageryLayer.js 385

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

static Cesium.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
Scene/ImageryLayer.js 423

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

static Cesium.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
Scene/ImageryLayer.js 415

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

static Cesium.ImageryLayer.DEFAULT_SATURATION : Number
Scene/ImageryLayer.js 392

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

static Cesium.ImageryLayer.DEFAULT_SPLIT : SplitDirection
Scene/ImageryLayer.js 407

如果在构建期间或图像提供者未提供此值，则此值将用作图像图层的默认拆分。
Default Value: SplitDirection.NONE

alpha : Number
Scene/ImageryLayer.js 140

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

brightness : Number
Scene/ImageryLayer.js 176

该层的亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像更暗，而大于 1.0 会使图像更亮。
Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

colorToAlpha : Color
Scene/ImageryLayer.js 325

应设置为透明的颜色值。

colorToAlphaThreshold : Number
Scene/ImageryLayer.js 332

颜色到 alpha 的标准化 (0-1) 阈值。

contrast : Number
Scene/ImageryLayer.js 191

该层的对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度，而大于 1.0 会增加对比度。
Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle
Scene/ImageryLayer.js 318

这层图像中的矩形切口。

dayAlpha : Number
Scene/ImageryLayer.js 164

该图层在地球日侧的 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。这仅在 Globe#enableLighting 为 true 时生效。
Default Value: 1.0

gamma : Number
Scene/ImageryLayer.js 228

应用于此图层的伽马校正。 1.0 使用未修改的图像颜色。
Default Value: ImageryLayer.DEFAULT_GAMMA

hue : Number
Scene/ImageryLayer.js 202

该层的色调以弧度为单位。 0.0 使用未修改的图像颜色。
Default Value: ImageryLayer.DEFAULT_HUE

readonly imageryProvider : ImageryProvider
Scene/ImageryLayer.js 345

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

magnificationFilter : TextureMagnificationFilter
Scene/ImageryLayer.js 274

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

minificationFilter : TextureMinificationFilter
Scene/ImageryLayer.js 255

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

nightAlpha : Number
Scene/ImageryLayer.js 152

该图层在地球夜晚的 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。这仅在 Globe#enableLighting 为 true 时生效。
Default Value: 1.0

readonly rectangle : Rectangle
Scene/ImageryLayer.js 358

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

saturation : Number
Scene/ImageryLayer.js 214

该层的饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度，而大于 1.0 会增加饱和度。
Default Value: ImageryLayer.DEFAULT_SATURATION

show : Boolean
Scene/ImageryLayer.js 288

确定是否显示此层。
Default Value: true

splitDirection : SplitDirection
Scene/ImageryLayer.js 239

应用于此图层的 SplitDirection 。
Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

destroy ()
Scene/ImageryLayer.js 476

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

一旦一个对象被销毁，它就不应该被使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。因此，如示例中所做的那样，将返回值 ( undefined ) 分配给对象。
Throws:
Example: 
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

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

计算该层的矩形与图像提供者的可用性矩形的交集，生成该层可以生成的图像的总体边界。
Returns:
对定义该层可以生成的图像的总体边界的矩形的承诺。
Example: 
// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer () → Boolean
Scene/ImageryLayer.js 442

获取一个值，该值指示此图层是否为 ImageryLayerCollection 中的基础图层。基础层是所有其他层的基础。它的特殊之处在于它被视为具有全局矩形，即使它实际上没有，通过在整个地球上拉伸边缘处的纹素。
Returns:
如果这是基础层，则为 true；否则为假。

isDestroyed () → Boolean
Scene/ImageryLayer.js 456

如果此对象被销毁，则返回 true；否则为假。

如果该对象被销毁，则不应使用；调用 isDestroyed 以外的任何函数都会导致 DeveloperError 异常。
Returns:
如果此对象被销毁，则为真；否则为假。
See: