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 且应返回的图像模块 用于图块的 Alpha 值。
nightAlpha	number | function	<optional>	1.0	此图层在地球的夜间一侧的 Alpha 混合值，从 0.0 到 1.0。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 需要 Alpha 且应返回的图像模块 用于图块的 Alpha 值。这仅在 enableLighting 为 true 时生效。
dayAlpha	number | function	<optional>	1.0	此图层在地球的昼侧的 Alpha 混合值，从 0.0 到 1.0。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 需要 Alpha 且应返回的图像模块 用于图块的 Alpha 值。这仅在 enableLighting 为 true 时生效。
brightness	number | function	<optional>	1.0	该图层的亮度。 1.0 使用未修改的图像 颜色。 小于 1.0 会使图像更暗，而大于 1.0 会使图像更亮。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 需要亮度且应返回的图像模块 用于图块的亮度值。 该函数对每个 帧和每个图块，因此它必须很快。
contrast	number | function	<optional>	1.0	该层的对比度。 1.0 使用未修改的图像颜色。 小于 1.0 会降低对比度，而大于 1.0 会增加对比度。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 需要对比度且应返回的图像模块 用于磁贴的 contrast 值。 该函数对每个 帧和每个图块，因此它必须很快。
hue	number | function	<optional>	0.0	该图层的色调。 0.0 使用未修改的影像颜色。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 X、Y 和 Level 坐标 需要色调的图像图块，并且它应返回 用于磁贴的 contrast 值。 该函数对每个 帧和每个图块，因此它必须很快。
saturation	number | function	<optional>	1.0	该层的饱和度。 1.0 使用未修改的图像颜色。 小于 1.0 会降低饱和度，而大于 1.0 会增加饱和度。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 X、Y 和 Level 坐标 需要饱和度的影像瓦片，并且应返回 用于磁贴的 contrast 值。 该函数对每个 帧和每个图块，因此它必须很快。
gamma	number | function	<optional>	1.0	要应用于此图层的 Gamma 校正。 1.0 使用未修改的图像颜色。 这可以是一个简单的数字，也可以是带有签名的函数 function(frameState, layer, x, y, level) 的 该函数将 当前帧状态、此图层以及 需要 Gamma 且应返回的图像模块 用于图块的 Gamma 值。 该函数对每个 帧和每个图块，因此它必须很快。
splitDirection	SplitDirection | function	<optional>	SplitDirection.NONE	要应用于此图层的 SplitDirection 分割。
minificationFilter	TextureMinificationFilter	<optional>	TextureMinificationFilter.LINEAR	的 纹理缩小滤镜以应用于此图层。可能的值 是 TextureMinificationFilter.LINEAR 和 TextureMinificationFilter.NEAREST的 TextureMinificationFilter.NEAREST。
magnificationFilter	TextureMagnificationFilter	<optional>	TextureMagnificationFilter.LINEAR	的 纹理缩小滤镜以应用于此图层。可能的值 是 TextureMagnificationFilter.LINEAR 和 TextureMagnificationFilter.NEAREST的 TextureMagnificationFilter.NEAREST.
show	boolean	<optional>	true	如果显示图层，则为 True;否则为 false。
maximumAnisotropy	number	<optional>	maximum supported	要使用的最大各向异性级别 用于纹理筛选。 如果未指定此参数，则支持的最大各向异性 将使用 WebGL 堆栈。 较大的值会使影像在地平线中看起来更好 视图。
minimumTerrainLevel	number	<optional>		显示此图像图层的最小地形细节级别， 或 undefined 在所有级别显示它。 级别 0 是最不详细的级别。
maximumTerrainLevel	number	<optional>		显示此图像图层的最大地形细节级别， 或 undefined 在所有级别显示它。 级别 0 是最不详细的级别。
cutoutRectangle	Rectangle	<optional>		用于剪切此 ImageryLayer 的一部分的制图矩形。
要用作	Color			Alpha 的 [colorToAlpha] 颜色。
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。