原始体的集合。这最常用于
Scene#primitives
,但是
PrimitiveCollection
本身也是一个原始变量,因此集合可以被添加到构成层次结构的集合中。
Name | Type | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options
|
Object |
可选
具有以下属性的对象:
|
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
确定在将集合中的基元删除时是否销毁它们
PrimitiveCollection#destroy
或
PrimitiveCollection#remove
< /a>或隐式通过
PrimitiveCollection#removeAll
。
-
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
获取集合中基元的数量。
确定是否将显示此集合中的基元。
-
Default Value:
true
Methods
向集合添加一个原语。
Name | Type | Description |
---|---|---|
primitive
|
Object | 要添加的原语。 |
index
|
Number | 可选 在其上添加图层的索引。如果省略,则原语将 添加在所有现有图元的底部。 |
Returns:
添加到集合的原语。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。
Example:
var billboards = scene.primitives.add(new Cesium.BillboardCollection());
确定此集合是否包含原语。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 要检查的原语。 |
Returns:
真正
如果原语在集合中;
假
如果原语是
未定义
或在集合中找不到。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。
销毁此集合中每个原语所拥有的WebGL资源。明确销毁此收集允许确定性地释放WebGL资源,而不是依赖垃圾收藏家破坏了这个收藏。
由于破坏集合会破坏所有包含的原语,因此仅破坏集合当您确定没有其他代码仍在使用任何包含的原语时。
此收藏集一旦销毁,就不应使用;调用除
由于破坏集合会破坏所有包含的原语,因此仅破坏集合当您确定没有其他代码仍在使用任何包含的原语时。
此收藏集一旦销毁,就不应使用;调用除
isDestroyed
将导致
DeveloperError
异常。因此,如示例中所述,将返回值(
undefined
)分配给对象。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。
Example:
primitives = primitives && primitives.destroy();
See:
在指定索引处返回集合中的基元。
Name | Type | Description |
---|---|---|
index
|
Number | 要返回的图元的从零开始的索引。 |
Returns:
在的原始
指数
。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。
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:
Returns:
如果该对象被破坏,则为true;否则为假。
在集合中降低原始的'向下一个'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将基元向下移动。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 要降低的图元。 |
Throws:
-
DeveloperError :原始不在此集合中。
-
DeveloperError :此对象已销毁,即调用destroy()。
将基元降低到集合的'底部'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将图元移动到底部。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 降低到最底端的图元。 |
Throws:
-
DeveloperError :原始不在此集合中。
-
DeveloperError :此对象已销毁,即调用destroy()。
在集合中引发原始的' up one'。如果绘制了集合中的所有原语在地球表面上,这在视觉上将图元向上移动了一个。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 要提出的原始内容。 |
Throws:
-
DeveloperError :原始不在此集合中。
-
DeveloperError :此对象已销毁,即调用destroy()。
将原语提升到集合的'顶部'。如果绘制了集合中的所有原语在地球表面上,这会在视觉上将图元移动到顶部。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 提升顶端的原始元素。 |
Throws:
-
DeveloperError :原始不在此集合中。
-
DeveloperError :此对象已销毁,即调用destroy()。
从集合中删除基本体。
Name | Type | Description |
---|---|---|
primitive
|
Object | 可选 要删除的原语。 |
Returns:
真正
如果原语已删除;
假
如果原语是
未定义
或在集合中找不到。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。
Example:
var billboards = scene.primitives.add(new Cesium.BillboardCollection());
scene.primitives.remove(p); // Returns true
See:
删除集合中的所有原语。
Throws:
-
DeveloperError :此对象已销毁,即调用destroy()。