SingleTileImageryProvider

new Cesium.SingleTileImageryProvider(options)
engine/Source/Scene/SingleTileImageryProvider.js 46

提供单个顶层影像瓦片。假定单个图像为地理投影（即 WGS84 / EPSG:4326）， 并将使用 GeographicTilingScheme 进行渲染。
Name Type Description
options SingleTileImageryProvider.ConstructorOptions 描述初始化选项的对象
See:

Members

readonly errorEvent : Event
engine/Source/Scene/SingleTileImageryProvider.js 213

获取当此影像提供者遇到异步错误时触发的事件。通过订阅该事件，您将被通知错误并可以潜在地从中恢复。事件监听器 会传递一个 TileProviderError 的实例。

readonly hasAlphaChannel : boolean
engine/Source/Scene/SingleTileImageryProvider.js 227

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

readonly maximumLevel : number|undefined
engine/Source/Scene/SingleTileImageryProvider.js 151

获取可以请求的最大细节级别。

readonly minimumLevel : number
engine/Source/Scene/SingleTileImageryProvider.js 163

获取可以请求的最小细节级别。

readonly proxy : Proxy
engine/Source/Scene/SingleTileImageryProvider.js 115

获取此提供者使用的代理。

readonly rectangle : Rectangle
engine/Source/Scene/SingleTileImageryProvider.js 187

获取此实例提供的影像的矩形，单位为弧度。

readonly tileDiscardPolicy : TileDiscardPolicy
engine/Source/Scene/SingleTileImageryProvider.js 200

获取瓦片丢弃策略。如果未定义，则丢弃策略负责通过其 shouldDiscardImage 函数筛选出“缺失”的瓦片。 如果此函数返回未定义，则不会筛选任何瓦片。

readonly tileHeight : number
engine/Source/Scene/SingleTileImageryProvider.js 139

获取每个瓦片的高度，单位为像素。

readonly tileWidth : number
engine/Source/Scene/SingleTileImageryProvider.js 127

获取每个瓦片的宽度，单位为像素。

readonly tilingScheme : TilingScheme
engine/Source/Scene/SingleTileImageryProvider.js 175

获取此提供者使用的瓦片方案。

readonly url : string
engine/Source/Scene/SingleTileImageryProvider.js 103

获取单个顶层影像瓦片的 URL。

Methods

static Cesium.SingleTileImageryProvider.fromUrl(url, options) → Promise.<SingleTileImageryProvider>
engine/Source/Scene/SingleTileImageryProvider.js 290

创建单个顶层影像瓦片的提供者。假定单个图像使用一个
Name Type Description
url Resource | String 瓦片的网址
options SingleTileImageryProvider.fromUrlOptions optional 描述初始化选项的对象。
Returns:
解析后的 SingleTileImageryProvider。
Example:
const provider = await SingleTileImageryProvider.fromUrl("https://yoururl.com/image.png");

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

获取在显示给定瓦片时要显示的信用信息。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片的级别；
Returns:
在显示瓦片时要显示的信用信息。

pickFeatures(x, y, level, longitude, latitude) → undefined
engine/Source/Scene/SingleTileImageryProvider.js 359

目前此影像提供者不支持拾取功能，因此此函数仅返回 未定义。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片的级别。
longitude number 要拾取特征的经度。
latitude number 要拾取特征的纬度。
Returns:
未定义，因为不支持拾取。

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

请求给定瓦片的图像。
Name Type Description
x number 瓦片的 X 坐标。
y number 瓦片的 Y 坐标。
level number 瓦片的级别。
request Request optional 请求对象。仅供内部使用。
Returns:
解析后的图像

Type Definitions

Cesium.SingleTileImageryProvider.ConstructorOptions
engine/Source/Scene/SingleTileImageryProvider.js 13

SingleTileImageryProvider 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
url Resource | string 瓦片的网址。
tileWidth number <optional>
 瓦片的宽度（以像素为单位）。
tileHeight number <optional>
 瓦片的高度（以像素为单位）。
rectangle Rectangle <optional>
 Rectangle.MAX_VALUE 图像覆盖的矩形（以弧度为单位）。
credit Credit | string <optional>
 数据源的信用信息，将显示在画布上。
ellipsoid Ellipsoid <optional>
 椭球体。如果未指定，则使用 WGS84 椭球体。

Cesium.SingleTileImageryProvider.fromUrlOptions
engine/Source/Scene/SingleTileImageryProvider.js 270

使用 SingleTileImageryProvider.fromUrl 时的 SingleTileImageryProvider 构造函数初始化选项
Properties:
Name Type Attributes Default Description
rectangle Rectangle <optional>
 Rectangle.MAX_VALUE 图像覆盖的矩形（以弧度为单位）。
credit Credit | String <optional>
 数据源的信用信息，将显示在画布上。
ellipsoid Ellipsoid <optional>
 椭球体。如果未指定，则使用 WGS84 椭球体。
需要帮助？获得答案的最快方法是来自社区和团队 Cesium Forum.
packages/engine
packages/widgets