PolylineCollection

new Cesium.PolylineCollection ( options )

折线的可渲染集合。


折线示例


使用 PolylineCollection#add 从集合中添加和删除折线和 PolylineCollection#remove
Performance:

为获得最佳性能,请选择一些集合,每个集合都包含多段折线,许多集合,每个集合只有几个折线。组织集合,以便折线具有相同更新频率的数据位于同一集合中,即不具有更改应集中在一个集合中;更改每一帧的折线应位于另一帧中采集;等等。

Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 默认 说明
modelMatrix Matrix4 Matrix4.IDENTITY 可选 4x4转换矩阵,可将每条折线从模型转换为世界坐标。
debugShowBoundingVolume 布尔值 错误 可选 仅用于调试。确定是否显示该图元的命令的边界球。
Example:
// Create a polyline collection with two polylines
var polylines = new Cesium.PolylineCollection();
polylines.add({
  positions : Cesium.Cartesian3.fromDegreesArray([
    -75.10, 39.57,
    -77.02, 38.53,
    -80.50, 35.14,
    -80.12, 25.46]),
  width : 2
});

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

Members

debugShowBoundingVolume : Boolean

此属性仅用于调试。它不是用于生产用途,也不是经过优化的。

为图元中的每个绘制命令绘制边界球。

Default Value: false
返回此集合中的折线数。这通常与 PolylineCollection#get 遍历所有折线在集合中。
4x4转换矩阵,用于将该集合中的每条折线从模型坐标转换为世界坐标。当这是单位矩阵时,折线将以世界坐标(即地球的WGS84坐标)绘制。可以通过提供不同的转换矩阵(如返回的矩阵)来使用局部参考系通过 Transforms.eastNorthUpToFixedFrame
Default Value: Matrix4.IDENTITY

Methods

创建具有指定初始属性的折线并将其添加到集合中。返回添加的折线,以便以后可以对其进行修改或从集合中删除它。
Performance:

调用 add 后,调用 PolylineCollection#update ,集合的顶点缓冲区将被重写- O(n) 操作也将导致CPU到GPU的开销。为了获得最佳性能,请在调用 update 之前添加尽可能多的折线。

Name Type Description
options Object 可选 描述折线属性的模板,如示例1所示。
Returns:
添加到集合中的折线。
Throws:
Example:
// Example 1:  Add a polyline, specifying all the default values.
var p = polylines.add({
  show : true,
  positions : ellipsoid.cartographicArrayToCartesianArray([
           Cesium.Cartographic.fromDegrees(-75.10, 39.57),
           Cesium.Cartographic.fromDegrees(-77.02, 38.53)]),
  width : 1
});
See:

contains (polyline) Boolean

确定此集合是否包含指定的折线。
Name Type Description
polyline Polyline 要检查的折线。
Returns:
如果此集合包含折线,则为true,否则为false。
See:
销毁此对象拥有的WebGL资源。销毁对象可以确定性释放WebGL资源,而不是依赖垃圾回收器破坏此对象。

一旦物体被破坏,就不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。因此,如示例中所述,将返回值( undefined )分配给对象。
Throws:
Example:
polylines = polylines && polylines.destroy();
See:
在指定索引处返回集合中的折线。指标从零开始并随着增加折线而增加。删除折线会在之后移动所有折线它在左侧,更改了索引。此功能通常用于 PolylineCollection#length 遍历所有折线在集合中。
Performance:

如果从集合中删除了折线,并且没有调用 PolylineCollection#update ,这是一个隐式 O(n) 操作已执行。

Name Type Description
index Number 折线从零开始的索引。
Returns:
指定索引处的折线。
Throws:
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;
}
See:

isDestroyed () Boolean

如果此对象已销毁,则返回true;否则返回false。否则为假。

如果该对象被破坏,则不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。
Returns:
真正 该物体是否被破坏;除此以外,
See:

remove (polyline) Boolean

从集合中删除折线。
Performance:

调用 remove 后,调用 PolylineCollection#update ,集合的顶点缓冲区将被重写- O(n) 操作也将导致CPU到GPU的开销。为了获得最佳性能,请在调用 update 之前删除尽可能多的折线。如果您打算暂时隐藏折线,通常调用它会更有效 Polyline#show 而不是删除并重新添加折线。

Name Type Description
polyline Polyline 要删除的折线。
Returns:
真正 如果折线已删除; 如果在集合中未找到折线。
Throws:
Example:
var p = polylines.add(...);
polylines.remove(p);  // Returns true
See:
从集合中删除所有折线。
Performance:

O(n) 。删除所有折线效率更高从集合中添加新集合,而不是完全创建一个新集合。

Throws:
Example:
polylines.add(...);
polylines.add(...);
polylines.removeAll();
See:
Viewer CesiumWidget 渲染场景时调用至获取渲染该图元所需的绘制命令。

不要直接调用此函数。这只是为了列出渲染场景时可能传播的异常:

Throws:
  • RuntimeError :需要使用顶点纹理获取来渲染具有每个实例属性的图元。顶点纹理图像单元的最大数量必须大于零。