BillboardGraphics

new Cesium.BillboardGraphics(options)

engine/Source/DataSources/BillboardGraphics.js 51

描述位于包含 Entity 位置的二维图标。

广告牌示例

Name	Type	Description
options	BillboardGraphics.ConstructorOptions	optional 描述初始化选项的对象

Demo:

• Cesium Sandcastle Billboard Demo

Members

Default Value: Cartesian3.ZERO

获取或设置指定 Color 乘以 image. 这有两个常见的用例。 首先，相同的白色纹理可能被许多不同的广告牌使用， 每个都有不同的颜色，以创建彩色广告牌。其次，颜色的 alpha 分量可以是 用于使公告牌半透明，如下所示。Alpha 值为 0.0 时，广告牌 透明，1.0 使公告牌不透明。

default

alpha : 0.5

Default Value: Color.WHITE

获取或设置Cartesian3 指定广告牌在眼睛坐标中的偏移量的属性。 眼睛坐标是左手坐标系，其中 x 指向查看者的 向右，Y 指向上方，Z 指向屏幕。

眼动偏移通常用于将多个广告牌或对象排列在同一位置，例如，将 在其相应的 3D 模型上方布置广告牌。

在下面，广告牌位于地球的中心，但眼睛偏移使其始终 显示在地球顶部，无论观看者或地球的方向如何。

b.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);

Default Value: Cartesian3.ZERO

Default Value: HeightReference.NONE

Default Value: HorizontalOrigin.CENTER

获取或设置Cartesian2 指定广告牌在屏幕空间中的像素偏移的属性 来自此广告牌的来源。 这通常用于将多个广告牌和标签对齐 相同的位置，例如，图像和文本。 屏幕空间原点是 canvas; x从左到右增加，y 从上到下增加。

default

b.pixeloffset = new Cartesian2(50, 25);

公告牌的原点由黄点表示。

Default Value: Cartesian2.ZERO

Default Value: 0

获取或设置numeric 指定要应用于图像的统一缩放的属性。 大于 1.0 的比例会放大广告牌，而小于 1.0 的比例会缩小广告牌。

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

Default Value: 1.0

Default Value: true

Default Value: false

Default Value: SplitDirection.NONE

Default Value: VerticalOrigin.CENTER

Methods

Returns:

Type Definitions

Properties:

Name	Type	Attributes	Default	Description
show	Property | boolean	<optional>	true	一个布尔属性，用于指定公告板的可见性。
image	Property | string | HTMLCanvasElement	<optional>		一个 Property，指定要用于公告板的 Image、URI 或 Canvas。
scale	Property | number	<optional>	1.0	一个数字属性，指定要应用于图像大小的比例。
pixelOffset	Property | Cartesian2	<optional>	Cartesian2.ZERO	指定像素偏移量的 Cartesian2 属性。
eyeOffset	Property | Cartesian3	<optional>	Cartesian3.ZERO	指定眼偏移的 Cartesian3 属性。
horizontalOrigin	Property | HorizontalOrigin	<optional>	HorizontalOrigin.CENTER	指定 HorizontalOrigin 的 Property。
verticalOrigin	Property | VerticalOrigin	<optional>	VerticalOrigin.CENTER	指定 VerticalOrigin 的 Property。
heightReference	Property | HeightReference	<optional>	HeightReference.NONE	指定高度相对于什么的 Property。
color	Property | Color	<optional>	Color.WHITE	指定图像的色调 Color 的属性。
rotation	Property | number	<optional>	0	一个数字 Property，用于指定绕 alignedAxis 的旋转。
alignedAxis	Property | Cartesian3	<optional>	Cartesian3.ZERO	一个 Cartesian3 属性，用于指定旋转的单位向量轴。
sizeInMeters	Property | boolean	<optional>		一个布尔属性，指定此公告牌的大小是否应以米为单位。
width	Property | number	<optional>		一个数字属性，用于指定广告牌的宽度(以像素为单位)，覆盖本机大小。
height	Property | number	<optional>		一个数字属性，用于指定广告牌的高度(以像素为单位)，覆盖本机大小。
scaleByDistance	Property | NearFarScalar	<optional>		一个 NearFarScalar 属性，用于根据与摄像机的距离缩放点。
translucencyByDistance	Property | NearFarScalar	<optional>		一个 NearFarScalar 属性，用于根据与摄像机的距离设置半透明。
pixelOffsetScaleByDistance	Property | NearFarScalar	<optional>		一个 NearFarScalar 属性，用于根据与摄像机的距离设置 pixelOffset。
imageSubRegion	Property | BoundingRectangle	<optional>		一个指定 BoundingRectangle 的属性，该属性定义要用于广告牌的图像子区域，而不是整个图像，以从左下角开始的像素为单位。
distanceDisplayCondition	Property | DistanceDisplayCondition	<optional>		一个属性，用于指定此公告牌将在距离摄像机多远处显示。
disableDepthTestDistance	Property | number	<optional>		一个属性，用于指定要禁用深度测试的相机的距离。
splitDirection	Property | SplitDirection	<optional>		指定公告牌的 SplitDirection 的 Property。