new Cesium.ImageryLayer(imageryProvider, options)

显示单个图像提供者的平板图像数据的图像层 on a Globe or Cesium3DTileset.
Name Type Description
imageryProvider ImageryProvider optional 要使用的图像提供者.
options ImageryLayer.ConstructorOptions optional 描述初始化选项的对象
Examples:
// Add an OpenStreetMaps layer
const imageryLayer = new Cesium.ImageryLayer(new Cesium.OpenStreetMapImageryProvider({
  url: "https://tile.openstreetmap.org/"
}));
scene.imageryLayers.add(imageryLayer);
// Add Cesium ion's default world imagery layer
const imageryLayer = Cesium.ImageryLayer.fromWorldImagery();
scene.imageryLayers.add(imageryLayer);
// Add a new transparent layer from Cesium ion
const imageryLayer = Cesium.ImageryLayer.fromProviderAsync(Cesium.IonImageryProvider.fromAssetId(3812));
imageryLayer.alpha = 0.5;
scene.imageryLayers.add(imageryLayer);
// Drape Bing Maps Aerial imagery over a 3D tileset
const tileset = await Cesium.Cesium3DTileset.fromUrl(
  "http://localhost:8002/tilesets/Seattle/tileset.json"
);
scene.primitives.add(tileset);

const imageryProvider = await Cesium.createWorldImageryAsync({
  style: Cesium.IonWorldImageryStyle.AERIAL,
});
const imageryLayer = new ImageryLayer(imageryProvider);
tileset.imageryLayers.add(imageryLayer);
See:

Members

static Cesium.ImageryLayer.DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : number

如果不提供颜色到α的默认阈值,则使用此值 在施工期间或由图像提供者提供.
Default Value: 0.004

static Cesium.ImageryLayer.DEFAULT_BRIGHTNESS : number

如果在构建过程中不提供图像层的默认亮度, 此值将作为图像层的默认亮度 或由图像提供者提供。 此值不会修改图像的亮度 .
Default Value: 1.0

static Cesium.ImageryLayer.DEFAULT_CONTRAST : number

如果在构建过程中不提供图像层, 此值将作为图像层的默认对比值 或由图像提供者提供。 此值不会修改图像的对比度 .
Default Value: 1.0

static Cesium.ImageryLayer.DEFAULT_GAMMA : number

如果在构造过程中不提供图像层的默认伽马值,则使用该值 或由图像提供者提供。 此值不会修改图像的γ.
Default Value: 1.0

static Cesium.ImageryLayer.DEFAULT_HUE : number

如果在构建过程中不提供图像层,则该值被用作图像层的默认色调 或由图像提供者提供。 此值不会修改图像的色调 .
Default Value: 0.0

static Cesium.ImageryLayer.DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果不提供图像层的纹理放大过滤器,则使用此值 在施工期间或由图像提供者提供.
Default Value: TextureMagnificationFilter.LINEAR

static Cesium.ImageryLayer.DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果不提供图像层的默认纹理细化过滤器,则使用此值 在施工期间或由图像提供者提供.
Default Value: TextureMinificationFilter.LINEAR

static Cesium.ImageryLayer.DEFAULT_SATURATION : number

如果在构建过程中不提供图像层, 此值将作为图像层的默认饱和度 或由图像提供者提供。 此值不会修改图像的饱和度 .
Default Value: 1.0

static Cesium.ImageryLayer.DEFAULT_SPLIT : SplitDirection

如果在构建过程中不提供图像层, 此值将用作图像层的默认分割 或由图像提供者提供.
Default Value: SplitDirection.NONE

alpha : number

这个层的α混合值, 0.0 代表完全透明 1.0代表完全不透明.
Default Value: 1.0

brightness : number

此层之明. 1.0使用未经修改的图像颜色. 少于1.0 使图像更暗,而大于1.0则使其更亮.
Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

colorToAlpha : Color

应设置为透明颜色值 .

colorToAlphaThreshold : number

色对α的正常化(0-1)阈值.

contrast : number

这层的对比度 1.0使用未经修改的图像颜色. 减少少于1.0 反差大于1.0,则增加.
Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle

这层图像的矩形截面.

dayAlpha : number

全球日面的阿尔法混合值为0.0,代表完全透明 1.0代表完全不透明。 这只有在 Globe#enableLighting 为 真 时才生效.
Default Value: 1.0

readonly errorEvent : Event.<ImageryLayer.ErrorEventCallback>

获得一个在图像提供者遇到同步错误时上升的事件 。 通过签名 对事件,您将被通知错误,并有可能从中恢复。 活动听众 被传递一个抛出错误的例子.

gamma : number

伽玛校正适用于此层. 1.0使用未经修改的图像颜色.
Default Value: ImageryLayer.DEFAULT_GAMMA

hue : number

这层的弧度 0.0使用未修改的图像颜色.
Default Value: ImageryLayer.DEFAULT_HUE

readonly imageryProvider : ImageryProvider

获取此图层的图像提供者 。 在 {NT}\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\.

magnificationFilter : TextureMagnificationFilter

The TextureMagnificationFilter to apply to this layer. Possible values are TextureMagnificationFilter.LINEAR (the default) 和 TextureMagnificationFilter.NEAREST . 要生效,必须在添加图像层后立即设定此属性 . 一旦一个纹理被加载,将无法改变所使用的纹理过滤器.
Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

The TextureMinificationFilter to apply to this layer. Possible values are TextureMinificationFilter.LINEAR (the default) 和 TextureMinificationFilter.NEAREST . 要生效,必须在添加图像层后立即设定此属性 . 一旦一个纹理被加载,将无法改变所使用的纹理过滤器.
Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

nightAlpha : number

这层的阿尔法混合值 在地球的夜边, 0.0 代表完全透明 1.0代表完全不透明。 这只有在 Globe#enableLighting 为 真 时才生效.
Default Value: 1.0

readonly ready : boolean

当地形提供者成功创建时返回真值 。 否则,返回假.

readonly readyEvent : Event.<ImageryLayer.ReadyEventCallback>

获得图像提供者成功创建时提起的事件 。 活动听众 are passed the created instance of ImageryProvider.

readonly rectangle : Rectangle

获得此层的矩形 。 如果这个矩形小于 ImageryProvider ,仅显示部分图像提供者.

saturation : number

此层之饱和. 1.0使用未经修改的图像颜色. 小于1.0 减少 饱和度在大于1.0的同时增加.
Default Value: ImageryLayer.DEFAULT_SATURATION

show : boolean

确定是否显示此图层.
Default Value: true

splitDirection : SplitDirection

The SplitDirection to apply to this layer.
Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

static Cesium.ImageryLayer.fromProviderAsync(imageryProviderPromise, options) → ImageryLayer

从同步图像提供者创建新图像层 。 该图层将处理任何同步负载或错误,并在图像层准备好后开始渲染.
Name Type Description
imageryProviderPromise Promise.<ImageryProvider> 向图像提供者承诺
options ImageryLayer.ConstructorOptions optional 描述初始化选项的对象
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:

static Cesium.ImageryLayer.fromWorldImagery(options) → ImageryLayer

为离子默认的全球基础图像层创建新的图像层,目前为Bing Maps. 该图层将处理任何同步负载或错误,并在图像层准备好后开始渲染.
Name Type Description
options ImageryLayer.WorldImageryConstructorOptions 描述初始化选项的对象
Returns:
创建的图像层 . * @example // 创建新的基层 const viewer = new Cesium.Viewer("cesiumContainer", { baseLayer: Cesium.ImageryLayer.fromWorldImagery(); });
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:

destroy()

Destroys the WebGL resources held by this object. Destroying an object allows for deterministic 释放 WebGL 资源,而不是依赖垃圾收集器来摧毁此对象.

Once an object is destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception. Therefore, assign the return value (undefined) to the object as done in the example.
Throws:
  • DeveloperError : This object was destroyed, i.e., destroy() was called.
Example:
imageryLayer = imageryLayer && imageryLayer.destroy();
See:

getImageryRectangle() → Rectangle

计算这层矩形与图像提供者可用矩形的交叉点, 生成可由这层生成的图像的总范围.
Returns:
一个矩形,它定义了这个图层可以产生的图像的整体界限.
Example:
// Zoom to an imagery layer.
const imageryRectangle = imageryLayer.getImageryRectangle();
scene.camera.flyTo({
    destination: rectangle
});

isBaseLayer() → boolean

获得一个值,显示此层是否是基层 ImageryLayerCollection. The base layer is the one that underlies all 别人。 其特殊之处在于,它被视为具有全球矩形,即使 实际上不是,通过把边缘的特克塞尔拉到整个 globe.
Returns:
如果这是底层, 则为真; 否则为假 .

isDestroyed() → boolean

如果此对象被销毁, 返回真实; 否则, 错误 .

If this object was destroyed, it should not be used; calling any function other than isDestroyed will result in a DeveloperError exception.
Returns:
如果此天体被销毁, 则属真; 否则, 属假 .
See:

Type Definitions

Cesium.ImageryLayer.ConstructorOptions

ImageryLayer 构造器的初始化选项.
Properties:
Name Type Attributes Default Description
rectangle Rectangle <optional>
 imageryProvider.rectangle The rectangle of the layer. This rectangle 可以限制图像提供者的可见部分.
alpha number | function <optional>
 1.0 此层的α混合值,从0.0到1.0. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要α的图像瓦,预计会返回 用于瓦片的α值.
nightAlpha number | function <optional>
 1.0 这层在全球夜幕面的α混合值,从0.0到1.0. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要α的图像瓦,预计会返回 用于瓦片的α值。 这只有在 NT 0 enableLighting NT 1 为 NT 2 rect NT 3 时才生效.
dayAlpha number | function <optional>
 1.0 地球日面上这个层的α混合值,从0.0到1.0. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要α的图像瓦,预计会返回 用于瓦片的α值。 这只有在 NT 0 enableLighting NT 1 为 NT 2 rect NT 3 时才生效.
brightness number | function <optional>
 1.0 这层的亮度. 1.0 使用未修改的图像 颜色 不到1.0使图像变暗,而大于1.0则使其变亮. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要亮度的图像瓦片,预计会返回 用于瓦片的亮度值。 函数为每个 每块瓷砖都用这个框架 所以它必须快.
contrast number | function <optional>
 1.0 此层的对比. 1.0使用未经修改的图像颜色. 低于1.0会减小对比度,而大于1.0会增加对比度. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要对比的图像瓦片,预计将返回 用于瓦片的对比值。 函数为每个 每块瓷砖都用这个框架 所以它必须快.
hue number | function <optional>
 0.0 这层的花朵. 0.0使用未修改的图像颜色. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态, 此图层, 以及 x, y, 和级别坐标 的图纸,预计会返回 用于瓦片的色值。 函数为每个 每块瓷砖都用这个框架 所以它必须快.
saturation number | function <optional>
 1.0 此层的饱和度. 1.0使用未经修改的图像颜色. 少于1.0会减少饱和度,而大于1.0会增加饱和度. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态, 此图层, 以及 x, y, 和级别坐标 需要饱和的图像砖块,预计会返回 用于瓦片的饱和值。 函数为每个 每块瓷砖都用这个框架 所以它必须快.
gamma number | function <optional>
 1.0 该伽玛校正适用于此层. 1.0使用未经修改的图像颜色. 这可以是简单的数字,也可以是带有签名的函数 function(frameState, layer, x, y, level). The function is passed the 当前框架状态,此图层,以及 x, y, 和级别坐标 需要伽马的图像瓦,预计会返回 用于瓦片的伽马值。 函数为每个 每块瓷砖都用这个框架 所以它必须快.
splitDirection SplitDirection | function <optional>
 SplitDirection.NONE The SplitDirection split to apply to this layer.
minificationFilter TextureMinificationFilter <optional>
 TextureMinificationFilter.LINEAR The 用于此层的纹理分解过滤器。 可能数值 are TextureMinificationFilter.LINEAR and TextureMinificationFilter.NEAREST.
magnificationFilter TextureMagnificationFilter <optional>
 TextureMagnificationFilter.LINEAR The 用于此层的纹理分解过滤器。 可能数值 are TextureMagnificationFilter.LINEAR and TextureMagnificationFilter.NEAREST.
show boolean <optional>
 true True if the layer is shown; otherwise, false.
maximumAnisotropy number <optional>
 最大支持数 要使用的最大同位素水平 用于纹理过滤。 如果未指定此参数, 支持最大同位素 by the WebGL stack will be used. Larger values make the imagery look better in horizon views.
minimumTerrainLevel number <optional>
 最起码的地形水平 详细显示这个图像层, 或未定义以显示所有级别。 零级是最细化的级别.
maximumTerrainLevel number <optional>
 显示这个图像层的最大地形高度, 或未定义以显示所有级别。 零级是最细化的级别.
cutoutRectangle Rectangle <optional>
 ~Cartographic 矩切出这~ImageryLayer 的一部分.
colorToAlpha Color <optional>
 要用作α的颜色 .
colorToAlphaThreshold number <optional>
 0.004 Threshold for color-to-alpha.

Cesium.ImageryLayer.ErrorEventCallback(err)

发生错误时称为函数 .
This:
Name Type Description
err Error 一个关于发生错误的天体 .

Cesium.ImageryLayer.ReadyEventCallback(provider)

当提供者创建时调用的函数
This:
Name Type Description
provider ImageryProvider 创建的图像提供者.

Cesium.ImageryLayer.WorldImageryConstructorOptions

NT % 1 的初始化选项
Properties:
Name Type Attributes Default Description
options.style IonWorldImageryStyle <optional>
 IonWorldImageryStyle The style of base imagery, only AERIAL, AERIAL_WITH_LABELS, and ROAD are currently supported.
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.