Cesium API - BillboardGraphics 中文文档

new Cesium.BillboardGraphics(options)

DataSources/BillboardGraphics.js 85

描述一个包含位置的二维图标，其位置和方向由包含其的Entity确定

Example billboards

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

演示Demo：

• Cesium Sandcastle Billboard Demo

成员变量

Default Value: Cartesian3.ZERO

设置/获取 获取或设置指定与 image. 相乘的 Color 属性。 这有两个常见的用例。首先，许多不同的布告牌都可以使用相同的白色纹理， 每个都有不同的颜色，以创建彩色布告牌。其次，可以为布告牌指定ahpha值如下所示：

default

alpha : 0.5

Default Value: Color.WHITE

设置/获取在视点坐标系下的偏移量。 试点坐标系是左手坐标系。

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像素偏移属性。 该属性指定布告牌在屏幕空间中的像素偏移量从此布告牌的来源开始。 通常用于对齐多个布告牌和标签相同的位置，例如图片和文字。

default

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

布告牌的原点即黄的的点。

Default Value: Cartesian2.ZERO

Default Value: 0

设置/获取应用于图像尺寸的比例。

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

Default Value: 1.0

Default Value: true

Default Value: false

Default Value: VerticalOrigin.CENTER

内置方法