new Cesium.BillboardGraphics ( options )

DataSources/BillboardGraphics.js 53

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

示例广告牌

Name	Type	Description
options	Object	optional Object with the following properties: Name Type Default Description image Property 可选 指定要用于广告牌的图像，URI或画布的属性。 show Property true 可选 一个布尔属性，指定广告牌的可见性。 scale Property 1.0 可选 一个数字属性，指定要应用于图像大小的比例。 horizontalOrigin Property HorizontalOrigin.CENTER 可选 指定 Horizo​​ntalOrigin 的属性。 verticalOrigin Property VerticalOrigin.CENTER 可选 指定 VerticalOrigin 的属性。 eyeOffset Property Cartesian3.ZERO 可选 指定眼睛偏移的 Cartesian3 属性。 pixelOffset Property Cartesian2.ZERO 可选 指定像素偏移量的 Cartesian2 属性。 rotation Property 0 可选 一个数字属性，指定有关alignedAxis的旋转。 alignedAxis Property Cartesian3.ZERO 可选 Cartesian3 属性，指定单位矢量旋转轴。 width Property 可选 一个数字属性，指定广告牌的宽度（以像素为单位），覆盖原始大小。 height Property 可选 一个数字属性，指定广告牌的高度（以像素为单位），覆盖原生大小。 color Property Color.WHITE 可选 指定图像的色调 Color 的属性。 scaleByDistance Property 可选 NearFarScalar 属性，用于根据与相机的距离缩放点。 translucencyByDistance Property 可选 NearFarScalar 属性，用于根据与相机的距离设置半透明度。 pixelOffsetScaleByDistance Property 可选 NearFarScalar 属性，用于根据与摄像机的距离设置pixelOffset。 imageSubRegion Property 可选 指定 BoundingRectangle 的属性，用于定义用于广告牌的图像的子区域，而不是整个图像（以像素为单位）从左下角开始。 sizeInMeters Property 可选 一个布尔属性，指定此广告牌的大小是否应以米为单位。 heightReference Property HeightReference.NONE 可选 指定高度相对于的内容的属性。 distanceDisplayCondition Property 可选 一个属性，指定与该摄像机的距离，该广告牌将显示的距离。 disableDepthTestDistance Property 可选 一个属性，指定从相机到禁用深度测试的距离。

Demo:

• Cesium Sandcastle Billboard Demo

Members

Default Value: Cartesian3.ZERO

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

default

alpha:0.5 < /TD>

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 属性，指定屏幕空间中广告牌的像素偏移量从这个广告牌的起源。这通常用于对齐多个广告牌和标签相同的位置，例如图像和文本。屏幕空间原点是顶部的左上角帆布; 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: