ImageryLayer

new Cesium.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。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要alpha的图像块,它预计会返回 要用于平铺的alpha值。
nightAlpha Number | function 1.0 optional 该层在地球夜间的alpha混合值,从0.0到1.0。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要alpha的图像块,它预计会返回 要用于平铺的alpha值。这只在enableLightingtrue时生效。
dayAlpha Number | function 1.0 optional 该层在地球白天一侧的alpha混合值,从0.0到1.0。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要alpha的图像块,它预计会返回 要用于平铺的alpha值。这只在enableLightingtrue时生效。
brightness Number | function 1.0 optional 这层的亮度。1.0使用未修改的图像 颜色。小于1.0会使图像变暗,大于1.0会使图像更亮。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要亮度的图像块,并且预期会返回 要用于平铺的亮度值。此函数针对每个 框架和每一个瓷砖,所以它必须是快速的。
contrast Number | function 1.0 optional 这层的对比度。1.0使用未修改的图像颜色。 小于1.0会降低对比度,大于1.0会增加对比度。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要对比度的图像块,并且预期会返回 要用于平铺的对比度值。此函数针对每个 框架和每一个瓷砖,所以它必须是快速的。
hue Number | function 0.0 optional 这层的色调。0.0使用未修改的图像颜色。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及x、y和level坐标 所需色调的图像块的颜色,并且预期将返回 要用于平铺的对比度值。此函数针对每个 框架和每一个瓷砖,所以它必须是快速的。
saturation Number | function 1.0 optional 这层的饱和度。1.0使用未修改的图像颜色。 小于1.0会降低饱和度,大于1.0会增加饱和度。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及x、y和level坐标 需要饱和度的图像块的值,并且它预计会返回 要用于平铺的对比度值。此函数针对每个 框架和每一个瓷砖,所以它必须是快速的。
gamma Number | function 1.0 optional 要应用于此层的gamma校正。1.0使用未修改的图像颜色。 它可以是一个简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level)函数被传递给 当前帧状态、此层以及 需要gamma的图像块,它预计会返回 要用于平铺的gamma值。此函数针对每个 框架和每一个瓷砖,所以它必须是快速的。
splitDirection ImagerySplitDirection | function ImagerySplitDirection.NONE optional 应用于此层的ImagerySplitDirection拆分。
minificationFilter TextureMinificationFilter TextureMinificationFilter.LINEAR optional 这个 应用于此层的纹理缩小过滤器。可能的值 6861166和 TextureMinificationFilter.NEAREST
magnificationFilter TextureMagnificationFilter TextureMagnificationFilter.LINEAR optional 这个 应用于此层的纹理缩小过滤器。可能的值 6861166和 TextureMagnificationFilter.NEAREST
show Boolean true optional 如果显示图层,则为True;否则为false。
maximumAnisotropy Number maximum supported optional 要使用的最大各向异性级别 用于纹理过滤。如果未指定此参数,则支持的最大各向异性 将使用WebGL堆栈。较大的值使图像在地平线上看起来更好 意见。
minimumTerrainLevel Number optional 显示该图像层的最低地形细节级别, 或未定义在所有级别显示。零级是最不详细的级别。
maximumTerrainLevel Number optional 显示该图像层的最大地形细节级别, 或未定义在所有级别显示。零级是最不详细的级别。
cutoutRectangle Rectangle optional 用于剪切此图像层的一部分的绘图矩形。
colorToAlpha Color optional 要用作alpha的颜色。
colorToAlphaThreshold Number 0.004 optional 颜色到alpha的阈值。

Members

static Cesium.ImageryLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number

如果未提供该值,则将该值用作颜色到alpha的默认阈值 施工期间或由图像提供商提供。
Default Value: 0.004

static Cesium.ImageryLayer.DEFAULT_BRIGHTNESS : Number

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

static Cesium.ImageryLayer.DEFAULT_CONTRAST : Number

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

static Cesium.ImageryLayer.DEFAULT_GAMMA : Number

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

static Cesium.ImageryLayer.DEFAULT_HUE : Number

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

static Cesium.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果未提供纹理放大过滤器,该值将用作图像层的默认纹理放大过滤器 施工期间或由图像提供商提供。
Default Value: TextureMagnificationFilter.LINEAR

static Cesium.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果未提供纹理缩小过滤器,该值将用作图像层的默认纹理缩小过滤器 施工期间或由图像提供商提供。
Default Value: TextureMinificationFilter.LINEAR

static Cesium.ImageryLayer.DEFAULT_SATURATION : Number

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

static Cesium.ImageryLayer.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
应设置为透明的颜色值。

colorToAlphaThreshold : Number

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

contrast : Number

这层的对比度。1.0使用未修改的图像颜色。小于1.0减少 大于1.0时,对比度会增加。
Default Value: ImageryLayer.DEFAULT_CONTRAST
这层图像中的矩形裁剪。

dayAlpha : Number

该层在地球日面上的alpha混合值,0.0表示完全透明 完全代表不透明。这只在Globe#enableLighting等于true时生效。
Default Value: 1.0

gamma : Number

要应用于此层的gamma校正。1.0使用未修改的图像颜色。
Default Value: ImageryLayer.DEFAULT_GAMMA
这层的色调以弧度表示。0.0使用未修改的图像颜色。
Default Value: ImageryLayer.DEFAULT_HUE

readonly imageryProvider : ImageryProvider

获取此层的图像提供程序。
适用于6866165层。 可能的值为TextureMagnificationFilter.LINEAR(默认值) 和TextureMagnificationFilter.NEAREST。 若要生效,必须在添加图像层后立即设置此属性。 加载纹理后,将无法更改使用的纹理过滤器。
Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER
适用于6866165层。 可能的值为TextureMinificationFilter.LINEAR(默认值) 和TextureMinificationFilter.NEAREST。 若要生效,必须在添加图像层后立即设置此属性。 加载纹理后,将无法更改使用的纹理过滤器。
Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

nightAlpha : Number

该层在球体夜间的alpha混合值,0.0表示完全透明 完全代表不透明。这只在Globe#enableLighting等于true时生效。
Default Value: 1.0

readonly rectangle : Rectangle

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

saturation : Number

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

show : Boolean

确定是否显示了此层。
Default Value: true
适用于6866165层。
Default Value: ImageryLayer.DEFAULT_SPLIT

Methods



销毁此对象持有的WebGL资源。销毁一个对象允许确定性 释放WebGL资源,而不是依赖垃圾回收器销毁此对象。 一旦一个对象被销毁,就不应该使用它;调用除 isDestroyed将导致DeveloperError异常。因此, 如示例所示,将返回值(undefined)分配给对象。
Throws:
Example:
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

getViewableRectangle()Promise.<Rectangle>

计算矩形与矩形的交集, 产生这一层可以产生的图像的整体边界。
Returns:
一个矩形的承诺,它定义了该层可以产生的图像的整体边界。
Example:
// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer()Boolean

获取一个值,该值指示此层是否是 ImageryLayerCollection底层是一切的基础 其他。它的特殊之处在于它被视为具有全局矩形,即使 它实际上不是这样,通过在整个 地球仪。
Returns:
如果这是基础层,则为true;否则为false。

isDestroyed()Boolean



如果此对象已销毁,则返回true;否则返回false。 如果此对象已被销毁,则不应使用它;调用除 isDestroyed将导致DeveloperError异常。
Returns:
如果此对象被销毁,则为True;否则为false。
See: