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:

// Create a new base layer
const viewer = new Cesium.Viewer("cesiumContainer", {
  baseLayer: Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
});

// Add a new transparent layer
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
imageryLayer.alpha = 0.5;
viewer.imageryLayers.add(imageryLayer);

// Handle loading events
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
viewer.imageryLayers.add(imageryLayer);

imageryLayer.readyEvent.addEventListener(provider => {
  imageryLayer.provider.errorEvent.addEventListener(error => {
    alert(`Encountered an error while loading imagery tiles! ${error}`);
  });
});

imageryLayer.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating an imagery layer! ${error}`);
});

See:

• ImageryLayer.errorEvent
• ImageryLayer.readyEvent
• ImageryLayer.provider
• ImageryLayer.fromWorldImagery

Returns:

Examples:

// Add a new transparent layer
const imageryLayer = Cesium.ImageryLayer.fromWorldImagery();
imageryLayer.alpha = 0.5;
viewer.imageryLayers.add(imageryLayer);

// Handle loading events
const imageryLayer = Cesium.ImageryLayer.fromWorldImagery();
viewer.imageryLayers.add(imageryLayer);

imageryLayer.readyEvent.addEventListener(provider => {
  imageryLayer.provider.errorEvent.addEventListener(error => {
    alert(`Encountered an error while loading imagery tiles! ${error}`);
  });
});

imageryLayer.errorEvent.addEventListener(error => {
  alert(`Encountered an error while creating an imagery layer! ${error}`);
});

See:

• ImageryLayer.errorEvent
• ImageryLayer.readyEvent
• ImageryLayer.provider

Throws:

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

Example:

imageryLayer = imageryLayer && imageryLayer.destroy();

See:

• ImageryLayer#isDestroyed

Returns:

Example:

// Zoom to an imagery layer.
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>	maximum supported	用于纹理过滤的最大各向异性级别。 如果未指定此参数，将使用 WebGL 堆栈支持的最大各向异性。更大的值会使图像在地平线视图中看起来更好。
minimumTerrainLevel	number	<optional>		显示此图像层的最小地形细节级别，或未定义以在所有级别显示。 级别零是最不详细的级别。
maximumTerrainLevel	number	<optional>		显示此图像层的最大地形细节级别，或未定义以在所有级别显示。 级别零是最不详细的级别。
cutoutRectangle	Rectangle	<optional>		用于剪切此 ImageryLayer 部分的地理矩形。
colorToAlpha	Color	<optional>		用作 alpha 的颜色。
colorToAlphaThreshold	number	<optional>	0.004	用于颜色转透明的阈值。

This:

• ImageryLayer

This:

• ImageryLayer

Properties:

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