BillboardCollection

new LSGlobe.BillboardCollection ( options )

Scene/BillboardCollection.js 140

广告牌的可渲染集合。广告牌与视口对齐图像放置在3D场景中。

示例广告牌

使用 BillboardCollection＃add 从集合中添加和删除广告牌和 BillboardCollection＃remove 。集合中的广告牌自动共享纹理对于具有相同标识符的图像。

Performance:

为获得最佳性能，请选择一些集合，每个集合包含许多广告牌，许多馆藏，每个馆藏只有几个广告牌。组织收藏，以便广告牌具有相同更新频率的广告集位于同一集合中，即没有更改应集中在一个集合中；更改每个框架的广告牌应放在另一个框架中采集;等等。

Name	Type	Description
options	Object	可选 具有以下属性的对象: 名称 类型 默认 说明 modelMatrix Matrix4 Matrix4.IDENTITY 可选 4x4转换矩阵，可将每个广告牌从模型转换为世界坐标。 debugShowBoundingVolume 布尔值 错误 可选 仅用于调试。确定是否显示该图元的命令的边界球。 场景 场景 可选 必须将使用高度参考属性的广告牌传递进去，否则将针对地球仪进行深度测试。 blendOption BlendOption BlendOption.OPAQUE_AND_TRANSLUCENT 可选 广告牌混合选项。默认值用于渲染不透明和半透明的广告牌。但是，如果所有广告牌都是完全不透明的或全部都是半透明的，将技术设置为BlendOption.OPAQUE或BlendOption.TRANSLUCENT最多可以将性能提高2倍。

Example:

// Create a billboard collection with two billboards
var billboards = scene.primitives.add(new LSGlobe.BillboardCollection());
billboards.add({
  position : new LSGlobe.Cartesian3(1.0, 2.0, 3.0),
  image : 'url/to/image'
});
billboards.add({
  position : new LSGlobe.Cartesian3(4.0, 5.0, 6.0),
  image : 'url/to/another/image'
});

Demo:

• Cesium Sandcastle Billboard Demo

See:

• BillboardCollection#add
• BillboardCollection#remove
• Billboard
• LabelCollection

Members

Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT

Default Value: false

Default Value: false

Default Value: Matrix4.IDENTITY

Example:

var center = LSGlobe.Cartesian3.fromDegrees(-75.59777, 40.03883);
billboards.modelMatrix = LSGlobe.Transforms.eastNorthUpToFixedFrame(center);
billboards.add({
  image : 'url/to/image',
  position : new LSGlobe.Cartesian3(0.0, 0.0, 0.0) // center
});
billboards.add({
  image : 'url/to/image',
  position : new LSGlobe.Cartesian3(1000000.0, 0.0, 0.0) // east
});
billboards.add({
  image : 'url/to/image',
  position : new LSGlobe.Cartesian3(0.0, 1000000.0, 0.0) // north
});
billboards.add({
  image : 'url/to/image',
  position : new LSGlobe.Cartesian3(0.0, 0.0, 1000000.0) // up
});

See:

• Transforms.eastNorthUpToFixedFrame

Methods

Performance:

调用 add 是预期的恒定时间。但是，集合的顶点缓冲区被重写- O（n） 操作也会导致CPU到GPU的开销。对于最佳性能，请在调用 update 之前添加尽可能多的广告牌。

Returns:

Throws:

• DeveloperError :此对象已销毁，即调用destroy（）。

Examples:

// Example 1:  Add a billboard, specifying all the default values.
var b = billboards.add({
  show : true,
  position : LSGlobe.Cartesian3.ZERO,
  pixelOffset : LSGlobe.Cartesian2.ZERO,
  eyeOffset : LSGlobe.Cartesian3.ZERO,
  heightReference : LSGlobe.HeightReference.NONE,
  horizontalOrigin : LSGlobe.HorizontalOrigin.CENTER,
  verticalOrigin : LSGlobe.VerticalOrigin.CENTER,
  scale : 1.0,
  image : 'url/to/image',
  imageSubRegion : undefined,
  color : LSGlobe.Color.WHITE,
  id : undefined,
  rotation : 0.0,
  alignedAxis : LSGlobe.Cartesian3.ZERO,
  width : undefined,
  height : undefined,
  scaleByDistance : undefined,
  translucencyByDistance : undefined,
  pixelOffsetScaleByDistance : undefined,
  sizeInMeters : false,
  distanceDisplayCondition : undefined
});

// Example 2:  Specify only the billboard's cartographic position.
var b = billboards.add({
  position : LSGlobe.Cartesian3.fromDegrees(longitude, latitude, height)
});

See:

• BillboardCollection#remove
• BillboardCollection#removeAll

Returns:

See:

• BillboardCollection#get

Throws:

• DeveloperError :此对象已销毁，即调用destroy（）。

Example:

billboards = billboards && billboards.destroy();

See:

• BillboardCollection#isDestroyed

Performance:

预计的固定时间。如果广告牌已从集合中移除，并且没有调用 BillboardCollection＃update ，这是一个隐式 O（n） 操作已执行。

Returns:

Throws:

• DeveloperError :此对象已销毁，即调用destroy（）。

Example:

// Toggle the show property of every billboard in the collection
var len = billboards.length;
for (var i = 0; i < len; ++i) {
  var b = billboards.get(i);
  b.show = !b.show;
}

See:

• BillboardCollection#length

Returns:

See:

• BillboardCollection#destroy

Performance:

调用 删除 是预期的固定时间。但是，集合的顶点缓冲区被重写- O（n） 操作也会导致CPU到GPU的开销。对于为获得最佳性能，请在调用 update 之前删除尽可能多的广告牌。如果您打算暂时隐藏广告牌，通常可以更有效地致电 Billboard＃show 而不是删除并重新添加广告牌。

Returns:

Throws:

• DeveloperError :此对象已销毁，即调用destroy（）。

Example:

var b = billboards.add(...);
billboards.remove(b);  // Returns true

See:

• BillboardCollection#add
• BillboardCollection#removeAll
• Billboard#show

Performance:

O（n） 。删除所有广告牌效率更高从集合中添加新集合，而不是完全创建一个新集合。

Throws:

• DeveloperError :此对象已销毁，即调用destroy（）。

Example:

billboards.add(...);
billboards.add(...);
billboards.removeAll();

See:

• BillboardCollection#add
• BillboardCollection#remove

Throws:

• RuntimeError :ID为ID的图片必须在地图集中。