ImageryProvider

提供要顯示在橢球表面上的圖像。此類型描述接口，不打算直接實例化。

new ImageryProvider()

See:

Members

(readonly) credit : 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

應用于此提供程序的默認gamma更正。1.0使用未修改的圖像顏色。

Default Value: undefined

defaultHue : Number

此提供程序的默認色調（以弧度表示）。0.0使用未修改的圖像顏色。

Default Value: undefined

defaultMagnificationFilter : TextureMagnificationFilter

應用于此提供程序的默認紋理放大過濾器。

Default Value: undefined

defaultMinificationFilter : TextureMinificationFilter

應用于此提供程序的默認紋理縮小過濾器。

Default Value: undefined

defaultSaturation : Number

此提供程序的默認飽和度。1.0使用未修改的圖像顏色。小于1.0會降低飽和度，大于1.0則會增加飽和度。

Default Value: undefined

(readonly) errorEvent : Event

獲取圖像提供程序遇到異步錯誤時引發的事件。通過訂閱事件，您將收到錯誤通知，并可能從中恢復。向事件偵聽器傳遞TileProviderError的實例。

(readonly) hasAlphaChannel : Boolean

獲取一個值，該值指示此圖像提供程序提供的圖像是否包含alpha通道。如果此屬性為假，則忽略alpha通道（如果存在）。如果此屬性為真，則任何沒有alpha通道的圖像都將被視為其alpha在任何地方都是1.0。如果該屬性為假，則會減少內存使用和紋理上載時間。

(readonly) maximumLevel : Number

獲取可以請求的最大詳細級別。在ImageryProvider#ready返回true之前，不應調用此函數。

(readonly) minimumLevel : Number

獲取可以請求的最低詳細級別。在ImageryProvider#ready返回true之前，不應調用此函數。一般情況下，只有當圖像的矩形足夠小，最小級別的瓦片數量很小時，才應使用最小級別。如果圖像提供者在最低級別上具有多個瓦片，則會導致渲染問題。

(readonly) proxy : Proxy

獲取此提供程序使用的代理。

(readonly) ready : Boolean

獲取一個值，該值指示提供程序是否準備好使用。

(readonly) readyPromise : Promise.<Boolean>

獲取當提供程序準備好使用時解析為true的承諾。

(readonly) rectangle : Rectangle

獲取實例提供的圖像的矩形（以弧度表示）。在ImageryProvider#ready返回true之前，不應調用此函數。

(readonly) tileDiscardPolicy : TileDiscardPolicy

獲取瓦片丟棄策略。如果未定義，則丟棄策略負責通過其shouldDiscardimage函數過濾掉“丟失”的瓦片。如果此函數返回UNdefined，則不會篩選任何瓦片。在ImageryProvider#ready返回true之前，不應調用此函數。

(readonly) tileHeight : Number

獲取每個瓦片的高度（像素）。在ImageryProvider#ready返回true之前，不應調用此函數。

(readonly) tileWidth : Number

獲取每個瓦片的寬度（像素）。在ImageryProvider#ready返回true之前，不應調用此函數。

(readonly) tilingScheme : TilingScheme

獲取提供程序使用的平鋪方案。切片方案。在ImageryProvider#ready返回true之前，不應調用此函數。

Methods

(static) loadImage(imageryProvider, url) → {Promise.<(Image|Canvas)>|undefined}

從給定的URL加載圖像。如果URL引用的服務器已經有太多掛起的請求，則此函數將返回Undefined，指示稍后應重試該請求。

Parameters:

imageryProvider (ImageryProvider) URL的圖像提供商。

url ((Resource | String)) 圖像的URL。

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

獲取顯示給定瓦片時要顯示的片尾。

Parameters:

x (Number) 瓦片X坐標。

y (Number) 瓦片Y坐標。

level (Number) 瓦片級別；

Throws

DeveloperError : getTileCredits在圖像提供者準備就緒之前不得調用。

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

異步地確定瓦片中給定經度和緯度的哪些特性（如果有的話）。在ImageryProvider#ready返回true之前，不應調用此函數。此函數是可選的，因此它可能不存在于所有ImageryProviders上。

Parameters:

x (Number) 瓦片X坐標。

y (Number) 瓦片Y坐標。

level (Number) 瓦片級別。

longitude (Number) 選擇特征的經度。

latitude (Number) 選擇特征的緯度。

Throws

DeveloperError : pickFeatures在圖像提供者準備就緒之前不得調用。

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

請求給定瓦片的圖像。在ImageryProvider#ready返回true之前，不應調用此函數。

Parameters:

x (Number) 瓦片X坐標。

y (Number) 瓦片Y坐標。

level (Number) 瓦片級別。

request (Request) 請求對象。僅供內部使用。

Throws

DeveloperError : requestImage在圖像提供者準備就緒之前不得調用。