PointPrimitiveCollection

成员 Members

默认值： Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT

默认值： Default Value: false

默认值： 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:

• Transforms.eastNorthUpToFixedFrame

默认值： Default Value: true

方法 Methods

性能： Performance:

Calling add 是预期的常数时间。然而，集合的顶点缓冲区被重写 is expected constant time. However, the collection's vertex buffer is rewritten - an O(n) 操作也会产生 CPU 到 GPU 的开销。为了获得最佳性能，请在调用之前添加尽可能多的 pointPrimitives operation that also incurs CPU to GPU overhead. For best performance, add as many pointPrimitives as possible before calling update.

返回： Returns:

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： 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:

• PointPrimitiveCollection#remove
• PointPrimitiveCollection#removeAll

返回： Returns:

另见： See:

• PointPrimitiveCollection#get

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： Example:

pointPrimitives = pointPrimitives && pointPrimitives.destroy();

另见： See:

• PointPrimitiveCollection#isDestroyed

性能： Performance:

预期时间恒定。如果点被从集合中移除并且 Expected constant time. If points were removed from the collection and PointPrimitiveCollection#update 没有被调用，隐式的 was not called, an implicit O(n) 执行操作。 operation is performed.

返回： Returns:

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： 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:

• PointPrimitiveCollection#length

返回： Returns:

另见： See:

• PointPrimitiveCollection#destroy

性能： Performance:

Calling remove 是预期的常数时间。然而，集合的顶点缓冲区被重写 is expected constant time. However, the collection's vertex buffer is rewritten - an O(n) 操作也会产生 CPU 到 GPU 的开销。为了获得最佳性能，请在调用之前删除尽可能多的点 operation that also incurs CPU to GPU overhead. For best performance, remove as many points as possible before calling update。如果您打算暂时隐藏一个点，通常调用更有效 . If you intend to temporarily hide a point, it is usually more efficient to call PointPrimitive#show 而不是删除并重新添加该点。 instead of removing and re-adding the point.

返回： Returns:

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： Example:

const p = pointPrimitives.add(...);
pointPrimitives.remove(p);  // Returns true

另见： See:

• PointPrimitiveCollection#add
• PointPrimitiveCollection#removeAll
• PointPrimitive#show

性能： Performance:

O(n)。从集合中删除所有点然后添加新点比完全创建新集合更有效。 . It is more efficient to remove all the points from a collection and then add new ones than to create a new collection entirely.

抛出： Throws:

• DeveloperError : This object was destroyed, i.e., destroy() was called.

示例： Example:

pointPrimitives.add(...);
pointPrimitives.add(...);
pointPrimitives.removeAll();

另见： See:

• PointPrimitiveCollection#add
• PointPrimitiveCollection#remove