ImageryProvider

abstract new Cesium.ImageryProvider()
engine/Source/Scene/ImageryProvider.js 45

提供要在椭球表面显示的影像。此类型描述了一个 接口，不打算直接实例化。
Demo:
See:

Members

readonly credit : Credit
engine/Source/Scene/ImageryProvider.js 145

获取此影像提供器处于活动状态时要显示的版权信息。通常这用于标注 影像的来源。

readonly errorEvent : Event
engine/Source/Scene/ImageryProvider.js 134

获取一个事件，在影像提供器遇到异步错误时触发。通过订阅 该事件，你将在发生错误时收到通知，并有可能从中恢复。事件监听器 会收到一个 TileProviderError 实例。

readonly hasAlphaChannel : boolean
engine/Source/Scene/ImageryProvider.js 169

获取一个值，指示此影像提供器所提供的图像 是否包含 alpha 通道。如果此属性为 false，则 alpha 通道（如果存在）将 被忽略。如果此属性为 true，则任何没有 alpha 通道的图像将被视为 其 alpha 处处为 1.0。当此属性为 false 时，内存占用 和纹理上传时间都会减少。

readonly maximumLevel : number|undefined
engine/Source/Scene/ImageryProvider.js 86

获取可以请求的最大细节层级（level-of-detail）。

readonly minimumLevel : number
engine/Source/Scene/ImageryProvider.js 100

获取可以请求的最小细节层级。通常， 只有当影像的矩形区域足够小，使得最小层级下的瓦片数量较少时， 才应使用最小层级。一个在最小层级下包含较多瓦片的影像 提供器会导致 渲染问题。

readonly proxy : Proxy
engine/Source/Scene/ImageryProvider.js 155

获取此提供器使用的代理（proxy）。

readonly rectangle : Rectangle
engine/Source/Scene/ImageryProvider.js 56

获取该实例所提供影像的矩形区域（单位：弧度）。

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/ImageryProvider.js 122

获取瓦片丢弃策略。如果不为 undefined，该丢弃策略负责 通过其 shouldDiscardImage 函数过滤掉“缺失”的瓦片。如果此函数 返回 undefined，则不会过滤任何瓦片。

readonly tileHeight : number
engine/Source/Scene/ImageryProvider.js 76

获取每个瓦片的高度（单位：像素）。

readonly tileWidth : number
engine/Source/Scene/ImageryProvider.js 66

获取每个瓦片的宽度（单位：像素）。

readonly tilingScheme : TilingScheme
engine/Source/Scene/ImageryProvider.js 110

获取此提供器使用的切片方案。

Methods

static Cesium.ImageryProvider.loadImage(imageryProvider, url) → Promise.<(ImageryTypes|CompressedTextureBuffer)>|undefined
engine/Source/Scene/ImageryProvider.js 240

从给定 URL 加载图像。如果该 URL 所引用的服务器已经有 太多待处理请求，则此函数会返回 undefined，表示 该请求应稍后重试。
Name Type Description
imageryProvider ImageryProvider 该 URL 对应的影像提供器。
url Resource | string 图像的 URL。
Returns:
一个 promise，在图像可用时解析；或者 如果服务器有太多活动请求，则返回 undefined，此时应稍后重试该请求。

getTileCredits(x, y, level) → Array.<Credit>
engine/Source/Scene/ImageryProvider.js 182

获取显示特定瓦片时要显示的版权信息。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片层级；
Returns:
显示该瓦片时要显示的版权信息。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined
engine/Source/Scene/ImageryProvider.js 218

异步确定在瓦片内给定经度和纬度处存在哪些要素（如果有）。 此函数是可选的，因此并非所有 ImageryProvider 上都一定存在。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片层级。
longitude number 用于拾取要素的经度。
latitude number 用于拾取要素的纬度。
Returns:
一个 promise，在异步 拾取完成时解析。解析后得到的值是 ImageryLayerFeatureInfo 实例的数组。如果在给定位置未找到要素，数组可能为空。 如果不支持拾取，则也可能为 undefined。

requestImage(x, y, level, request) → Promise.<ImageryTypes>|undefined
engine/Source/Scene/ImageryProvider.js 196

请求给定瓦片的图像。
Name Type Description
x number 瓦片 X 坐标。
y number 瓦片 Y 坐标。
level number 瓦片层级。
request Request optional 请求对象。仅供内部使用。
Returns:
返回一个 promise，在图像可用时解析；或者 如果服务器有太多活动请求，则返回 undefined，此时应稍后重试该请求。
需要帮助？获取答案的最快方式是在 Cesium 论坛 上向社区和团队提问。
CtrlK
packages/engine
packages/widgets