PolylineCollection

多段線的可渲染集合。

示例多段線

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

new PolylineCollection(options)

Parameters:

options (Object)

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

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

此屬性僅用于調試；它既不用于生產，也不進行優化。

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

Default Value: false

length : Number

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

modelMatrix : Matrix4

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

Default Value: Matrix4.IDENTITY

Methods

add(options) → {Polyline}

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

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 : 此對象已被銷毀，即調用destroy（）。

See:

contains(polyline) → {Boolean}

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

Parameters:

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

See:

PolylineCollection#get

destroy()

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

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

Example

polylines = polylines && polylines.destroy();

Throws

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

See:

PolylineCollection#isDestroyed

get(index) → {Polyline}

返回集合中指定索引處的多段線。索引以零為基礎，并隨著多段線的添加而增加。刪除多段線后，所有多段線都將向左移動，從而更改其索引。此函數通常與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 : 此對象已被銷毀，即調用destroy（）。

See:

PolylineCollection#length

isDestroyed() → {Boolean}

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

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

See:

PolylineCollection#destroy

remove(polyline) → {Boolean}

從集合中刪除多段線。

Parameters:

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

Example

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

Throws

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

See:

removeAll()

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

Example

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

Throws

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

See:

update()

當Viewer或BMWidget渲染場景以獲取渲染此原語所需的繪制命令時調用。

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

Throws

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

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

Parameters:

Example

See:

Members

debugShowBoundingVolume : Boolean

length : Number

modelMatrix : Matrix4

Methods

Parameters:

Example

Throws

See:

Parameters:

See:

Example

Throws

See:

Parameters:

Example

Throws

See:

See:

Parameters:

Example

Throws

See:

Example

Throws

See:

Throws