在
new ImageryLayer(imageryProvider, options)
Globe上顯示單個圖像提供者的平鋪圖像數據的圖像層。
Parameters:
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_BRIGHTNESScolorToAlpha : Color
應設置為透明的顏色值。
colorToAlphaThreshold : Number
顏色到alpha的標準化（0-1）閾值。
contrast : Number
這層的對比度。1.0使用未修改的圖像顏色。小于1.0會降低對比度，大于1.0則會增加對比度。
-
Default Value:
ImageryLayer.DEFAULT_CONTRASTcutoutRectangle : Rectangle
在這一層圖像中的矩形切口。
gamma : Number
應用于該層的Gamma校正。1.0使用未修改的圖像顏色。
-
Default Value:
ImageryLayer.DEFAULT_GAMMAhue : Number
這層的色調以弧度表示。0.0使用未修改的圖像顏色。
-
Default Value:
ImageryLayer.DEFAULT_HUE(readonly) imageryProvider : ImageryProvider
獲取此層的圖像提供程序。
magnificationFilter : TextureMagnificationFilter
應用于該層的
TextureMagnificationFilter。可能的值是TextureMagnificationFilter.LINEAR（默認值）和TextureMagnificationFilter.NEAREST。要生效，必須在添加圖像層后立即設置此屬性。加載紋理后，將無法更改所使用的紋理過濾器。
-
Default Value:
ImageryLayer.DEFAULT_MAGNIFICATION_FILTERminificationFilter : 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_SATURATIONshow : Boolean
確定是否顯示此層。
-
Default Value:
true
splitDirection : ImagerySplitDirection
應用于該層的
ImagerySplitDirection。
-
Default Value:
ImageryLayer.DEFAULT_SPLITMethods
destroy()
銷毀此對象持有的WebGL資源。銷毀對象允許確定地釋放WebGL資源，而不是依賴垃圾收集器來銷毀此對象。
一旦對象被破壞，就不應使用它；調用除
一旦對象被破壞，就不應使用它；調用除
isDestroyed以外的任何函數都將導致DeveloperError異常。因此，將返回值（undefined）賦給對象，如示例中所述。
Throws
-
DeveloperError : 此對象已被銷毀，即調用destroy（）。
計算該層矩形與圖像提供者的可用性矩形的交集，生成該層可以生成的圖像的整體邊界。
Example
// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
return camera.flyTo({
destination: rectangle
});
});
獲取一個值，該值指示此層是否是
ImageryLayerCollection中的基礎層。底層是所有其他層的底層。它的特殊之處在于，它被視為具有全局矩形，即使它實際上不具有全局矩形，通過在整個地球的邊緣拉伸texel。