BillboardGraphics

new Cesium.BillboardGraphics(options)

engine/Source/DataSources/BillboardGraphics.js 53

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

示例广告牌

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

Demo:

• Cesium Sandcastle Billboard 演示

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 指向屏幕内。

眼睛偏移通常用于将多个广告牌或对象安排在相同的位置，例如将广告牌放置在其对应三维模型的上方。

下方的广告牌被放置在地球中心，但眼睛偏移使其始终出现在地球顶部，而不管观察者或地球的方向如何。

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

Default Value: Cartesian3.ZERO

Default Value: HeightReference.NONE

Default Value: HorizontalOrigin.CENTER

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

default

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

广告牌的原点由黄色点指示。

Default Value: Cartesian2.ZERO

Default Value: 0

获取或设置指定应用于图像的均匀缩放的数值属性。 大于 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>		一个属性，指定用于广告牌的图像、URI 或画布。
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。
verticalOrigin	Property | VerticalOrigin	<optional>	VerticalOrigin.CENTER	一个属性，指定 VerticalOrigin。
heightReference	Property | HeightReference	<optional>	HeightReference.NONE	一个属性，指定高度相对的参考。
color	Property | Color	<optional>	Color.WHITE	一个属性，指定图像的色调 Color。
rotation	Property | number	<optional>	0	一个数字属性，指定围绕对齐轴的旋转角度。
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 属性，用于根据与相机的距离设置像素偏移。
imageSubRegion	Property | BoundingRectangle	<optional>		一个属性，指定一个 BoundingRectangle，定义用于广告牌的图像的子区域，而不是整个图像，测量从左下角的像素值。
distanceDisplayCondition	Property | DistanceDisplayCondition	<optional>		一个属性，指定从相机到此广告牌将显示的距离的条件。
disableDepthTestDistance	Property | number	<optional>		一个属性，指定从相机起禁用深度测试的距离。
splitDirection	Property | SplitDirection	<optional>		一个属性，指定广告牌的 SplitDirection。