Members
layerAdded : Event
將層添加到集合時引發的事件。事件處理程序將傳遞給添加的層和添加該層的索引。
-
Default Value:
Event()
layerMoved : Event
層更改集合中的位置時引發的事件。事件處理程序將傳遞給已移動的層、移動后的新索引以及移動前的舊索引。
-
Default Value:
Event()
layerRemoved : Event
從集合中移除層時引發的事件。事件處理程序將傳遞給已刪除的層和從中刪除該層的索引。
-
Default Value:
Event()
layerShownOrHidden : Event
通過設置
ImageryLayer#show
屬性顯示或隱藏層時引發的事件。事件處理程序將傳遞一個對此層的引用、集合中層的索引,以及一個標志,如果層現在顯示,則為真;如果層現在隱藏,則為假。
-
Default Value:
Event()
length : Number
獲取此集合中的層數。
Methods
add(layer, index)
向集合中添加層。
Parameters:
index
(Number)
添加層的索引。如果省略,該層將添加到所有現有層的頂部。
Throws
-
DeveloperError : 索引(如果提供)必須大于或等于零且小于或等于層數。
使用給定的ImageryProvider創建新層并將其添加到集合中。
Parameters:
index
(Number)
添加層的索引。如果省略,該層將添加到所有現有層的頂部。
檢查集合是否包含給定層。
Parameters:
銷毀此集合中所有層持有的WebGL資源。顯式銷毀此對象允許確定地釋放WebGL資源,而不是依賴垃圾收集器。
此對象銷毀后,不應使用它;調用除
此對象銷毀后,不應使用它;調用除
isDestroyed
以外的任何函數都將導致DeveloperError
異常。因此,將返回值(undefined
)賦給對象,如示例中所述。
Throws
-
DeveloperError : 此對象已被銷毀,即調用destroy()。
從集合中按索引獲取層。
Parameters:
index
(Number)
要檢索的索引。
確定集合中給定層的索引。
Parameters:
在集合中將層降低一個位置。
Parameters:
Throws
-
DeveloperError : 層不在此集合中。
-
DeveloperError : 此對象已被銷毀,即調用destroy()。
將層降低到集合的底部。
Parameters:
Throws
-
DeveloperError : 層不在此集合中。
-
DeveloperError : 此對象已被銷毀,即調用destroy()。
異步確定與拾取光線相交的圖像層特征。通過調用
ImageryProvider#pickFeatures
為每個圖像層(與拾取光線相交)的瓦片,可以找到相交的圖像層特征。要從屏幕上的某個位置計算拾取光線,請使用Camera.getPickRay
。
Parameters:
Example
var pickRay = viewer.camera.getPickRay(windowPosition);
var featuresPromise = viewer.imageryLayers.pickImageryLayerFeatures(pickRay, viewer.scene);
if (!bmgl.defined(featuresPromise)) {
console.log('No features picked.');
} else {
bmgl.when(featuresPromise, function(features) {
// This function is called asynchronously when the list if picked features is available.
console.log('Number of features: ' + features.length);
if (features.length > 0) {
console.log('First feature name: ' + features[0].name);
}
});
}
在集合中向上提升一個層。
Parameters:
Throws
-
DeveloperError : 層不在此集合中。
-
DeveloperError : 此對象已被銷毀,即調用destroy()。
將層提升到集合的頂部。
Parameters:
Throws
-
DeveloperError : 層不在此集合中。
-
DeveloperError : 此對象已被銷毀,即調用destroy()。
刪除此集合中的層(如果存在)。
Parameters:
destroy
(Boolean)
(default true
)
是否在移除層的同時銷毀層。
刪除此集合中的所有層。
Parameters:
destroy
(Boolean)
(default true
)
是否在移除層的同時銷毀層。