ImageryLayer

在Globe上顯示單個(gè)圖像提供者的平鋪圖像數(shù)據(jù)的圖像層。

new ImageryLayer(imageryProvider, options)

Parameters:

imageryProvider (ImageryProvider) 要使用的圖像提供商。

options (Object)

Name	Description
options.rectangle `Rectangle` default `imageryProvider.rectangle`	層的矩形。此矩形可以限制圖像提供者的可見(jiàn)部分。
options.alpha `(Number \| function)` default `1.0`	該層的alpha混合值，從0.0到1.0。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)將傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要Alpha的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并預(yù)期返回用于瓦片的Alpha值。
options.brightness `(Number \| function)` default `1.0`	該層的亮度。1.0使用未修改的圖像顏色。小于1.0會(huì)使圖像變暗，而大于1.0則會(huì)使圖像變亮。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要亮度的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并期望返回用于瓦片的亮度值。該函數(shù)針對(duì)每一幀和每一個(gè)瓦片執(zhí)行，因此它必須是快速的。
options.contrast `(Number \| function)` default `1.0`	這層的對(duì)比度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低對(duì)比度，大于1.0則會(huì)增加對(duì)比度。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)傳遞當(dāng)前幀狀態(tài)、該層以及需要對(duì)比度的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并期望返回用于瓦片的對(duì)比度值。該函數(shù)針對(duì)每一幀和每一個(gè)瓦片執(zhí)行，因此它必須是快速的。
options.hue `(Number \| function)` default `0.0`	這層的色調(diào)。0.0使用未修改的圖像顏色。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要色調(diào)的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并期望返回用于瓦片的對(duì)比度值。該函數(shù)針對(duì)每一幀和每一個(gè)瓦片執(zhí)行，因此它必須是快速的。
options.saturation `(Number \| function)` default `1.0`	這一層的飽和度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低飽和度，大于1.0則會(huì)增加飽和度。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要飽和度的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并期望返回用于瓦片的對(duì)比度值。該函數(shù)針對(duì)每一幀和每一個(gè)瓦片執(zhí)行，因此它必須是快速的。
options.gamma `(Number \| function)` default `1.0`	應(yīng)用于該層的Gamma校正。1.0使用未修改的圖像顏色。這可以是一個(gè)簡(jiǎn)單的數(shù)字，也可以是一個(gè)帶有`function(frameState, layer, x, y, level)`簽名的函數(shù)。該函數(shù)將傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要gamma的圖像瓦片的X、Y和級(jí)別坐標(biāo)，并預(yù)期返回用于瓦片的gamma值。該函數(shù)針對(duì)每一幀和每一個(gè)瓦片執(zhí)行，因此它必須是快速的。
options.splitDirection `(ImagerySplitDirection \| function)` default `ImagerySplitDirection.NONE`	`ImagerySplitDirection`拆分應(yīng)用于此層。
options.minificationFilter `TextureMinificationFilter` default `TextureMinificationFilter.LINEAR`	應(yīng)用于此層的紋理縮小過(guò)濾器?？赡艿闹凳?code>TextureMinificationFilter.LINEAR和`TextureMinificationFilter.NEAREST`。
options.magnificationFilter `TextureMagnificationFilter` default `TextureMagnificationFilter.LINEAR`	應(yīng)用于此層的紋理縮小過(guò)濾器。可能的值是`TextureMagnificationFilter.LINEAR`和`TextureMagnificationFilter.NEAREST`。
options.show `Boolean` default `true`	如果顯示層，則為true；否則為false。
options.maximumAnisotropy `Number` default `maximum supported`	用于紋理過(guò)濾的最大各向異性級(jí)別。如果未指定此參數(shù)，將使用WebGL堆棧支持的最大各向異性。較大的值使圖像在地平線視圖中看起來(lái)更好。
options.minimumTerrainLevel `Number`	顯示此圖像層的最低詳細(xì)地形級(jí)別，或未定義顯示所有級(jí)別的最低詳細(xì)地形級(jí)別。零級(jí)是最不詳細(xì)的級(jí)別。
options.maximumTerrainLevel `Number`	顯示此圖像層的最大詳細(xì)地形級(jí)別，或未定義顯示所有級(jí)別的最大詳細(xì)地形級(jí)別。零級(jí)是最不詳細(xì)的級(jí)別。
options.cutoutRectangle `Rectangle`	用于剪切此圖像層的一部分的繪圖矩形。
options.colorToAlpha `Color`	要用作alpha的顏色。
options.colorToAlphaThreshold `Number` default `0.004`	顏色到alpha的閾值。

Members

(static) DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number

如果在構(gòu)造期間或圖像提供者未提供顏色到alpha，則該值用作顏色到alpha的默認(rèn)閾值。

Default Value: 0.004

(static) DEFAULT_BRIGHTNESS : Number

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認(rèn)亮度。該值不會(huì)修改圖像的亮度。

Default Value: 1.0

(static) DEFAULT_CONTRAST : Number

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認(rèn)對(duì)比度。該值不會(huì)修改圖像的對(duì)比度。

Default Value: 1.0

(static) DEFAULT_GAMMA : Number

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值將用作圖像層的默認(rèn)gamma。該值不會(huì)修改圖像的gamma。

Default Value: 1.0

(static) DEFAULT_HUE : Number

如果在構(gòu)建期間或圖像提供者沒(méi)有提供圖像層，則該值將用作圖像層的默認(rèn)色調(diào)。該值不會(huì)修改圖像的色調(diào)。

Default Value: 0.0

(static) DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認(rèn)紋理放大過(guò)濾器。

Default Value: TextureMagnificationFilter.LINEAR

(static) DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果在構(gòu)建期間或圖像提供者未提供紋理縮小過(guò)濾器，則該值用作圖像層的默認(rèn)紋理縮小過(guò)濾器。

Default Value: TextureMinificationFilter.LINEAR

(static) DEFAULT_SATURATION : Number

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認(rèn)飽和度。該值不會(huì)修改圖像的飽和度。

Default Value: 1.0

(static) DEFAULT_SPLIT : ImagerySplitDirection

如果在構(gòu)建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認(rèn)分割。

Default Value: ImagerySplitDirection.NONE

alpha : Number

該層的alpha混合值，0.0表示完全透明，1.0表示完全不透明。

Default Value: 1.0

brightness : Number

該層的亮度。1.0使用未修改的圖像顏色。小于1.0會(huì)使圖像變暗，而大于1.0則會(huì)使圖像變亮。

Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

colorToAlpha : Color

應(yīng)設(shè)置為透明的顏色值。

colorToAlphaThreshold : Number

顏色到alpha的標(biāo)準(zhǔn)化（0-1）閾值。

contrast : Number

這層的對(duì)比度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低對(duì)比度，大于1.0則會(huì)增加對(duì)比度。

Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle

在這一層圖像中的矩形切口。

gamma : Number

應(yīng)用于該層的Gamma校正。1.0使用未修改的圖像顏色。

Default Value: ImageryLayer.DEFAULT_GAMMA

hue : Number

這層的色調(diào)以弧度表示。0.0使用未修改的圖像顏色。

Default Value: ImageryLayer.DEFAULT_HUE

(readonly) imageryProvider : ImageryProvider

獲取此層的圖像提供程序。

magnificationFilter : TextureMagnificationFilter

應(yīng)用于該層的TextureMagnificationFilter。可能的值是TextureMagnificationFilter.LINEAR（默認(rèn)值）和TextureMagnificationFilter.NEAREST。要生效，必須在添加圖像層后立即設(shè)置此屬性。加載紋理后，將無(wú)法更改所使用的紋理過(guò)濾器。

Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

應(yīng)用于該層的TextureMinificationFilter。可能的值是TextureMinificationFilter.LINEAR（默認(rèn)值）和TextureMinificationFilter.NEAREST。要生效，必須在添加圖像層后立即設(shè)置此屬性。加載紋理后，將無(wú)法更改所使用的紋理過(guò)濾器。

Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

(readonly) rectangle : Rectangle

獲取此層的矩形。如果此矩形小于ImageryProvider的矩形，則只顯示圖像提供者的一部分。

saturation : Number

這一層的飽和度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低飽和度，大于1.0則會(huì)增加飽和度。

Default Value: ImageryLayer.DEFAULT_SATURATION

show : Boolean

確定是否顯示此層。

Default Value: true

splitDirection : ImagerySplitDirection

應(yīng)用于該層的ImagerySplitDirection。

Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

destroy()

銷毀此對(duì)象持有的WebGL資源。銷毀對(duì)象允許確定地釋放WebGL資源，而不是依賴?yán)占鱽?lái)銷毀此對(duì)象。

一旦對(duì)象被破壞，就不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)都將導(dǎo)致DeveloperError異常。因此，將返回值（undefined）賦給對(duì)象，如示例中所述。

Example

imageryLayer = imageryLayer && imageryLayer.destroy();

Throws

DeveloperError : 此對(duì)象已被銷毀，即調(diào)用destroy（）。

See:

ImageryLayer#isDestroyed

getViewableRectangle() → {Promise.<Rectangle>}

計(jì)算該層矩形與圖像提供者的可用性矩形的交集，生成該層可以生成的圖像的整體邊界。

Example

// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
    return camera.flyTo({
        destination: rectangle
    });
});

isBaseLayer() → {Boolean}

獲取一個(gè)值，該值指示此層是否是ImageryLayerCollection中的基礎(chǔ)層。底層是所有其他層的底層。它的特殊之處在于，它被視為具有全局矩形，即使它實(shí)際上不具有全局矩形，通過(guò)在整個(gè)地球的邊緣拉伸texel。

isDestroyed() → {Boolean}

如果此對(duì)象被破壞，則返回true；否則返回false。

如果此對(duì)象被破壞，則不應(yīng)使用它；調(diào)用除isDestroyed以外的任何函數(shù)將導(dǎo)致DeveloperError異常。

See:

ImageryLayer#destroy