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.imageryProvider.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#imageryProvider
• 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.imageryProvider.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#imageryProvider

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	应用于此图层的 gamma 校正值。1.0 使用未经修改的影像颜色。 这可以是一个简单的数字，也可以是一个签名为 function(frameState, layer, x, y, level) 的函数。该函数会接收到当前的帧状态、此图层，以及需要 gamma 值的影像瓦片的 x、y 和 level 坐标，并应当返回用于该瓦片的 gamma 值。该函数会在每一帧、每一个瓦片上执行，因此必须高效。
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 栈所支持的最大各向异性。值越大，影像在 horizon（地平线）视角下看起来越好。
minimumTerrainLevel	number	<optional>		显示此影像图层所对应的最小地形细节层级， 或者为 undefined 以在所有层级显示。级别 0 是最不详细的层级。
maximumTerrainLevel	number	<optional>		显示此影像图层所对应的最大地形细节层级， 或者为 undefined 以在所有层级显示。级别 0 是最不详细的层级。
cutoutRectangle	Rectangle	<optional>		用于挖空此 ImageryLayer 一部分的地理矩形。
colorToAlpha	Color	<optional>		用作 alpha 的颜色。
colorToAlphaThreshold	number	<optional>	0.004	color-to-alpha 的阈值。

This:

• ImageryLayer

This:

• ImageryLayer

Properties:

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