BillboardGraphics

new Cesium.BillboardGraphics ( options )

DataSources/BillboardGraphics.js 50

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

示例广告牌

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

Demo:

• Cesium Sandcastle Billboard Demo

Members

Default Value: Cartesian3.ZERO

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

默认	alpha:0.5 < /td>

Default Value: Color.WHITE

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

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

在下方，广告牌位于地球的中心，但眼球偏移使其始终处于无论观看者或地球的方向如何，它都会出现在地球的顶部。

b.eyeOffset =新的Cartesian3（0.0，8000000.0，0.0）;

Default Value: Cartesian3.ZERO

Default Value: HeightReference.NONE

Default Value: HorizontalOrigin.CENTER

获取或设置 Cartesian2 属性，该属性指定广告牌在屏幕空间中的像素偏移量从此广告牌的来源开始。通常用于对齐多个广告牌和标签相同的位置，例如图片和文字。屏幕空间原点是屏幕顶部的左上角帆布; x 从左到右增加， y 从上到下增加。

默认	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: 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	一个属性，指定 Horizo​​ntalOrigin 。
verticalOrigin	Property | VerticalOrigin	<optional>	VerticalOrigin.CENTER	一个属性，指定 VerticalOrigin 。
heightReference	Property | HeightReference	<optional>	HeightReference.NONE	一个属性，指定相对于高度的高度。
color	Property | Color	<optional>	Color.WHITE	一个属性，它指定图像的色调 颜色 。
rotation	Property | number	<optional>	0	一个数字属性，用于指定关于alignedAxis的旋转。
alignedAxis	Property | Cartesian3	<optional>	Cartesian3.ZERO	A Cartesian3 属性，用于指定单位矢量旋转轴。
sizeInMeters	Property | boolean	<optional>		一个布尔型属性，指定是否应以米为单位测量此广告牌的大小。
width	Property | number	<optional>		一个数字属性，用于指定广告牌的宽度（以像素为单位），并覆盖原始尺寸。
height	Property | number	<optional>		一个数字属性，用于指定广告牌的高度（以像素为单位），并覆盖原始尺寸。
scaleByDistance	Property | NearFarScalar	<optional>		A NearFarScalar 该属性用于根据距相机的距离缩放点。
translucencyByDistance	Property | NearFarScalar	<optional>		NearFarScalar 该属性用于根据距相机的距离设置半透明性。
pixelOffsetScaleByDistance	Property | NearFarScalar	<optional>		A NearFarScalar 该属性用于根据距相机的距离来设置pixelOffset。
imageSubRegion	Property | BoundingRectangle	<optional>		一个属性，它指定 BoundingRectangle ，该属性定义了要用于广告牌的图像的子区域，而不是整个图像，而是从左下角开始以像素为单位。
distanceDisplayCondition	Property | DistanceDisplayCondition	<optional>		一个属性，它指定将在距摄像机的距离上显示此广告牌。
disableDepthTestDistance	Property | number	<optional>		一个属性，它指定要禁用深度测试的距离相机的距离。