BillboardGraphics

new Cesium.BillboardGraphics ( options )

DataSources/BillboardGraphics.js 53

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

示例广告牌

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

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: