BillboardGraphics

new Cesium.BillboardGraphics(options)

DataSources/BillboardGraphics.js 50

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

Example billboards

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

Demo:

• Cesium Sandcastle Billboard Demo

Members

Default Value: Cartesian3.ZERO

获取或设置指定Color乘以image的属性。 这有两个常见的用例。首先，相同的白色纹理可能会被许多不同的广告牌使用， 每个不同的颜色，以创建彩色广告牌。其次，颜色的alpha分量可以是 用于使广告牌半透明，如下图所示。一个字母0.0构成广告牌 透明，1.0使广告牌不透明。

default

alpha : 0.5

Default Value: Color.WHITE

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

An eye offset is commonly used to arrange multiple billboards or objects at the same position, e.g., to arrange a billboard above its corresponding 3D model.

下面，广告牌被定位在地球的中心，但眼睛的偏移使它总是 无论观测者或地球的方位如何，都会出现在地球的顶部。

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

Default Value: Cartesian3.ZERO

Default Value: HeightReference.NONE

Default Value: HorizontalOrigin.CENTER

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

default

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

The billboard's origin is indicated by the yellow point.

Default Value: Cartesian2.ZERO

Default Value: 0

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

From left to right in the above image, the scales are 0.5, 1.0, and 2.0.

Default Value: 1.0

Default Value: true

Default Value: false

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旋转的数值属性。
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>		指定从相机到禁用深度测试的距离的属性。