PrimitiveCollection

new Cesium.PrimitiveCollection ( options )

原始体的集合。这最常用于 Scene#primitives ,但是 PrimitiveCollection 本身也是一个原始类型,因此集合可以被添加到构成层次结构的集合中。
Name Type Description
options Object 可选 具有以下属性的对象:
名称 类型 默认 说明
show 布尔值 可选 确定是否将显示集合中的基元。
destroyPrimitives 布尔值 可选 确定在删除集合中的基元时是否将其销毁。
Example:
var billboards = new Cesium.BillboardCollection();
var labels = new Cesium.LabelCollection();

var collection = new Cesium.PrimitiveCollection();
collection.add(billboards);

scene.primitives.add(collection);  // Add collection
scene.primitives.add(labels);      // Add regular primitive

Members

destroyPrimitives : Boolean

Default Value: true
Examples:
// Example 1. Primitives are destroyed by default.
var primitives = new Cesium.PrimitiveCollection();
var labels = primitives.add(new Cesium.LabelCollection());
primitives = primitives.destroy();
var b = labels.isDestroyed(); // true
// Example 2. Do not destroy primitives in a collection.
var primitives = new Cesium.PrimitiveCollection();
primitives.destroyPrimitives = false;
var labels = primitives.add(new Cesium.LabelCollection());
primitives = primitives.destroy();
var b = labels.isDestroyed(); // false
labels = labels.destroy();    // explicitly destroy

readonly length : Number

获取集合中原语的数量。
确定是否将显示此集合中的基元。
Default Value: true

Methods

add (primitive, index ) Object

向集合添加一个原语。
Name Type Description
primitive Object 要添加的原语。
index Number 可选 在其上添加图层的索引。如果省略,则原语将 添加在所有现有图元的底部。
Returns:
添加到集合的原语。
Throws:
Example:
var billboards = scene.primitives.add(new Cesium.BillboardCollection());

contains ( primitive ) Boolean

确定此集合是否包含原语。
Name Type Description
primitive Object 可选 要检查的原语。
Returns:
真正 如果原语在集合中; 如果原语是 未定义 或在集合中找不到。
Throws:
See:
销毁此集合中每个原语所拥有的WebGL资源。明确销毁此收集允许确定性地释放WebGL资源,而不是依赖垃圾收藏家破坏了这个收藏。

由于破坏集合会破坏所有包含的原语,因此仅破坏集合当您确定没有其他代码仍在使用任何包含的原语时。

此收藏集一旦销毁,就不应使用;调用除 isDestroyed 将导致 DeveloperError 异常。因此,如示例中所述,将返回值( undefined )分配给对象。
Throws:
Example:
primitives = primitives && primitives.destroy();
See:
在指定索引处返回集合中的基元。
Name Type Description
index Number 要返回的图元的从零开始的索引。
Returns:
在的原始 指数
Throws:
Example:
// Toggle the show property of every primitive in the collection.
var primitives = scene.primitives;
var length = primitives.length;
for (var i = 0; i < length; ++i) {
  var p = primitives.get(i);
  p.show = !p.show;
}
See:

isDestroyed () Boolean

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

如果该对象被破坏,则不应使用。调用除 isDestroyed 将导致 DeveloperError 异常。
Returns:
如果该对象被破坏,则为true;否则为false。否则为假。
See:
在集合中降低原始的'向下一个'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将基元向下移动。
Name Type Description
primitive Object 可选 要降低的图元。
Throws:
See:

lowerToBottom ( primitive )

将基元降低到集合的'底部'。如果绘制了集合中的所有原语在地球表面上,这会在视觉上将图元移动到底部。
Name Type Description
primitive Object 可选 降低到最底端的图元。
Throws:
See:
在集合中引发原始的' up one'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将图元向上移动了一个。
Name Type Description
primitive Object 可选 要提出的原始内容。
Throws:
See:

raiseToTop ( primitive )

将原语提升到集合的'顶部'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将图元移动到顶部。
Name Type Description
primitive Object 可选 提升顶端的原始元素。
Throws:
See:

remove ( primitive ) Boolean

从集合中删除基本体。
Name Type Description
primitive Object 可选 要删除的原语。
Returns:
真正 如果原语已删除; 如果原语是 未定义 或在集合中找不到。
Throws:
Example:
var billboards = scene.primitives.add(new Cesium.BillboardCollection());
scene.primitives.remove(billboards);  // Returns true
See:
删除集合中的所有原语。
Throws:
See: