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

標簽的可渲染集合。標簽是定位在三維場景中的視區對齊文本。每個標簽可以有不同的字體、顏色、比例等。

示例標簽

使用LabelCollection#add和LabelCollection#remove從集合中添加和刪除標簽。

new LabelCollection(options)

Parameters:

options (Object)

Name	Description
options.modelMatrix Matrix4 default Matrix4.IDENTITY	將每個標簽從模型轉換為世界坐標的4x4轉換矩陣。
options.debugShowBoundingVolume Boolean default false	僅用于調試。確定是否顯示此基元的命令的邊界球。
options.scene Scene	必須傳遞給使用高度參考屬性的標簽，否則將對球體進行深度測試。
options.blendOption BlendOption default BlendOption.OPAQUE_AND_TRANSLUCENT	標簽混合選項。默認值用于渲染不透明和半透明標簽。但是，如果所有標簽都是完全不透明的或都是完全半透明的，則將該技術設置為blendoption.opaque或blendoption.transparent可將性能提高2倍。

Example

// Create a label collection with two labels
var labels = scene.primitives.add(new bmgl.LabelCollection());
labels.add({
  position : new bmgl.Cartesian3(1.0, 2.0, 3.0),
  text : 'A label'
});
labels.add({
  position : new bmgl.Cartesian3(4.0, 5.0, 6.0),
  text : 'Another label'
});

See:

• LabelCollection#add
• LabelCollection#remove
• Label
• BillboardCollection

Members

blendOption : BlendOption

Default Value: BlendOption.OPAQUE_AND_TRANSLUCENT

debugShowBoundingVolume : Boolean

Default Value: false

length : Number

modelMatrix : Matrix4

Default Value: Matrix4.IDENTITY

Example:

var center = bmgl.Cartesian3.fromDegrees(-75.59777, 40.03883);
labels.modelMatrix = bmgl.Transforms.eastNorthUpToFixedFrame(center);
labels.add({
  position : new bmgl.Cartesian3(0.0, 0.0, 0.0),
  text     : 'Center'
});
labels.add({
  position : new bmgl.Cartesian3(1000000.0, 0.0, 0.0),
  text     : 'East'
});
labels.add({
  position : new bmgl.Cartesian3(0.0, 1000000.0, 0.0),
  text     : 'North'
});
labels.add({
  position : new bmgl.Cartesian3(0.0, 0.0, 1000000.0),
  text     : 'Up'
});

Methods

Parameters:

// Example 1:  Add a label, specifying all the default values.
var l = labels.add({
  show : true,
  position : bmgl.Cartesian3.ZERO,
  text : '',
  font : '30px sans-serif',
  fillColor : bmgl.Color.WHITE,
  outlineColor : bmgl.Color.BLACK,
  outlineWidth : 1.0,
  showBackground : false,
  backgroundColor : new bmgl.Color(0.165, 0.165, 0.165, 0.8),
  backgroundPadding : new bmgl.Cartesian2(7, 5),
  style : bmgl.LabelStyle.FILL,
  pixelOffset : bmgl.Cartesian2.ZERO,
  eyeOffset : bmgl.Cartesian3.ZERO,
  horizontalOrigin : bmgl.HorizontalOrigin.LEFT,
  verticalOrigin : bmgl.VerticalOrigin.BASELINE,
  scale : 1.0,
  translucencyByDistance : undefined,
  pixelOffsetScaleByDistance : undefined,
  heightReference : HeightReference.NONE,
  distanceDisplayCondition : undefined
});

// Example 2:  Specify only the label's cartographic position,
// text, and font.
var l = labels.add({
  position : bmgl.Cartesian3.fromRadians(longitude, latitude, height),
  text : 'Hello World',
  font : '24px Helvetica',
});

Throws

• DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

• LabelCollection#remove
• LabelCollection#removeAll

Parameters:

See:

• LabelCollection#get

labels = labels && labels.destroy();

Throws

• DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

• LabelCollection#isDestroyed

Parameters:

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

Throws

• DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

• LabelCollection#length

See:

• LabelCollection#destroy

Parameters:

var l = labels.add(...);
labels.remove(l);  // Returns true

Throws

• DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

• LabelCollection#add
• LabelCollection#removeAll
• Label#show

labels.add(...);
labels.add(...);
labels.removeAll();

Throws

• DeveloperError : 此對象已被銷毀，即調用destroy（）。

See:

• LabelCollection#add
• LabelCollection#remove