new Cesium.Billboard ()

Scene/Billboard.js 78

创建了位于3D场景中的视口对齐图像并使用 BillboardCollection 进行渲染。创建一个广告牌及其首字母通过调用 BillboardCollection #add 来设置属性。

示例广告牌

Performance:

读取属性（例如 Billboard #show ）是固定时间。分配给属性是固定时间，但结果是调用 BillboardCollection＃update 时的CPU到GPU流量。每个广告牌的流量是无论更新了多少属性，都是一样的。如果集合中的大多数广告牌都需要更新后，使用 BillboardCollection #removeAll 清除集合可能更有效率并添加新的广告牌而不是修改每个广告牌。

Throws:

• DeveloperError :scaleByDistance.far必须大于scaleByDistance.near
• DeveloperError :translucencyByDistance.far必须大于translucencyByDistance.near
• DeveloperError :pixelOffsetScaleByDistance.far必须大于pixelOffsetScaleByDistance.near
• DeveloperError :distanceDisplayCondition.far必须大于distanceDisplayCondition.near

Demo:

• Cesium Sandcastle Billboard Demo

See:

• BillboardCollection
• BillboardCollection#add
• Label

Members

Examples:

// Example 1.
// Have the billboard up vector point north
billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z;

// Example 2.
// Have the billboard point east.
billboard.alignedAxis = Cesium.Cartesian3.UNIT_Z;
billboard.rotation = -Cesium.Math.PI_OVER_TWO;

// Example 3.
// Reset the aligned axis
billboard.alignedAxis = Cesium.Cartesian3.ZERO;

获取或设置与广告牌纹理相乘的颜色。这有两个常见的用例。第一，相同的白色纹理可以被许多不同的广告牌使用，每个广告牌都有不同的颜色来创建彩色广告牌。其次，颜色的alpha分量可用于使广告牌半透明，如下所示。 0.0 的alpha使广告牌透明， 1.0 使广告牌变得不透明。

default

alpha:0.5 < /TD>

红色，绿色，蓝色和alpha值由 value 的 red ， green 表示， blue 和 alpha 属性，如示例1所示。这些组件的范围从 0.0 （无强度）到 1.0 （全强度）。

Examples:

// Example 1. Assign yellow.
b.color = Cesium.Color.YELLOW;

// Example 2. Make a billboard 50{ac3c4da2cd0600a7fb5dd7ece3d30a0eed29da11cf2830143610191d982c65a1} translucent.
b.color = new Cesium.Color(1.0, 1.0, 1.0, 0.5);

Default Value: undefined

获取或设置应用于眼睛坐标中此广告牌的3D笛卡尔偏移。眼睛坐标是左撇子坐标系，其中 x 指向观察者的右侧， y 指向，并且 z 指向屏幕。眼睛坐标使用与世界和模型坐标相同的比例，这通常是米。 眼睛偏移通常用于在同一位置布置多个广告牌或物体，例如在相应的3D模型上方安排一个广告牌。 在下面，广告牌位于地球的中心，但眼睛偏移使它始终无论观者或地球的方向如何，都会出现在地球的顶部。

b.eyeOffset = new Cartesian3（0.0,8000000.0,0.0）;

Default Value: HeightReference.NONE

获取或设置此广告牌的水平原点，以确定广告牌是否为其锚位置的左侧，中间或右侧。

Example:

// Use a bottom, left origin
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;

Example:

// load an image from a URL
b.image = 'some/image/url.png';

// assuming b1 and b2 are billboards in the same billboard collection,
// use the same image for both billboards.
b2.image = b1.image;

从此广告牌的原点获取或设置屏幕空间中的像素偏移量。这是常用的在同一位置对齐多个广告牌和标签，例如图像和文本。该屏幕空间原点是画布的左上角; x 增加从左到右， y 从上到下增加。

默认	b.pixeloffset = new Cartesian2（50,25）;

广告牌的起源用黄点表示。

Examples:

// Example 1.
// Set a billboard's pixel offset scale to 0.0 when the
// camera is 1500 meters from the billboard and scale pixel offset to 10.0 pixels
// in the y direction the camera distance approaches 8.0e6 meters.
b.pixelOffset = new Cesium.Cartesian2(0.0, 1.0);
b.pixelOffsetScaleByDistance = new Cesium.NearFarScalar(1.5e2, 0.0, 8.0e6, 10.0);

// Example 2.
// disable pixel offset by distance
b.pixelOffsetScaleByDistance = undefined;

Default Value: false

获取或设置与广告牌的图像大小相乘的统一比例（以像素为单位）。 1.0 的比例不会改变广告牌的大小;比例大于 1.0 扩大广告牌;小于 1.0 的正尺度缩小广告牌。

在上图中从左到右，比例为 0.5 ， 1.0 ，和 2.0 。

Examples:

// Example 1.
// Set a billboard's scaleByDistance to scale by 1.5 when the
// camera is 1500 meters from the billboard and disappear as
// the camera distance approaches 8.0e6 meters.
b.scaleByDistance = new Cesium.NearFarScalar(1.5e2, 1.5, 8.0e6, 0.0);

// Example 2.
// disable scaling by distance
b.scaleByDistance = undefined;

Default Value: true

Default Value: false

Examples:

// Example 1.
// Set a billboard's translucency to 1.0 when the
// camera is 1500 meters from the billboard and disappear as
// the camera distance approaches 8.0e6 meters.
b.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);

// Example 2.
// disable translucency by distance
b.translucencyByDistance = undefined;

获取或设置此广告牌的垂直原点，确定广告牌是否为到其上方，下方或其锚定位置的中心。

Example:

// Use a bottom, left origin
b.horizontalOrigin = Cesium.HorizontalOrigin.LEFT;
b.verticalOrigin = Cesium.VerticalOrigin.BOTTOM;

Methods

Returns:

Throws:

• DeveloperError :广告牌必须在一个集合中。

Example:

console.log(b.computeScreenSpacePosition(scene).toString());

See:

• Billboard#eyeOffset
• Billboard#pixelOffset

Returns:

Example:

// create a billboard image dynamically
function drawImage(id) {
  // create and draw an image using a canvas
  var canvas = document.createElement('canvas');
  var context2D = canvas.getContext('2d');
  // ... draw image
  return canvas;
}
// drawImage will be called to create the texture
b.setImage('myImage', drawImage);

// subsequent billboards created in the same collection using the same id will use the existing
// texture, without the need to create the canvas or draw the image
b2.setImage('myImage', drawImage);

Throws:

• RuntimeError :带有id的图像必须在地图册中

Type Definitions

Returns: