ImageryLayer

new LSGlobe.ImageryLayer (imageryProvider, options )
Scene/ImageryLayer.js 129

显示来自单个图像提供者的平铺图像数据的图像层在 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值。
nightAlpha Number | function 1.0 可选 在地球的夜晚，此图层的alpha混合值，从0.0到1.0。 这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过 当前帧状态，该层以及x，y和级别坐标 需要Alpha的图像图块，预计会返回 用于图块的Alpha值。这仅在 enableLighting 为 true 时生效。
dayAlpha Number | function 1.0 可选 地球日这一层的alpha混合值，从0.0到1.0。 这可以是一个简单的数字，也可以是带有签名的函数 function（frameState，layer，x，y，level） 。该函数通过 当前帧状态，该层以及x，y和级别坐标 需要Alpha的图像图块，预计会返回 用于图块的Alpha值。这仅在 enableLighting 为 true 时生效。
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；否则为true。否则为false。
maximumAnisotropy Number maximum supported 可选 使用的最大各向异性水平 用于纹理过滤。如果未指定此参数，则支持最大各向异性 将使用WebGL堆栈。较大的值可使影像在水平方向上看起来更好 视图。
minimumTerrainLevel Number 可选 显示此图像图层的最小地形细节级别， 或未定义以在所有级别上显示它。级别零是最不详细的级别。
maximumTerrainLevel Number 可选 显示此影像图层的最大地形细节级别， 或未定义以在所有级别上显示它。级别零是最不详细的级别。
cutoutRectangle Rectangle 可选 制图矩形，用于裁剪此ImageryLayer的一部分。
colorToAlpha Color 可选 用作Alpha的颜色。
colorToAlphaThreshold Number 0.004 可选 颜色到Alpha的阈值。
翻译by:http://www.wish3d.com

Members

static LSGlobe.ImageryLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number
Scene/ImageryLayer.js 432

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

static LSGlobe.ImageryLayer.DEFAULT_BRIGHTNESS : Number
Scene/ImageryLayer.js 372

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

static LSGlobe.ImageryLayer.DEFAULT_CONTRAST : Number
Scene/ImageryLayer.js 379

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

static LSGlobe.ImageryLayer.DEFAULT_GAMMA : Number
Scene/ImageryLayer.js 400

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

static LSGlobe.ImageryLayer.DEFAULT_HUE : Number
Scene/ImageryLayer.js 386

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

static LSGlobe.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
Scene/ImageryLayer.js 424

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

static LSGlobe.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
Scene/ImageryLayer.js 416

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

static LSGlobe.ImageryLayer.DEFAULT_SATURATION : Number
Scene/ImageryLayer.js 393

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

static LSGlobe.ImageryLayer.DEFAULT_SPLIT : ImagerySplitDirection
Scene/ImageryLayer.js 408

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

alpha : Number
Scene/ImageryLayer.js 141

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

brightness : Number
Scene/ImageryLayer.js 177

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

colorToAlpha : Color
Scene/ImageryLayer.js 326

应该设置为透明的颜色值。

colorToAlphaThreshold : Number
Scene/ImageryLayer.js 333

颜色到alpha的归一化（0-1）阈值。

contrast : Number
Scene/ImageryLayer.js 192

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

cutoutRectangle : Rectangle
Scene/ImageryLayer.js 319

这层图像中的矩形切口。

dayAlpha : Number
Scene/ImageryLayer.js 165

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

gamma : Number
Scene/ImageryLayer.js 229

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

hue : Number
Scene/ImageryLayer.js 203

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

readonly imageryProvider : ImageryProvider
Scene/ImageryLayer.js 346

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

magnificationFilter : TextureMagnificationFilter
Scene/ImageryLayer.js 275

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

minificationFilter : TextureMinificationFilter
Scene/ImageryLayer.js 256

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

nightAlpha : Number
Scene/ImageryLayer.js 153

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

readonly rectangle : Rectangle
Scene/ImageryLayer.js 359

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

saturation : Number
Scene/ImageryLayer.js 215

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

show : Boolean
Scene/ImageryLayer.js 289

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

splitDirection : ImagerySplitDirection
Scene/ImageryLayer.js 240

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

Methods

destroy ()
Scene/ImageryLayer.js 477

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

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

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

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

isBaseLayer () → Boolean
Scene/ImageryLayer.js 443

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

isDestroyed () → Boolean
Scene/ImageryLayer.js 457

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

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