PointPrimitiveCollection

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

可渲染的点集合。

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

为了获得最佳性能，请选择几个集合，每个集合都有很多点，而不是多个集合，每个集合只有几个点。组织集合，使更新频率相同的点在同一个集合中，即不变的点应该在一个集合中；改变每一帧的点应该在另一个集合中；等等。

Name Type Description
options Object 具有以下属性的 可选 对象:
姓名 类型 默认 描述
modelMatrix 矩阵4 Matrix4.IDENTITY 可选 将每个点从模型坐标转换为世界坐标的 4x4 转换矩阵。
debugShowBoundingVolume 布尔值 false 可选 仅用于调试。确定是否显示此原语的命令的边界球。
blendOption 混合选项 BlendOption.OPAQUE_AND_TRANSLUCENT 可选 点融合选项。默认值用于渲染不透明点和半透明点。但是，如果所有点都完全不透明或完全半透明，则将技术设置为 BlendOption.OPAQUE 或 BlendOption.TRANSLUCENT 可以将性能提高多达 2 倍。
show 布尔值 true 可选 确定是否将显示集合中的基元。
Example: 
// Create a pointPrimitive collection with two points
const 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:

Members

blendOption : BlendOption
Scene/PointPrimitiveCollection.js 199

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

debugShowBoundingVolume : Boolean
Scene/PointPrimitiveCollection.js 186

该属性仅用于调试；它不是用于生产用途，也不是优化的。

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

Default Value: false

length : Number
Scene/PointPrimitiveCollection.js 237

返回此集合中的点数。这通常与 PointPrimitiveCollection#get 一起使用以遍历集合中的所有点。

modelMatrix : Matrix4
Scene/PointPrimitiveCollection.js 171

将此集合中的每个点从模型转换为世界坐标的 4x4 转换矩阵。当这是单位矩阵时，pointPrimitives 是在世界坐标系中绘制的，即地球的 WGS84 坐标系。可以通过提供不同的变换矩阵来使用本地参考帧，就像 Transforms.eastNorthUpToFixedFrame 返回的那样。
Default Value: Matrix4.IDENTITY
Example: 
const 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:

show : Boolean
Scene/PointPrimitiveCollection.js 137

确定是否将显示此集合中的基元。
Default Value: true

Methods

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

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

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

Name Type Description
options Object 可选 描述点属性的模板，如示例 1 所示。
Returns:
添加到集合中的点。
Throws:
Examples: 
// Example 1:  Add a point, specifying all the default values.
const 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.
const p = pointPrimitives.add({
  position : Cesium.Cartesian3.fromDegrees(longitude, latitude, height)
});
See:

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

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

destroy ()
Scene/PointPrimitiveCollection.js 1208

销毁此对象持有的 WebGL 资源。销毁一个对象允许确定性地释放 WebGL 资源，而不是依赖垃圾收集器来销毁这个对象。

一旦一个对象被销毁，它就不应该被使用；调用 isDestroyed 以外的任何函数都会导致 DeveloperError 异常。因此，如示例中所做的那样，将返回值 ( undefined ) 分配给对象。
Throws:
Example: 
pointPrimitives = pointPrimitives && pointPrimitives.destroy();
See:

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

返回集合中指定索引处的点。指数从零开始，随着点数的增加而增加。删除一个点会将其后的所有点向左移动，从而更改它们的索引。此函数通常与 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
const len = pointPrimitives.length;
for (let i = 0; i < len; ++i) {
  const p = pointPrimitives.get(i);
  p.show = !p.show;
}
See:

isDestroyed () → Boolean
Scene/PointPrimitiveCollection.js 1188

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

如果这个对象被破坏了，它就不应该被使用；调用 isDestroyed 以外的任何函数都将导致 DeveloperError 异常。
Returns:
如果此对象被销毁，则为 true ；否则， false 。
See:

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

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

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

Name Type Description
pointPrimitive PointPrimitive 要删除的点。
Returns:
如果该点已被删除，则为 true ；如果在集合中未找到该点，则为 false 。
Throws:
Example: 
const p = pointPrimitives.add(...);
pointPrimitives.remove(p);  // Returns true
See:

removeAll ()
Scene/PointPrimitiveCollection.js 351

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

O(n) 。从集合中删除所有点然后添加新点比完全创建新集合更有效。

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