BIGEMAP卫星地图_高清卫星地图_北斗高清地图_地图软件_矢量地图数据_专题地图

可渲染的廣告牌集合。公告牌是在3D場(chǎng)景中定位的視區(qū)對(duì)齊的圖像。

示例廣告牌

廣告牌使用BillboardCollection#add和BillboardCollection#remove從集合中添加和刪除。集合中的公告牌自動(dòng)共享具有相同標(biāo)識(shí)符的圖像的紋理。

new BillboardCollection(options)

Parameters:

options (Object)

Name	Description
options.modelMatrix Matrix4 default Matrix4.IDENTITY	4x4轉(zhuǎn)換矩陣，將每個(gè)廣告牌從模型轉(zhuǎn)換為世界坐標(biāo)。
options.debugShowBoundingVolume Boolean default false	僅用于調(diào)試。確定是否顯示此基元的命令的邊界球。
options.scene Scene	必須通過(guò)使用高度參考屬性的廣告牌，或?qū)?duì)地球儀進(jìn)行深度測(cè)試。
options.blendOption BlendOption default BlendOption.OPAQUE_AND_TRANSLUCENT	廣告牌混合選項(xiàng)。默認(rèn)設(shè)置用于渲染不透明和半透明的廣告牌。但是，如果所有的廣告牌都是完全不透明的或者都是完全半透明的，那么將該技術(shù)設(shè)置為blendoption.opaque或blendoption.transparent可以將性能提高2倍。

Example

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

See:

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

Members

blendOption : BlendOption

Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT

debugShowBoundingVolume : Boolean

Default Value: false

debugShowTextureAtlas : Boolean

Default Value: false

length : Number

modelMatrix : Matrix4

Default Value: Matrix4.IDENTITY

See:

• Transforms.eastNorthUpToFixedFrame

Example:

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

Methods

Parameters:

// Example 1:  Add a billboard, specifying all the default values.
var b = billboards.add({
  show : true,
  position : bmgl.Cartesian3.ZERO,
  pixelOffset : bmgl.Cartesian2.ZERO,
  eyeOffset : bmgl.Cartesian3.ZERO,
  heightReference : bmgl.HeightReference.NONE,
  horizontalOrigin : bmgl.HorizontalOrigin.CENTER,
  verticalOrigin : bmgl.VerticalOrigin.CENTER,
  scale : 1.0,
  image : 'url/to/image',
  imageSubRegion : undefined,
  color : bmgl.Color.WHITE,
  id : undefined,
  rotation : 0.0,
  alignedAxis : bmgl.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 : bmgl.Cartesian3.fromDegrees(longitude, latitude, height)
});

Throws

• DeveloperError : 此對(duì)象已被銷(xiāo)毀，即調(diào)用destroy（）。

See:

• BillboardCollection#remove
• BillboardCollection#removeAll

Parameters:

See:

• BillboardCollection#get

billboards = billboards && billboards.destroy();

Throws

• DeveloperError : 此對(duì)象已被銷(xiāo)毀，即調(diào)用destroy（）。

See:

• BillboardCollection#isDestroyed

Parameters:

// 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;
}

Throws

• DeveloperError : 此對(duì)象已被銷(xiāo)毀，即調(diào)用destroy（）。

See:

• BillboardCollection#length

See:

• BillboardCollection#destroy

Parameters:

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

Throws

• DeveloperError : 此對(duì)象已被銷(xiāo)毀，即調(diào)用destroy（）。

See:

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

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

Throws

• DeveloperError : 此對(duì)象已被銷(xiāo)毀，即調(diào)用destroy（）。

See:

• BillboardCollection#add
• BillboardCollection#remove

Throws

• RuntimeError : 帶ID的圖像必須在地圖冊(cè)中。