ImageryLayer

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

显示来自单个图像提供者的平铺图像数据的图像层在 Globe 上。
Name Type Description
imageryProvider ImageryProvider 要使用的图像提供程序。
options Object optional Object with the following properties:
Name Type Default Description
rectangle Rectangle imageryProvider.rectangle 可选 图层的矩形。这个矩形       可以限制图像提供者的可见部分。
alpha Number | function 1.0 可选 该层的alpha混合值，从0.0到1.0。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         需要Alpha且返回的图像图块                         用于图块的Alpha值。
brightness Number | function 1.0 可选 该层的亮度。 1.0使用未修改的图像                         颜色。小于1.0会使图像变暗，而大于1.0会使图像变亮。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         需要亮度并有望返回的图像图块                         用于图块的亮度值。每次执行该功能                         框架和每个图块，因此必须快。
contrast Number | function 1.0 可选 这层的对比。 1.0使用未修改的图像颜色。                         小于1.0会降低对比度，而大于1.0则会提高对比度。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         需要对比度并且可以返回的图像图块                         用于图块的对比度值。每次执行该功能                         框架和每个图块，因此必须快。
hue Number | function 0.0 可选 该层的色调。 0.0使用未修改的图像颜色。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         需要色调并返回的图像图块的                         用于图块的对比度值。每次执行该功能                         框架和每个图块，因此必须快。
saturation Number | function 1.0 可选 该层的饱和度。 1.0使用未修改的图像颜色。                         小于1.0会降低饱和度，而大于1.0则会增加饱和度。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         要求饱和度的图像图块的，预计会返回                         用于图块的对比度值。每次执行该功能                         框架和每个图块，因此必须快。
gamma Number | function 1.0 可选 应用于此图层的伽马校正。 1.0使用未修改的图像颜色。                         这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过                         当前帧状态，该层以及x，y和级别坐标                         需要使用伽玛值并且期望返回的图像图块                         用于图块的伽玛值。每次执行该功能                         框架和每个图块，因此必须快。
splitDirection ImagerySplitDirection | function ImagerySplitDirection.NONE 可选 ImagerySplitDirection 拆分以应用于此图层。
minificationFilter TextureMinificationFilter TextureMinificationFilter.LINEAR 可选 的                                   纹理最小化滤镜应用到此层。可能的值                                   是 TextureMinificationFilter.LINEAR 和 TextureMinificationFilter.NEAREST 。
magnificationFilter TextureMagnificationFilter TextureMagnificationFilter.LINEAR 可选 的                                    纹理最小化滤镜应用到此层。可能的值                                    是 TextureMagnificationFilter.LINEAR 和 TextureMagnificationFilter.NEAREST 。
show Boolean true 可选 如果显示该层，则为true；否则为false。否则为false。
maximumAnisotropy Number maximum supported 可选 使用的最大各向异性水平       用于纹理过滤。如果未指定此参数，则支持最大各向异性       将使用WebGL堆栈。较大的值可使影像在水平方向上看起来更好       视图。
minimumTerrainLevel Number 可选 显示此图像图层的最小地形细节级别，                或未定义以在所有级别显示它。级别零是最不详细的级别。
maximumTerrainLevel Number 可选 显示此影像图层的最大地形细节级别，                或未定义以在所有级别显示它。级别零是最不详细的级别。
cutoutRectangle Rectangle 可选 制图矩形，用于裁剪此ImageryLayer的一部分。
colorToAlpha Color 可选 用作Alpha的颜色。
colorToAlphaThreshold Number 0.004 可选 颜色到Alpha的阈值。
翻译by:http://cesium.xin

Members

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

如果未提供此值，则将其用作颜色到alpha的默认阈值在施工过程中或由图像提供者进行。
Default Value: 0.004

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

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

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

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

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

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

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

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

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

如果未提供此值，则将其用作图像图层的默认纹理放大滤镜在施工过程中或由图像提供者进行。
Default Value: TextureMagnificationFilter.LINEAR

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

如果未提供此值，则将其用作图像图层的默认纹理最小化滤镜在施工过程中或由图像提供者进行。
Default Value: TextureMinificationFilter.LINEAR

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

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

static Cesium.ImageryLayer.DEFAULT_SPLIT : ImagerySplitDirection
Scene/ImageryLayer.js 374

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

alpha : Number
Scene/ImageryLayer.js 172

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

brightness : Number
Scene/ImageryLayer.js 181

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

colorToAlpha : Color
Scene/ImageryLayer.js 294

应设置为透明的颜色值。

colorToAlphaThreshold : Number
Scene/ImageryLayer.js 301

归一化颜色的标准（0-1）阈值。

contrast : Number
Scene/ImageryLayer.js 190

这层的对比。 1.0使用未修改的图像颜色。小于1.0减少大于1.0时，对比度增加。
Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle
Scene/ImageryLayer.js 287

此图像图层中的矩形切口。

gamma : Number
Scene/ImageryLayer.js 215

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

hue : Number
Scene/ImageryLayer.js 198

该层的色调（弧度）。 0.0使用未修改的图像颜色。
Default Value: ImageryLayer.DEFAULT_HUE

readonly imageryProvider : ImageryProvider
Scene/ImageryLayer.js 312

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

magnificationFilter : TextureMagnificationFilter
Scene/ImageryLayer.js 249

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

minificationFilter : TextureMinificationFilter
Scene/ImageryLayer.js 236

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

readonly rectangle : Rectangle
Scene/ImageryLayer.js 325

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

saturation : Number
Scene/ImageryLayer.js 207

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

show : Boolean
Scene/ImageryLayer.js 257

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

splitDirection : ImagerySplitDirection
Scene/ImageryLayer.js 223

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

Methods

destroy ()
Scene/ImageryLayer.js 443

销毁此对象拥有的WebGL资源。销毁对象可以确定性释放WebGL资源，而不是依靠垃圾回收器来破坏此对象。

一旦物体被破坏，就不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。因此，如示例中所述，将返回值（ undefined ）分配给对象。
Throws:
Example: 
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

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

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

isBaseLayer () → Boolean
Scene/ImageryLayer.js 409

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

isDestroyed () → Boolean
Scene/ImageryLayer.js 423

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

如果该对象被破坏，则不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。
Returns:
如果该对象被破坏，则为true；否则为假。
See: