ImageryProvider

Members

readonlycredit : Credit

获取该影像提供者激活时要显示的凭证。通常情况下，该功能用于注明影像来源。 此函数不应在 ImageryProvider#ready 返回 true 之前调用。

defaultAlpha : Number

该提供程序的默认 alpha 混合值，0.0 表示完全透明，1.0 表示完全不透明。

Default Value: undefined

defaultBrightness : Number

该提供程序的默认亮度。1.0 使用未修改的影像颜色。小于 1.0 会使影像变暗，大于 1.0 则会使影像变亮。

Default Value: undefined

defaultContrast : Number

该提供程序的默认对比度。1.0 使用未修改的影像颜色。小于 1.0 会降低对比度，大于 1.0 则会提高对比度。

Default Value: undefined

defaultGamma : Number

应用于该提供程序的默认伽玛校正。1.0使用未修改的影像颜色。

Default Value: undefined

defaultHue : Number

该提供程序的默认色调（以弧度为单位）。0.0 使用未修改的影像颜色。

Default Value: undefined

defaultSaturation : Number

该提供程序的默认饱和度。1.0 使用未修改的影像颜色。小于 1.0 会降低饱和度，大于 1.0 则会提高饱和度。

Default Value: undefined

readonlyerrorEvent : Event

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

readonlyhasAlphaChannel : Boolean

获取指示该影像提供程序提供的影像是否包含 alpha 通道的值。如果该属性为 false，则会忽略存在的 alpha 通道。 如果该属性为 true，任何不包含 alpha 通道的影像都将被视为其 alpha 值为 1.0 的影像。 此属性为false时，内存使用量和纹理上传时间都会减少。

readonlymaximumLevel : Number

获取可请求的最大精细级别。在 ImageryProvider#ready 返回 true 之前不应调用此函数。

readonlyminimumLevel : Number

获取可请求的最小精细级别。在 ImageryProvider#ready 返回 true 之前不应调用此函数。 一般来说，只有当影像的矩形范围足够小，以至于最小级别的瓦片数量很少时，才应使用最小级别。 如果影像提供器的最小级别瓦片数量超过几个，就会导致渲染问题。

readonlyproxy : Proxy

获取该提供程序使用的代理。

readonlyready : Boolean

获取表示提供程序是否可以使用的值。

readonlyreadyPromise : Promise.<Boolean>

获取当提供程序准备就绪时解析为 true 的Promise。

readonlyrectangle : Rectangle

获取实例提供的影像的矩形（以弧度为单位）。此函数不应在 ImageryProvider#ready 返回 true 之前调用。

readonlytileDiscardPolicy : TileDiscardPolicy

获取瓦片丢弃策略。 如果未定义，则丢弃策略负责通过其 shouldDiscardImage 函数过滤 "丢失 "的瓦片。 如果此函数返回未定义，则不会过滤任何瓦片。 在ImageryProvider#ready返回 true 之前，不应调用此函数。

readonlytileHeight : Number

获取每个瓦片的高度（以像素为单位）。 此函数应 在 ImageryProvider#ready 返回 true 之前不应调用。

readonlytileWidth : Number

获取每个瓦片的宽度（以像素为单位）。 此函数不应在 ImageryProvider#ready 返回 true 之前调用。

readonlytilingScheme : TilingScheme

获取影像提供程序使用的切图方案。此函数不应在ImageryProvider#ready返回 true 之前调用。

Methods

staticSuperMap3D.ImageryProvider.loadImage(imageryProvider, url, Package) → Promise.<(Image|Canvas)>|undefined

从给定的 URL 加载图片。如果 URL 引用的服务器已经有太多请求等待处理，该函数将返回未定义，表示请求应稍后重试。

Name	Type	Description
imageryProvider	ImageryProvider	URL 的影像提供者。
url	Resource | String	影像的 URL。
Package	packingRequest	请求编码。

Returns:

影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多请求，则未定义该Promise，请求应稍后重试。 解析的影像可以是影像或 Canvas DOM 对象。

getTileCredits(x, y, level) → Array.<Credit>

获取显示给定瓦片时要显示的凭证。

Name	Type	Description
x	Number	瓦片的 X 坐标。
y	Number	瓦片的 y 坐标。
level	Number	瓦片的级别。

Returns:

显示瓦片时要显示的凭证。

Throws:

• DeveloperError : getTileCredits 不得在影像提供程序准备就绪前调用。

pickFeatures(x, y, level, longitude, latitude) → Promise.<Array.<ImageryLayerFeatureInfo>>|undefined

异步确定瓦片中给定经度和纬度处的地物（如果有的话）。 在 ImageryProvider#ready 返回 true 之前不应调用此函数。 此函数为可选函数，因此并非所有影像提供程序都有此函数。

Name	Type	Description
x	Number	瓦片的 X 坐标。
y	Number	瓦片的 y 坐标。
level	Number	瓦片的级别。
longitude	Number	选取特征的经度。
latitude	Number	选取特征的纬度。

Returns:

当异步提取完成时，将解析所提取特征的Promise。 解析值是一个由 ImageryLayerFeatureInfo 实例组成的数组。 如果在给定位置没有找到特征，数组可能为空。 如果不支持提取，该数组也可能是未定义的。

Throws:

• DeveloperError : pickFeatures 不得在影像提供程序准备就绪前调用。

requestImage(x, y, level, request) → Promise.<(Image|Canvas)>|undefined

请求指定瓦片的影像。此函数不应在 ImageryProvider#ready 返回 true 之前调用。

Name	Type	Description
x	Number	瓦片的 X 坐标。
y	Number	瓦片的 y 坐标。
level	Number	瓦片的级别。
request	Request	optional 请求对象。仅供内部使用。

Returns:

影像的Promise，该Promise将在影像可用时解析该影像；如果服务器上有太多请求，则未定义该Promise，请求应稍后重试。 解析的影像可以是影像或 Canvas DOM 对象。

Throws:

• DeveloperError : requestImage 不得在影像提供程序准备就绪前调用。