PointPrimitiveCollection

点图元集合是一个包含点图元的可视化集合，可以用于创建和管理大量的点图元，提供精细的自定义和交互性能。

构造函数

new PointPrimitiveCollection(options?)

创建一个新的点图元集合实例。

参数

• options object 可选：一个包含下列属性的配置对象：

  • blendOption BlendOption 可选：控制颜色混合方式，默认值为 BlendOption.OPAQUE
  • debugShowBoundingVolume boolean 可选：是否在绘制之前显示包围盒，默认值为 false
  • debugShowShadowVolume boolean 可选：是否在绘制之前显示阴影包围盒，默认值为 false
  • modelMatrix Matrix4 可选：该点图元集合的模型变换矩阵，默认值为 Matrix4.IDENTITY
  • pickPrimitiveId number 可选：该点图元集合关联的唯一ID，默认值为 undefined
  • shadows ShadowMode 可选：控制该点图元集合产生阴影的方式，默认值为 ShadowMode.DISABLED
  • vertexCacheOptimize boolean 可选：是否优化图元属性以最大化渲染性能，默认值为 true

返回值

• PointPrimitiveCollection 实例：一个新的点图元集合实例。

实例属性

• id Object 类型：该点图元集合的唯一ID。
• length number 类型：该点图元集合中点图元的数量。

实例方法

add(pointPrimitive)

将一个点图元添加到该点图元集合中。

参数

• pointPrimitive PointPrimitive：要添加到集合中的点图元。

返回值

• number：新添加点图元的索引值。

get(index)

获取指定索引值上的点图元。

参数

• index number：要获取的点图元的索引值。

返回值

• PointPrimitive：指定索引值上的点图元。

getBoundingSphere(result?)

计算该点图元集合的包围球。

参数

• result BoundingSphere 可选：存储包围球的实例。

返回值

• BoundingSphere：该点图元集合的包围球。

isDestroyed()

判断该点图元集合是否已销毁。

返回值

• boolean：如果该点图元集合已销毁，则返回 true，否则返回 false。

remove(pointPrimitive)

将指定的点图元从该点图元集合中移除。

参数

• pointPrimitive PointPrimitive：要从集合中移除的点图元。

返回值

• boolean：如果移除成功，则返回 true，否则返回 false。

removeAll()

移除该点图元集合中的所有点图元。

返回值

• undefined：该方法没有返回值。

update()

更新该点图元集合。

返回值

• undefined：该方法没有返回值。

destroy()

销毁该点图元集合和所有的点图元。

返回值

• undefined：该方法没有返回值。

事件

该点图元集合有以下事件：

• collectionChanged：当点图元集合发生了改变时触发该事件。事件对象的 elements 属性是一个包含两个属性的对象，分别是被添加或移除的点图元数组，例如 {added: [PointPrimitive], removed: [PointPrimitive]}。

要使用事件，可使用以下代码：

var event = pointPrimitiveCollection.collectionChanged;
event.addEventListener(function (eventObject) {
  // do something
});