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

广告牌示例

new BillboardGraphics(options)

Parameters:

options (Object)

Name	Description
options.show Property default true	指定公告牌可见性的布尔属性。
options.image Property	指定要用于公告牌的图像、URI或画布的属性。
options.scale Property default 1.0	指定要应用于图像大小的比例的数值属性。
options.pixelOffset Property default Cartesian2.ZERO	指定像素偏移的Cartesian2属性。
options.eyeOffset Property default Cartesian3.ZERO	指定眼偏移的Cartesian3属性。
options.horizontalOrigin Property default HorizontalOrigin.CENTER	指定HorizontalOrigin的属性。
options.verticalOrigin Property default VerticalOrigin.CENTER	指定VerticalOrigin的属性。
options.heightReference Property default HeightReference.NONE	指定高度相对高度的属性。
options.color Property default Color.WHITE	指定图像色调的属性。
options.rotation Property default 0	指定围绕Alignedaxis旋转的数值属性。
options.alignedAxis Property default Cartesian3.ZERO	ACartesian3属性，指定旋转的单位矢量轴。
options.sizeInMeters Property	一个布尔属性，指定是否应以米为单位测量此公告牌的大小。
options.width Property	以像素为单位指定公告牌宽度的数值属性，覆盖本机大小。
options.height Property	以像素为单位指定公告牌高度的数值属性，覆盖本机大小。
options.scaleByDistance Property	ANearFarScalar属性，用于根据与相机的距离缩放点。
options.translucencyByDistance Property	一个NearFarScalar属性，用于根据与相机的距离设置半透明。
options.pixelOffsetScaleByDistance Property	一个NearFarScalar属性，用于根据与相机的距离设置PixeLoffset。
options.imageSubRegion Property	指定BoundingRectangle的属性，该属性定义用于公告牌的图像的子区域，而不是整个图像，从左下角开始以像素度量。
options.distanceDisplayCondition Property	一个属性，指定此公告牌将显示在与相机的距离。
options.disableDepthTestDistance Property	一个属性，指定从要禁用深度测试的相机到的距离。

Members

alignedAxis : Property

Default Value: Cartesian3.ZERO

color : Property

获取或设置指定与image相乘的Color的属性。这有两个常见的用例。首先，许多不同的广告牌可以使用相同的白色纹理，每个颜色都不同，以创建彩色广告牌。其次，颜色的alpha组件可以用来使广告牌半透明，如下所示。字母0.0使广告牌透明，字母1.0使广告牌不透明。

default

alpha : 0.5

Default Value: Color.WHITE

(readonly) definitionChanged : Event

disableDepthTestDistance : Property

distanceDisplayCondition : Property

eyeOffset : Property

获取或设置Cartesian3属性，该属性指定公告牌在眼睛坐标中的偏移量。眼睛坐标是一个左手坐标系，其中x指向观看者的右侧，y指向上方，z指向屏幕。

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

下面，广告牌位于地球的中心，但是眼睛的偏移使它总是出现在地球的顶部，而不管观众或地球的方向如何。

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

Default Value: Cartesian3.ZERO

height : Property

heightReference : Property

Default Value: HeightReference.NONE

horizontalOrigin : Property

Default Value: HorizontalOrigin.CENTER

image : Property

imageSubRegion : Property

pixelOffset : Property

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

default

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

广告牌的原点用黄色点表示。

Default Value: Cartesian2.ZERO

pixelOffsetScaleByDistance : Property

rotation : Property

Default Value: 0

scale : Property

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

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

Default Value: 1.0

scaleByDistance : Property

show : Property

Default Value: true

sizeInMeters : Property

Default Value: false

translucencyByDistance : Property

verticalOrigin : Property

Default Value: VerticalOrigin.CENTER

width : Property

Methods

Parameters:

Parameters: