BillboardGraphics

BillboardGraphics 类定义用于绘制在 3D 场景中的点数据，它是 Entity 的一个属性。通过这个类，您可以定义点的大小、颜色、符号以及标签等等属性。

属性

以下是 BillboardGraphics 类的属性列表：

image {String}

描述：点的图像 URL。设置该属性后，图像将替代 BillboardGraphics 类的 color 属性。

默认值：无

show {Boolean}

描述：一个布尔值，表示点是否应该被显示。

默认值：true

scale {Number}

描述：点的大小，指定为缩放比例

默认值：1.0

horizontalOrigin {HorizontalOrigin}

描述：点在水平方向上的基准位置。可选值包括：

• HorizontalOrigin.LEFT
• HorizontalOrigin.CENTER
• HorizontalOrigin.RIGHT

默认值：HorizontalOrigin.CENTER

verticalOrigin {VerticalOrigin}

描述：点在垂直方向上的基准位置。可选值包括：

• VerticalOrigin.BOTTOM
• VerticalOrigin.CENTER
• VerticalOrigin.TOP

默认值：VerticalOrigin.CENTER

color {Color}

描述：点的颜色。如果要使用图像而不是单色，请设置 image 属性。

默认值：Color.WHITE

rotation {Number}

描述：以弧度表示的点的旋转角度。

默认值：0.0

alignedAxis {Cartesian3}

描述：点对齐的轴。如果设置了 alignedAxis，BillboardGraphics 类的 rotation 属性将与此设置不一致。

默认值：(0, 0, 0)

width {Number}

描述：以像素为单位的点的宽度。

默认值：undefined

height {Number}

描述：以像素为单位的点的高度。

默认值：undefined

pixelOffset {Cartesian2}

描述：以像素为单位指定的点的偏移。

默认值：(0, 0)

eyeOffset {Cartesian3}

描述：以米为单位指定的点的偏移，变化时与相机位置有关。

默认值：(0, 0, 0)

offsetDirection {Cartesian3}

描述：指定点 eyeOffset 中的向量方向，以相对于视域的 direction 和 up 进行设置。

默认值：(0, 0, 0)

scaleByDistance {NearFarScalar}

描述：按距离缩放的点大小。如果需要在距离远近变化时自动调整点的大小，请使用此属性。

默认值：undefined

translucencyByDistance {NearFarScalar}

描述：按照距离设定的点的半透明度。

默认值：undefined

distanceDisplayCondition {DistanceDisplayCondition}

描述：距离设定，指定在那个距离范围内哪些点应该被显示，哪些不需要被显示。请参阅 DistanceDisplayCondition。

默认值：undefined

disableDepthTestDistance {Number}

描述：相机距离超过此距离时，禁用深度测试。

默认值：0.0

示例

下面的代码展示了如何使用 BillboardGraphics 绘制点。

var viewer = new Cesium.Viewer('cesiumContainer');
var entity = viewer.entities.add({
    name: '点',
    position: Cesium.Cartesian3.fromDegrees(-75.5847, 40.0397),
    point: {
        pixelSize: 10,
        color: Cesium.Color.YELLOW,
        outlineWidth: 2,
        outlineColor: Cesium.Color.BLACK
    }
});