ImageryLayer

查阅Mars3D API

成员(属性)

默认值: 0.004

默认值: 1.0

默认值: 1.0

默认值: 1.0

默认值: 0.0

默认值: TextureMagnificationFilter.LINEAR

默认值: TextureMinificationFilter.LINEAR

默认值: 1.0

默认值: SplitDirection.NONE

默认值: 1.0

默认值: ImageryLayer.DEFAULT_BRIGHTNESS

默认值: ImageryLayer.DEFAULT_CONTRAST

默认值: 1.0

默认值: ImageryLayer.DEFAULT_GAMMA

默认值: ImageryLayer.DEFAULT_HUE

默认值: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

默认值: ImageryLayer.DEFAULT_MINIFICATION_FILTER

默认值: 1.0

默认值: ImageryLayer.DEFAULT_SATURATION

默认值: true

默认值: ImageryLayer.DEFAULT_SPLIT

方法

返回值:

使用示例s:

// 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}`);
});

参考:

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

返回值:

使用示例s:

// 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}`);
});

参考:

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

Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

使用示例:

imageryLayer = imageryLayer && imageryLayer.destroy();

参考:

• ImageryLayer#isDestroyed

返回值:

使用示例:

// Zoom to an imagery layer.
const imageryRectangle = imageryLayer.getImageryRectangle();
scene.camera.flyTo({
    destination: rectangle
});

返回值:

返回值:

参考:

• ImageryLayer#destroy

定义的类型

属性:

属性名称	类型	可选	默认值	描述信息
rectangle	Rectangle	<可选>	imageryProvider.rectangle	The rectangle of the layer. This rectangle can limit the visible portion of the imagery provider.
alpha	number | function	<可选>	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). 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	<可选>	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). 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	<可选>	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). 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	<可选>	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). 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	<可选>	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). 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	<可选>	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). 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 contrast 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	<可选>	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). 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 contrast 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	<可选>	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). 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	<可选>	SplitDirection.NONE	The SplitDirection split to apply to this layer.
minificationFilter	TextureMinificationFilter	<可选>	TextureMinificationFilter.LINEAR	The texture minification filter to apply to this layer. Possible values are TextureMinificationFilter.LINEAR and TextureMinificationFilter.NEAREST.
magnificationFilter	TextureMagnificationFilter	<可选>	TextureMagnificationFilter.LINEAR	The texture minification filter to apply to this layer. Possible values are TextureMagnificationFilter.LINEAR and TextureMagnificationFilter.NEAREST.
show	boolean	<可选>	true	True if the layer is shown; otherwise, false.
maximumAnisotropy	number	<可选>	maximum supported	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	<可选>		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	<可选>		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	<可选>		Cartographic rectangle for cutting out a portion of this ImageryLayer.
colorToAlpha	Color	<可选>		Color to be used as alpha.
colorToAlphaThreshold	number	<可选>	0.004	Threshold for color-to-alpha.

This:

• ImageryLayer

This:

• ImageryLayer

属性:

属性名称	类型	可选	默认值	描述信息
options.style	IonWorldImageryStyle	<可选>	IonWorldImageryStyle	The style of base imagery, only AERIAL, AERIAL_WITH_LABELS, and ROAD are currently supported.