ImageryLayer

在Globe上顯示單個圖像提供者的平鋪圖像數據的圖像層。

new ImageryLayer(imageryProvider, options)

Parameters:

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

options (Object)

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

Members

(static) DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number

如果在構造期間或圖像提供者未提供顏色到alpha，則該值用作顏色到alpha的默認閾值。

Default Value: 0.004

(static) DEFAULT_BRIGHTNESS : Number

如果在構建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認亮度。該值不會修改圖像的亮度。

Default Value: 1.0

(static) DEFAULT_CONTRAST : Number

如果在構建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認對比度。該值不會修改圖像的對比度。

Default Value: 1.0

(static) DEFAULT_GAMMA : Number

如果在構建期間或圖像提供者未提供圖像層，則該值將用作圖像層的默認gamma。該值不會修改圖像的gamma。

Default Value: 1.0

(static) DEFAULT_HUE : Number

如果在構建期間或圖像提供者沒有提供圖像層，則該值將用作圖像層的默認色調。該值不會修改圖像的色調。

Default Value: 0.0

(static) DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

如果在構建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認紋理放大過濾器。

Default Value: TextureMagnificationFilter.LINEAR

(static) DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

如果在構建期間或圖像提供者未提供紋理縮小過濾器，則該值用作圖像層的默認紋理縮小過濾器。

Default Value: TextureMinificationFilter.LINEAR

(static) DEFAULT_SATURATION : Number

如果在構建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認飽和度。該值不會修改圖像的飽和度。

Default Value: 1.0

(static) DEFAULT_SPLIT : ImagerySplitDirection

如果在構建期間或圖像提供者未提供圖像層，則該值用作圖像層的默認分割。

Default Value: ImagerySplitDirection.NONE

alpha : Number

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

Default Value: 1.0

brightness : Number

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

Default Value: ImageryLayer.DEFAULT_BRIGHTNESS

colorToAlpha : Color

應設置為透明的顏色值。

colorToAlphaThreshold : Number

顏色到alpha的標準化（0-1）閾值。

contrast : Number

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

Default Value: ImageryLayer.DEFAULT_CONTRAST

cutoutRectangle : Rectangle

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

gamma : Number

應用于該層的Gamma校正。1.0使用未修改的圖像顏色。

Default Value: ImageryLayer.DEFAULT_GAMMA

hue : Number

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

Default Value: ImageryLayer.DEFAULT_HUE

(readonly) imageryProvider : ImageryProvider

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

magnificationFilter : TextureMagnificationFilter

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

Default Value: ImageryLayer.DEFAULT_MAGNIFICATION_FILTER

minificationFilter : TextureMinificationFilter

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

Default Value: ImageryLayer.DEFAULT_MINIFICATION_FILTER

(readonly) rectangle : Rectangle

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

saturation : Number

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

Default Value: ImageryLayer.DEFAULT_SATURATION

show : Boolean

確定是否顯示此層。

Default Value: true

splitDirection : ImagerySplitDirection

應用于該層的ImagerySplitDirection。

Default Value: ImageryLayer.DEFAULT_SPLIT

Methods

destroy()

銷毀此對象持有的WebGL資源。銷毀對象允許確定地釋放WebGL資源，而不是依賴垃圾收集器來銷毀此對象。

一旦對象被破壞，就不應使用它；調用除isDestroyed以外的任何函數都將導致DeveloperError異常。因此，將返回值（undefined）賦給對象，如示例中所述。

Example

imageryLayer = imageryLayer && imageryLayer.destroy();

Throws

DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

ImageryLayer#isDestroyed

getViewableRectangle() → {Promise.<Rectangle>}

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

Example

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

isBaseLayer() → {Boolean}

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

isDestroyed() → {Boolean}

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

如果此對象被破壞，則不應使用它；調用除isDestroyed以外的任何函數將導致DeveloperError異常。

See:

ImageryLayer#destroy

婷婷久久网-婷婷久久久久-婷婷久久久-婷婷久-国产微拍精品一区-国产网址在线观看

Parameters:

Members

(static) DEFAULT_APPLY_COLOR_TO_ALPHA_THRESHOLD : Number

(static) DEFAULT_BRIGHTNESS : Number

(static) DEFAULT_CONTRAST : Number

(static) DEFAULT_GAMMA : Number

(static) DEFAULT_HUE : Number

(static) DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter

(static) DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter

(static) DEFAULT_SATURATION : Number

(static) DEFAULT_SPLIT : ImagerySplitDirection

alpha : Number

brightness : Number

colorToAlpha : Color

colorToAlphaThreshold : Number

contrast : Number

cutoutRectangle : Rectangle

gamma : Number

hue : Number

(readonly) imageryProvider : ImageryProvider

magnificationFilter : TextureMagnificationFilter

minificationFilter : TextureMinificationFilter

(readonly) rectangle : Rectangle

saturation : Number

show : Boolean

splitDirection : ImagerySplitDirection

Methods

Example

Throws

See:

Example

See: