new Cesium.ImageryLayer(imageryProvider, options)
在
Globe上显示来自单个图像提供器的瓦片图像数据的图像图层。
| Name | Type | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
imageryProvider |
ImageryProvider | 使用的imageryProvider。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
options |
Object |
optional
具有下列属性的对象：
|
成员变量
默认的color-to-alpha阈值。
-
Default Value:
0.004
默认的亮度值。此值不修改图像的亮度。
-
Default Value:
1.0
默认的对比度值。此值不修改图像的对比度。
-
Default Value:
1.0
默认的伽马校正值。此值不修改图像的伽马校正。
-
Default Value:
1.0
默认的色调值。此值不修改图像的色调。
-
Default Value:
0.0
staticCesium.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
默认的纹理放大过滤器。
-
Default Value:
TextureMagnificationFilter.LINEAR
staticCesium.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
默认的纹理缩小过滤器。
-
Default Value:
TextureMinificationFilter.LINEAR
默认的饱和度值。此值不修改图像的饱和度。
-
Default Value:
1.0
默认的图像拆分位置。
-
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
color-to-alpha的归一化(0-1)阈值。
contrast : Number
该图层对比度。值为1.0表示使用原图；值大于1.0表示增加对比度；值小于1.0表示降低对比度。
-
Default Value:
ImageryLayer.DEFAULT_CONTRAST
cutoutRectangle : Rectangle
裁剪此图层的矩形范围。（在图层上挖洞的效果）
gamma : Number
该图层伽马校正。值为1.0表示使用原图。
-
Default Value:
ImageryLayer.DEFAULT_GAMMA
hue : Number
该图层色调。值为0.0表示使用原图。
-
Default Value:
ImageryLayer.DEFAULT_HUE
获取此图层的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
获取该图层的矩形显示范围。如果这个矩形小于
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
内置方法
destroy()
销毁此对象持有的WebGL资源。 销毁一个对象允许WebGL资源的确定性释放，而不是依赖于垃圾收集器来销毁这个对象。
一旦对象被销毁，它将不能在使用；调用除
一旦对象被销毁，它将不能在使用；调用除
isDestroyed之外的任何函数都会导致DeveloperError异常。
因此，将返回值(undefined)赋给对象，如示例所示。
异常情况：
-
DeveloperError : 对象已经被销毁。
示例：
layerCollection = layerCollection && layerCollection.destroy();参考：
计算此图层的矩形与图像提供器的可用矩形的交集，生成此图层可以生成的图像的总体边界。
即：获取图层的可见范围。
返回值：
一个矩形的promise，它定义了这个图层可以产生的图像的整体边界。
示例：
// 缩放到一个图像图层。
imageryLayer.getViewableRectangle().then(function (rectangle) {
return camera.flyTo({
destination: rectangle
});
});
获取一个值，该值指示此图层是否为
ImageryLayerCollection中的基础图层。基础图层在所有其他图层的之下。
它的特殊之处在于，它被当作一个全球矩形来处理，即使它实际上并没有，通过在整个地球中拉伸纹理的边缘来处理。
返回值：
true if this is the base layer; otherwise, false.
返回值：
false
