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 : This object was destroyed, i.e., destroy() was called.

示例： 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	<可选> &lt;optional>	imageryProvider.rectangle	图层的矩形。该矩形可以限制图像提供者的可见部分。 The rectangle of the layer. This rectangle can limit the visible portion of the imagery provider.
alpha	number | function	<可选> &lt;optional>	1.0	该图层的 alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名的函数 The alpha blending value of this layer, from 0.0 to 1.0. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数会传递当前帧状态、该图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于该图块的 alpha 值。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile.
nightAlpha	number | function	<可选> &lt;optional>	1.0	该图层在地球夜晚一侧的 Alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名的函数 The alpha blending value of this layer on the night side of the globe, from 0.0 to 1.0. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数会传递当前帧状态、该图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于该图块的 alpha 值。这仅在以下情况下生效 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile. This only takes effect when enableLighting is true.
dayAlpha	number | function	<可选> &lt;optional>	1.0	该图层在地球白天一侧的 Alpha 混合值，从 0.0 到 1.0。这可以是一个简单的数字，也可以是带有签名的函数 The alpha blending value of this layer on the day side of the globe, from 0.0 to 1.0. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数会传递当前帧状态、该图层以及需要 alpha 的图像图块的 x、y 和级别坐标，并且预计会返回用于该图块的 alpha 值。这仅在以下情况下生效 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the alpha is required, and it is expected to return the alpha value to use for the tile. This only takes effect when enableLighting is true.
brightness	number | function	<可选> &lt;optional>	1.0	该层的亮度。 1.0 使用未修改的图像颜色。小于 1.0 会使图像变暗，而大于 1.0 会使图像变亮。这可以是一个简单的数字，也可以是带有签名的函数 The brightness of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 makes the imagery darker while greater than 1.0 makes it brighter. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数传递当前帧状态、该层以及需要亮度的图像图块的 x、y 和级别坐标，并且预计返回用于该图块的亮度值。该函数针对每一帧和每个图块执行，因此它必须很快。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the brightness is required, and it is expected to return the brightness value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.
contrast	number | function	<可选> &lt;optional>	1.0	该层的对比度。 1.0 使用未修改的图像颜色。小于 1.0 会降低对比度，而大于 1.0 则会增加对比度。这可以是一个简单的数字，也可以是带有签名的函数 The contrast of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the contrast while greater than 1.0 increases it. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数会传递当前帧状态、该图层以及需要对比度的图像图块的 x、y 和级别坐标，并且预计会返回用于该图块的对比度值。该函数针对每一帧和每个图块执行，因此它必须很快。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the contrast is required, and it is expected to return the contrast value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.
hue	number | function	<可选> &lt;optional>	0.0	该层的色调。 0.0 使用未修改的图像颜色。这可以是一个简单的数字，也可以是带有签名的函数 The hue of this layer. 0.0 uses the unmodified imagery color. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数会传递当前帧状态、该图层以及需要色调的图像图块的 x、y 和级别坐标，并且预计会返回用于该图块的色调值。该函数针对每一帧和每个图块执行，因此它必须很快。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the hue is required, and it is expected to return the hue value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.
saturation	number | function	<可选> &lt;optional>	1.0	该层的饱和度。 1.0 使用未修改的图像颜色。小于 1.0 会降低饱和度，而大于 1.0 则会增加饱和度。这可以是一个简单的数字，也可以是带有签名的函数 The saturation of this layer. 1.0 uses the unmodified imagery color. Less than 1.0 reduces the saturation while greater than 1.0 increases it. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数传递当前帧状态、该层以及需要饱和度的图像图块的 x、y 和级别坐标，并且预计返回用于该图块的饱和度值。该函数针对每一帧和每个图块执行，因此它必须很快。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the saturation is required, and it is expected to return the saturation value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.
gamma	number | function	<可选> &lt;optional>	1.0	应用于该层的伽玛校正。 1.0 使用未修改的图像颜色。这可以是一个简单的数字，也可以是带有签名的函数 The gamma correction to apply to this layer. 1.0 uses the unmodified imagery color. This can either be a simple number or a function with the signature function(frameState, layer, x, y, level)。该函数传递当前帧状态、该层以及需要伽玛的图像图块的 x、y 和级别坐标，并且预计返回用于该图块的伽玛值。该函数针对每一帧和每个图块执行，因此它必须很快。 . The function is passed the current frame state, this layer, and the x, y, and level coordinates of the imagery tile for which the gamma is required, and it is expected to return the gamma value to use for the tile. The function is executed for every frame and for every tile, so it must be fast.
splitDirection	SplitDirection | function	<可选> &lt;optional>	SplitDirection.NONE	The SplitDirection 分割以应用于该层。 split to apply to this layer.
minificationFilter	TextureMinificationFilter	<可选> &lt;optional>	TextureMinificationFilter.LINEAR	应用到该层的纹理缩小过滤器。可能的值为 The texture minification filter to apply to this layer. Possible values are TextureMinificationFilter.LINEAR and TextureMinificationFilter.NEAREST.
magnificationFilter	TextureMagnificationFilter	<可选> &lt;optional>	TextureMagnificationFilter.LINEAR	应用到该层的纹理缩小过滤器。可能的值为 The texture minification filter to apply to this layer. Possible values are TextureMagnificationFilter.LINEAR and TextureMagnificationFilter.NEAREST.
show	boolean	<可选> &lt;optional>	true	如果显示图层则为 True；否则为假。 True if the layer is shown; otherwise, false.
maximumAnisotropy	number	<可选> &lt;optional>	最大支持 maximum supported	用于纹理过滤的最大各向异性级别。如果未指定此参数，将使用 WebGL 堆栈支持的最大各向异性。值越大，图像在地平线视图中看起来越好。 The maximum anisotropy level to use for texture filtering. If this parameter is not specified, the maximum anisotropy supported by the WebGL stack will be used. Larger values make the imagery look better in horizon views.
minimumTerrainLevel	number	<可选> &lt;optional>		显示此图像图层的最小地形细节级别，或未定义以在所有级别显示它。零级是最不详细的级别。 The minimum terrain level-of-detail at which to show this imagery layer, or undefined to show it at all levels. Level zero is the least-detailed level.
maximumTerrainLevel	number	<可选> &lt;optional>		显示此图像图层的最大地形细节级别，或未定义以在所有级别显示它。零级是最不详细的级别。 The maximum terrain level-of-detail at which to show this imagery layer, or undefined to show it at all levels. Level zero is the least-detailed level.
cutoutRectangle	Rectangle	<可选> &lt;optional>		用于剪切此 ImageryLayer 的一部分的制图矩形。 Cartographic rectangle for cutting out a portion of this ImageryLayer.
colorToAlpha	Color	<可选> &lt;optional>		用作 Alpha 的颜色。 Color to be used as alpha.
colorToAlphaThreshold	number	<可选> &lt;optional>	0.004	颜色到 Alpha 的阈值。 Threshold for color-to-alpha.

this： This:

• ImageryLayer

this： This:

• ImageryLayer

属性： Properties:

名称 Name	类型 Type	Attributes	默认值 Default	说明 Description
options.style	IonWorldImageryStyle	<可选> &lt;optional>	IonWorldImageryStyle	基础影像的样式，目前仅支持 AERIAL、AERIAL_WITH_LABELS 和 ROAD。 The style of base imagery, only AERIAL, AERIAL_WITH_LABELS, and ROAD are currently supported.