ImageryLayer

Members

Default Value: 0.004

Default Value: 1.0

Default Value: 1.0

Default Value: 1.0

Default Value: 0.0

Default Value: TextureMagnificationFilter.LINEAR

Default Value: TextureMinificationFilter.LINEAR

Default Value: 1.0

Default Value: SplitDirection.NONE

Default Value: 1.0

Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

Default Value: ImageryLayer.DEFAULT_CONTRAST

Default Value: 1.0

Default Value: ImageryLayer.DEFAULT_GAMMA

Default Value: ImageryLayer.DEFAULT_HUE

Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

Default Value: 1.0

Default Value: ImageryLayer.DEFAULT_SATURATION

Default Value: true

Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

Returns:

Examples:

// 创建新的基础图层
const viewer = new Cesium.Viewer("cesiumContainer", {
  baseLayer: Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
});

// 添加新的透明图层
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
imageryLayer.alpha = 0.5;
viewer.imageryLayers.add(imageryLayer);

// 处理加载事件
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
viewer.imageryLayers.add(imageryLayer);

imageryLayer.readyEvent.addEventListener(provider => {
  imageryLayer.imageryProvider.errorEvent.addEventListener(error => {
    alert(`加载影像瓦片时遇到错误！${error}`);
  });
});

imageryLayer.errorEvent.addEventListener(error => {
  alert(`创建影像图层时遇到错误！${error}`);
});

See:

• ImageryLayer#errorEvent
• ImageryLayer#readyEvent
• ImageryLayer#imageryProvider
• ImageryLayer.fromWorldImagery

Returns:

Examples:

// 添加新的透明图层
const imageryLayer = Cesium.ImageryLayer.fromWorldImagery();
imageryLayer.alpha = 0.5;
viewer.imageryLayers.add(imageryLayer);

// 处理加载事件
const imageryLayer = Cesium.ImageryLayer.fromWorldImagery();
viewer.imageryLayers.add(imageryLayer);

imageryLayer.readyEvent.addEventListener(provider => {
  imageryLayer.imageryProvider.errorEvent.addEventListener(error => {
    alert(`加载影像瓦片时遇到错误！${error}`);
  });
});

imageryLayer.errorEvent.addEventListener(error => {
  alert(`创建影像图层时遇到错误！${error}`);
});

See:

• ImageryLayer#errorEvent
• ImageryLayer#readyEvent
• ImageryLayer#imageryProvider

Throws:

• DeveloperError : 此对象已被销毁，即已调用 destroy()。

Example:

imageryLayer = imageryLayer && imageryLayer.destroy();

See:

• ImageryLayer#isDestroyed

Returns:

Example:

// 缩放至影像图层。
const imageryRectangle = imageryLayer.getImageryRectangle();
scene.camera.flyTo({
    destination: rectangle
});

Returns:

Returns:

See:

• ImageryLayer#destroy

Type Definitions

Properties:

Name	Type	Attributes	Default	Description
rectangle	Rectangle	<optional>	imageryProvider.rectangle	图层的矩形区域。此矩形 可以限制影像提供者的可见部分。
alpha	number | function	<optional>	1.0	此图层的 alpha 混合值，从 0.0 到 1.0。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及 alpha 所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的 alpha 值。
nightAlpha	number | function	<optional>	1.0	此图层在地球夜半球的 alpha 混合值，从 0.0 到 1.0。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及 alpha 所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的 alpha 值。仅当 enableLighting 为 true 时生效。
dayAlpha	number | function	<optional>	1.0	此图层在地球昼半球的 alpha 混合值，从 0.0 到 1.0。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及 alpha 所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的 alpha 值。仅当 enableLighting 为 true 时生效。
brightness	number | function	<optional>	1.0	此图层的亮度。1.0 使用未修改的影像 颜色。小于 1.0 使影像变暗，大于 1.0 使其变亮。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及亮度所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的亮度值。函数对每一帧和每个瓦片执行， 因此必须快速。
contrast	number | function	<optional>	1.0	此图层的对比度。1.0 使用未修改的影像颜色。 小于 1.0 降低对比度，大于 1.0 增加对比度。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及对比度所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的对比度值。函数对每一帧和每个瓦片执行， 因此必须快速。
hue	number | function	<optional>	0.0	此图层的色相。0.0 使用未修改的影像颜色。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及色相所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的色相值。函数对每一帧和每个瓦片执行， 因此必须快速。
saturation	number | function	<optional>	1.0	此图层的饱和度。1.0 使用未修改的影像颜色。 小于 1.0 降低饱和度，大于 1.0 增加饱和度。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及饱和度所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的饱和度值。函数对每一帧和每个瓦片执行， 因此必须快速。
gamma	number | function	<optional>	1.0	应用于此图层的伽马校正。1.0 使用未修改的影像颜色。 这可以是一个简单的数字或具有签名 function(frameState, layer, x, y, level) 的函数。函数被传递 当前帧状态、此图层以及伽马所需的影像瓦片的 x、y 和 level 坐标， 它应返回要用于瓦片的伽马值。函数对每一帧和每个瓦片执行， 因此必须快速。
splitDirection	SplitDirection | function	<optional>	SplitDirection.NONE	应用于此图层的 SplitDirection 分割方向。
minificationFilter	TextureMinificationFilter	<optional>	TextureMinificationFilter.LINEAR	应用于此图层的 纹理缩小过滤器。可能的值 为 TextureMinificationFilter.LINEAR 和 TextureMinificationFilter.NEAREST。
magnificationFilter	TextureMagnificationFilter	<optional>	TextureMagnificationFilter.LINEAR	应用于此图层的 纹理放大过滤器。可能的值 为 TextureMagnificationFilter.LINEAR 和 TextureMagnificationFilter.NEAREST。
show	boolean	<optional>	true	如果显示图层则为 true；否则为 false。
maximumAnisotropy	number	<optional>	最大支持	用于 纹理过滤的最大各向异性级别。如果未指定此参数，将使用 WebGL 堆栈支持的最大各向异性。较大的值使影像在地平线 视图中看起来更好。
minimumTerrainLevel	number	<optional>		显示此影像图层的最低地形细节级别， 如果未定义则在所有级别显示。级别零是细节最少的级别。
maximumTerrainLevel	number	<optional>		显示此影像图层的最高地形细节级别， 如果未定义则在所有级别显示。级别零是细节最少的级别。
cutoutRectangle	Rectangle	<optional>		用于切除此 ImageryLayer 部分的笛卡尔矩形。
colorToAlpha	Color	<optional>		用作 alpha 的颜色。
colorToAlphaThreshold	number	<optional>	0.004	颜色转 alpha 的阈值。

This:

• ImageryLayer

This:

• ImageryLayer

Properties:

Name	Type	Attributes	Default	Description
options.style	IonWorldImageryStyle	<optional>	IonWorldImageryStyle	基础影像的样式，目前仅支持 AERIAL、AERIAL_WITH_LABELS 和 ROAD。