PointPrimitiveCollection

new Cesium.PointPrimitiveCollection ( options )
Scene/PointPrimitiveCollection.js 119

点的可渲染集合。

使用 PointPrimitiveCollection＃add 从集合中添加和删除点和 PointPrimitiveCollection＃remove 。
Performance:

为获得最佳性能，请选择一些集合，每个集合都有很多要点许多集合，每个集合只有几个要点。组织收藏，以便点具有相同更新频率的点位于同一集合中，即更改应集中在一个集合中；改变每一帧的点应该在另一帧中采集;等等。

Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 默认 说明
modelMatrix Matrix4 Matrix4.IDENTITY 可选 4x4转换矩阵，将每个点从模型转换为世界坐标。
debugShowBoundingVolume 布尔值 错误 可选 仅用于调试。确定是否显示此图元命令的边界球。
blendOption BlendOption BlendOption.OPAQUE_AND_TRANSLUCENT 可选 点混合选项。默认值用于渲染不透明和半透明点。但是，如果所有点完全不透明或全部完全透明，将技术设置为BlendOption.OPAQUE或BlendOption.TRANSLUCENT最多可以将性能提高2倍。
Example: 
// Create a pointPrimitive collection with two points
var points = scene.primitives.add(new Cesium.PointPrimitiveCollection());
points.add({
  position : new Cesium.Cartesian3(1.0, 2.0, 3.0),
  color : Cesium.Color.YELLOW
});
points.add({
  position : new Cesium.Cartesian3(4.0, 5.0, 6.0),
  color : Cesium.Color.CYAN
});
See:
翻译by:http://cesium.xin

Members

blendOption : BlendOption
Scene/PointPrimitiveCollection.js 213

点混合选项。默认值用于渲染不透明和半透明点。但是，如果所有点完全不透明或全部完全透明，将技术设置为BlendOption.OPAQUE或BlendOption.TRANSLUCENT可以改善性能提高了2倍。
Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT

debugShowBoundingVolume : Boolean
Scene/PointPrimitiveCollection.js 203

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

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

Default Value: false

length : Number
Scene/PointPrimitiveCollection.js 248

返回此集合中的点数。这通常与 PointPrimitiveCollection＃get 遍历所有点在集合中。

modelMatrix : Matrix4
Scene/PointPrimitiveCollection.js 190

4x4转换矩阵，用于将该集合中的每个点从模型转换为世界坐标。如果这是单位矩阵，则将在世界坐标（即地球的WGS84坐标）中绘制pointPrimitives。可以通过提供不同的转换矩阵（如返回的矩阵）来使用局部参考系通过 Transforms.eastNorthUpToFixedFrame 。
Default Value: Matrix4.IDENTITY
Example: 
var center = Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883);
pointPrimitives.modelMatrix = Cesium.Transforms.eastNorthUpToFixedFrame(center);
pointPrimitives.add({
  color : Cesium.Color.ORANGE,
  position : new Cesium.Cartesian3(0.0, 0.0, 0.0) // center
});
pointPrimitives.add({
  color : Cesium.Color.YELLOW,
  position : new Cesium.Cartesian3(1000000.0, 0.0, 0.0) // east
});
pointPrimitives.add({
  color : Cesium.Color.GREEN,
  position : new Cesium.Cartesian3(0.0, 1000000.0, 0.0) // north
});
pointPrimitives.add({
  color : Cesium.Color.CYAN,
  position : new Cesium.Cartesian3(0.0, 0.0, 1000000.0) // up
});
See:

Methods

add ( options ) → PointPrimitive
Scene/PointPrimitiveCollection.js 300

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

调用 add 是预期的恒定时间。但是，集合的顶点缓冲区被重写- O（n） 操作也会导致CPU到GPU的开销。对于为获得最佳性能，请在调用 update 之前添加尽可能多的pointPrimitive。

Name Type Description
options Object 可选 描述该点的属性的模板，如示例1所示。
Returns:
添加到集合中的点。
Throws:
Examples: 
// Example 1:  Add a point, specifying all the default values.
var p = pointPrimitives.add({
  show : true,
  position : Cesium.Cartesian3.ZERO,
  pixelSize : 10.0,
  color : Cesium.Color.WHITE,
  outlineColor : Cesium.Color.TRANSPARENT,
  outlineWidth : 0.0,
  id : undefined
});
// Example 2:  Specify only the point's cartographic position.
var p = pointPrimitives.add({
  position : Cesium.Cartesian3.fromDegrees(longitude, latitude, height)
});
See:

contains ( pointPrimitive ) → Boolean
Scene/PointPrimitiveCollection.js 407

检查此集合是否包含给定点。
Name Type Description
pointPrimitive PointPrimitive 可选 要检查的点。
Returns:
如果此集合包含该点，则为true，否则为false。
See:

destroy ()
Scene/PointPrimitiveCollection.js 1054

销毁此对象拥有的WebGL资源。销毁对象可以确定性释放WebGL资源，而不是依靠垃圾回收器来破坏此对象。

一旦物体被破坏，就不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。因此，如示例中所述，将返回值（ undefined ）分配给对象。
Throws:
Example: 
pointPrimitives = pointPrimitives && pointPrimitives.destroy();
See:

get (index) → PointPrimitive
Scene/PointPrimitiveCollection.js 438

返回集合中指定索引处的点。指标从零开始并随着积分的增加而增加。删除点会在之后移动所有点它在左侧，更改了索引。该功能通常用于 PointPrimitiveCollection＃length 遍历所有点在集合中。
Performance:

预计的固定时间。如果从集合中删除了积分，并且没有调用 PointPrimitiveCollection＃update ，这是一个隐式 O（n） 操作已执行。

Name Type Description
index Number 点的从零开始的索引。
Returns:
指定索引处的点。
Throws:
Example: 
// Toggle the show property of every point in the collection
var len = pointPrimitives.length;
for (var i = 0; i < len; ++i) {
  var p = pointPrimitives.get(i);
  p.show = !p.show;
}
See:

isDestroyed () → Boolean
Scene/PointPrimitiveCollection.js 1034

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

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

remove (pointPrimitive) → Boolean
Scene/PointPrimitiveCollection.js 333

从集合中删除一个点。
Performance:

调用 删除 是预期的固定时间。但是，集合的顶点缓冲区被重写- O（n） 操作也会导致CPU到GPU的开销。对于为获得最佳性能，请在调用 update 之前删除尽可能多的点。如果您打算暂时隐藏一个点，通常调用起来效率更高 PointPrimitive＃show 而不是删除并重新添加该点。

Name Type Description
pointPrimitive PointPrimitive 要删除的点。
Returns:
真正 如果该点已删除； 假 如果在集合中找不到该点。
Throws:
Example: 
var p = pointPrimitives.add(...);
pointPrimitives.remove(p);  // Returns true
See:

removeAll ()
Scene/PointPrimitiveCollection.js 362

从集合中删除所有点。
Performance:

O（n） 。删除所有点更有效从一个集合中添加新集合，而不是完全创建一个新集合。

Throws:
Example: 
pointPrimitives.add(...);
pointPrimitives.add(...);
pointPrimitives.removeAll();
See: