PolylineCollection

多段線的可渲染集合。

示例多段線

多段線使用PolylineCollection#add和PolylineCollection#remove從集合中添加和刪除。

new PolylineCollection(options)

Parameters:

options (Object)

Name	Description
options.modelMatrix `Matrix4` default `Matrix4.IDENTITY`	將每個多段線從模型坐標(biāo)轉(zhuǎn)換為世界坐標(biāo)的4x4變換矩陣。
options.debugShowBoundingVolume `Boolean` default `false`	僅用于調(diào)試。確定是否顯示此基元的命令的邊界球。

Example

// Create a polyline collection with two polylines
var polylines = new bmgl.PolylineCollection();
polylines.add({
  positions : bmgl.Cartesian3.fromDegreesArray([
    -75.10, 39.57,
    -77.02, 38.53,
    -80.50, 35.14,
    -80.12, 25.46]),
  width : 2
});

polylines.add({
  positions : bmgl.Cartesian3.fromDegreesArray([
    -73.10, 37.57,
    -75.02, 36.53,
    -78.50, 33.14,
    -78.12, 23.46]),
  width : 4
});

See:

Members

debugShowBoundingVolume : Boolean

此屬性僅用于調(diào)試；它既不用于生產(chǎn)，也不進行優(yōu)化。

為基本體中的每個draw命令繪制邊界球體。

Default Value: false

length : Number

返回此集合中多段線的數(shù)目。這通常與PolylineCollection#get一起用于迭代集合中的所有多段線。

modelMatrix : Matrix4

4x4轉(zhuǎn)換矩陣，用于將此集合中的每個多段線從模型坐標(biāo)轉(zhuǎn)換為世界坐標(biāo)。當(dāng)這是單位矩陣時，多段線以世界坐標(biāo)繪制，即地球的wgs84坐標(biāo)。本地參考幀可以通過提供不同的轉(zhuǎn)換矩陣來使用，如Transforms.eastNorthUpToFixedFrame返回的轉(zhuǎn)換矩陣。

Default Value: Matrix4.IDENTITY

Methods

add(options) → {Polyline}

創(chuàng)建具有指定初始屬性的多段線并將其添加到集合中。將返回添加的多段線，以便以后可以從集合中修改或刪除它。

Parameters:

options (Object) 描述多段線屬性的模板，如示例1所示。

Example

// Example 1:  Add a polyline, specifying all the default values.
var p = polylines.add({
  show : true,
  positions : ellipsoid.cartographicArrayToCartesianArray([
           bmgl.Cartographic.fromDegrees(-75.10, 39.57),
           bmgl.Cartographic.fromDegrees(-77.02, 38.53)]),
  width : 1
});

Throws

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

See:

contains(polyline) → {Boolean}

確定此集合是否包含指定的多段線。

Parameters:

polyline (Polyline) 要檢查的多段線。

See:

PolylineCollection#get

destroy()

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

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

Example

polylines = polylines && polylines.destroy();

Throws

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

See:

PolylineCollection#isDestroyed

get(index) → {Polyline}

返回集合中指定索引處的多段線。索引以零為基礎(chǔ)，并隨著多段線的添加而增加。刪除多段線后，所有多段線都將向左移動，從而更改其索引。此函數(shù)通常與PolylineCollection#length一起用于迭代集合中的所有多段線。

Parameters:

index (Number) 折線的從零開始的索引。

Example

// Toggle the show property of every polyline in the collection
var len = polylines.length;
for (var i = 0; i < len; ++i) {
  var p = polylines.get(i);
  p.show = !p.show;
}

Throws

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

See:

PolylineCollection#length

isDestroyed() → {Boolean}

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

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

See:

PolylineCollection#destroy

remove(polyline) → {Boolean}

從集合中刪除多段線。

Parameters:

polyline (Polyline) 要刪除的多段線。

Example

var p = polylines.add(...);
polylines.remove(p);  // Returns true

Throws

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

See:

removeAll()

從集合中刪除所有多段線。

Example

polylines.add(...);
polylines.add(...);
polylines.removeAll();

Throws

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

See:

update()

當(dāng)Viewer或BMWidget渲染場景以獲取渲染此原語所需的繪制命令時調(diào)用。

不要直接調(diào)用此函數(shù)。這只是為了列出渲染場景時可能傳播的異常：

Throws

RuntimeError : 需要頂點紋理獲取支持來渲染具有每個實例屬性的基本體。頂點紋理圖像單位的最大數(shù)目必須大于零。