LabelGraphics

LabelGraphics 是 CesiumJS 中的一种图形，用于在地球上的点、线或面上显示标签。 它可以控制标签的文本、位置、样式和大小。

创建 LabelGraphics

示例

var entity = viewer.entities.add({
    position: Cesium.Cartesian3.fromDegrees(longitude, latitude),
    label: {
        text: 'My Label',
        font: 'bold 16px sans-serif',
        pixelOffset: new Cesium.Cartesian2(0, -20),
        fillColor: Cesium.Color.WHITE,
        outlineColor: Cesium.Color.BLACK,
        outlineWidth: 4,
        style: Cesium.LabelStyle.FILL_AND_OUTLINE
    }
});

属性

• text：字符串类型，标签的文本内容。
• font：字符串类型，标签的字体样式，默认为 '10px sans-serif'。
• style：枚举类型，标签文本的样式。可选值为 Cesium.LabelStyle.FILL、Cesium.LabelStyle.OUTLINE 和 Cesium.LabelStyle.FILL_AND_OUTLINE，默认为 Cesium.LabelStyle.FILL。
• pixelOffset：Cesium.Cartesian2 类型，标签文本的像素偏移量。默认为 (0,0)。
• fillColor：Cesium.Color 类型，标签文本的填充颜色。默认为 Cesium.Color.WHITE。
• outlineColor：Cesium.Color 类型，标签文本的边框颜色。默认为 Cesium.Color.BLACK。
• outlineWidth：数字类型，标签文本的边框宽度。默认为 1。
• showBackground：布尔类型，默认为 false。当为 true 时，显示标签文字周围的背景矩形。
• backgroundColor：Cesium.Color 类型，默认为 Cesium.Color.TRANSPARENT。当 showBackground 为 true 时，设置背景矩形的颜色。
• backgroundPadding：Cesium.Cartesian2 类型，默认为 (0,0)。当 showBackground 为 true 时，设置标签文本到背景矩形边缘的间隙。

附加 LabelGraphics

将 LabelGraphics 作为 Entity 的属性，可以将其添加到场景中。

示例

var entity = viewer.entities.add({
    position: Cesium.Cartesian3.fromDegrees(longitude, latitude),
    label: {
        text: 'My Label',
        font: 'bold 16px sans-serif',
        pixelOffset: new Cesium.Cartesian2(0, -20),
        fillColor: Cesium.Color.WHITE,
        outlineColor: Cesium.Color.BLACK,
        outlineWidth: 4,
        style: Cesium.LabelStyle.FILL_AND_OUTLINE
    }
});

编辑 LabelGraphics

可以使用 Entity 的属性，动态编辑 LabelGraphics。

示例

entity.label.text = 'New Text';
entity.label.font = 'italic 18px sans-serif';
entity.label.pixelOffset = new Cesium.Cartesian2(0, -30);
entity.label.fillColor = Cesium.Color.RED;
entity.label.outlineColor = Cesium.Color.BLUE;
entity.label.outlineWidth = 2;
entity.label.style = Cesium.LabelStyle.OUTLINE;