BillboardCollection

概述

BillboardCollection 类用于批量渲染图像标注（billboard）对象，相较于单个个体渲染，可以大幅提高性能。标注对象主要用于绘制简易的图标、符号等。

创建对象

可通过以下方式创建 BillboardCollection 对象：

var billboardCollection = new Cesium.BillboardCollection();

属性

BlendOption

BlendOption 枚举类型，表示不同的混合方式，可供选择的方式有：OPAQUE、ALPHA_BLEND 和 DISABLED。

方法

add

用于向当前对象中添加标注对象：

var billboard = new Cesium.Billboard({
    image: 'image.png',
    position: Cesium.Cartesian3.fromDegrees(118.123, 32.123),
    scale: 2.0
});

billboardCollection.add(billboard);

remove

用于从当前对象中移除标注对象：

billboardCollection.remove(billboard);

removeAll

用于移除当前对象中的所有标注对象：

billboardCollection.removeAll();

contains

用于判断当前对象是否包含某个标注对象：

billboardCollection.contains(billboard);

get

用于根据索引获取对应位置的标注对象：

var billboard = billboardCollection.get(0);

destroy

用于销毁当前对象：

billboardCollection.destroy();

示例

以下示例演示了如何创建 BillboardCollection 对象，向其中添加标注对象，并将其添加至场景中：

var viewer = new Cesium.Viewer('cesiumContainer');
var billboardCollection = new Cesium.BillboardCollection();

var billboard1 = new Cesium.Billboard({
    image: 'image1.png',
    position: Cesium.Cartesian3.fromDegrees(118.123, 32.123),
    scale: 2.0
});

var billboard2 = new Cesium.Billboard({
    image: 'image2.png',
    position: Cesium.Cartesian3.fromDegrees(118.456, 32.456),
    scale: 1.5
});

billboardCollection.add(billboard1);
billboardCollection.add(billboard2);
viewer.scene.primitives.add(billboardCollection);

参考文献

• Cesium官方文档