在
new ImageryLayer(imageryProvider, options)
Globe
上顯示單個(gè)圖像提供者的平鋪圖像數(shù)據(jù)的圖像層。
Parameters:
options
(Object)
Name | Description |
---|---|
options.rectangle
Rectangle
default imageryProvider.rectangle
|
層的矩形。此矩形可以限制圖像提供者的可見部分。 |
options.alpha
(Number | function)
default 1.0
|
該層的alpha混合值,從0.0到1.0。這可以是一個(gè)簡單的數(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è)簡單的數(shù)字,也可以是一個(gè)帶有function(frameState, layer, x, y, level) 簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要亮度的圖像瓦片的X、Y和級(jí)別坐標(biāo),并期望返回用于瓦片的亮度值。該函數(shù)針對每一幀和每一個(gè)瓦片執(zhí)行,因此它必須是快速的。
|
options.contrast
(Number | function)
default 1.0
|
這層的對比度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低對比度,大于1.0則會(huì)增加對比度。這可以是一個(gè)簡單的數(shù)字,也可以是一個(gè)帶有function(frameState, layer, x, y, level) 簽名的函數(shù)。該函數(shù)傳遞當(dāng)前幀狀態(tài)、該層以及需要對比度的圖像瓦片的X、Y和級(jí)別坐標(biāo),并期望返回用于瓦片的對比度值。該函數(shù)針對每一幀和每一個(gè)瓦片執(zhí)行,因此它必須是快速的。
|
options.hue
(Number | function)
default 0.0
|
這層的色調(diào)。0.0使用未修改的圖像顏色。這可以是一個(gè)簡單的數(shù)字,也可以是一個(gè)帶有function(frameState, layer, x, y, level) 簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要色調(diào)的圖像瓦片的X、Y和級(jí)別坐標(biāo),并期望返回用于瓦片的對比度值。該函數(shù)針對每一幀和每一個(gè)瓦片執(zhí)行,因此它必須是快速的。
|
options.saturation
(Number | function)
default 1.0
|
這一層的飽和度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低飽和度,大于1.0則會(huì)增加飽和度。這可以是一個(gè)簡單的數(shù)字,也可以是一個(gè)帶有function(frameState, layer, x, y, level) 簽名的函數(shù)。該函數(shù)傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要飽和度的圖像瓦片的X、Y和級(jí)別坐標(biāo),并期望返回用于瓦片的對比度值。該函數(shù)針對每一幀和每一個(gè)瓦片執(zhí)行,因此它必須是快速的。
|
options.gamma
(Number | function)
default 1.0
|
應(yīng)用于該層的Gamma校正。1.0使用未修改的圖像顏色。這可以是一個(gè)簡單的數(shù)字,也可以是一個(gè)帶有function(frameState, layer, x, y, level) 簽名的函數(shù)。該函數(shù)將傳遞圖像瓦片的當(dāng)前幀狀態(tài)、該層以及需要gamma的圖像瓦片的X、Y和級(jí)別坐標(biāo),并預(yù)期返回用于瓦片的gamma值。該函數(shù)針對每一幀和每一個(gè)瓦片執(zhí)行,因此它必須是快速的。
|
options.splitDirection
(ImagerySplitDirection | function)
default ImagerySplitDirection.NONE
|
ImagerySplitDirection 拆分應(yīng)用于此層。
|
options.minificationFilter
TextureMinificationFilter
default TextureMinificationFilter.LINEAR
|
應(yīng)用于此層的紋理縮小過濾器。可能的值是TextureMinificationFilter.LINEAR 和TextureMinificationFilter.NEAREST 。
|
options.magnificationFilter
TextureMagnificationFilter
default TextureMagnificationFilter.LINEAR
|
應(yīng)用于此層的紋理縮小過濾器。可能的值是TextureMagnificationFilter.LINEAR 和TextureMagnificationFilter.NEAREST 。
|
options.show
Boolean
default true
|
如果顯示層,則為true;否則為false。 |
options.maximumAnisotropy
Number
default maximum supported
|
用于紋理過濾的最大各向異性級(jí)別。如果未指定此參數(shù),將使用WebGL堆棧支持的最大各向異性。較大的值使圖像在地平線視圖中看起來更好。 |
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)對比度。該值不會(huì)修改圖像的對比度。
-
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)建期間或圖像提供者沒有提供圖像層,則該值將用作圖像層的默認(rèn)色調(diào)。該值不會(huì)修改圖像的色調(diào)。
-
Default Value:
0.0
(static) DEFAULT_MAGNIFICATION_FILTER : TextureMagnificationFilter
如果在構(gòu)建期間或圖像提供者未提供圖像層,則該值用作圖像層的默認(rèn)紋理放大過濾器。
-
Default Value:
TextureMagnificationFilter.LINEAR
(static) DEFAULT_MINIFICATION_FILTER : TextureMinificationFilter
如果在構(gòu)建期間或圖像提供者未提供紋理縮小過濾器,則該值用作圖像層的默認(rèn)紋理縮小過濾器。
-
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
這層的對比度。1.0使用未修改的圖像顏色。小于1.0會(huì)降低對比度,大于1.0則會(huì)增加對比度。
-
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è)置此屬性。加載紋理后,將無法更改所使用的紋理過濾器。
-
Default Value:
ImageryLayer.DEFAULT_MAGNIFICATION_FILTER
minificationFilter : TextureMinificationFilter
應(yīng)用于該層的
TextureMinificationFilter
。可能的值是TextureMinificationFilter.LINEAR
(默認(rèn)值)和TextureMinificationFilter.NEAREST
。要生效,必須在添加圖像層后立即設(shè)置此屬性。加載紋理后,將無法更改所使用的紋理過濾器。
-
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()
銷毀此對象持有的WebGL資源。銷毀對象允許確定地釋放WebGL資源,而不是依賴?yán)占鱽礓N毀此對象。
一旦對象被破壞,就不應(yīng)使用它;調(diào)用除
一旦對象被破壞,就不應(yīng)使用它;調(diào)用除
isDestroyed
以外的任何函數(shù)都將導(dǎo)致DeveloperError
異常。因此,將返回值(undefined
)賦給對象,如示例中所述。
Throws
-
DeveloperError : 此對象已被銷毀,即調(diào)用destroy()。
計(jì)算該層矩形與圖像提供者的可用性矩形的交集,生成該層可以生成的圖像的整體邊界。
Example
// Zoom to an imagery layer.
imageryLayer.getViewableRectangle().then(function (rectangle) {
return camera.flyTo({
destination: rectangle
});
});
獲取一個(gè)值,該值指示此層是否是
ImageryLayerCollection
中的基礎(chǔ)層。底層是所有其他層的底層。它的特殊之處在于,它被視為具有全局矩形,即使它實(shí)際上不具有全局矩形,通過在整個(gè)地球的邊緣拉伸texel。
如果此對象被破壞,則返回true;否則返回false。
如果此對象被破壞,則不應(yīng)使用它;調(diào)用除
如果此對象被破壞,則不應(yīng)使用它;調(diào)用除
isDestroyed
以外的任何函數(shù)將導(dǎo)致DeveloperError
異常。