Cesium API - LabelGraphics 中文文档

new Cesium.LabelGraphics(options)

DataSources/LabelGraphics.js 82

文字标注，位置由包含它的Entity指定。

Example labels

Name	Type	Description
options	Object	optional 此对象拥有以下属性： Name Type Default Description show Property true optional 指定显隐性。 text Property optional 指定显示的文本，用“\n”表示换行。 font Property '30px sans-serif' optional 字体 CSS 样式。 style Property LabelStyle.FILL optional 指定 LabelStyle. scale Property 1.0 optional 字体放大比例。 showBackground Property false optional 指定字体背景显隐性。 backgroundColor Property new Color(0.165, 0.165, 0.165, 0.8) optional 背景颜色 Color。 backgroundPadding Property new Cartesian2(7, 5) optional Cartesian2 属性。 指定背景在垂直和水平方向上的内补白。 pixelOffset Property Cartesian2.ZERO optional Cartesian2 属性。 文本在xy方向的像素偏移。 eyeOffset Property Cartesian3.ZERO optional Cartesian3 属性。 视点偏移。 horizontalOrigin Property HorizontalOrigin.CENTER optional 指定水平方向上的原点 HorizontalOrigin。 verticalOrigin Property VerticalOrigin.CENTER optional 垂直方向上的原点 VerticalOrigin。 heightReference Property HeightReference.NONE optional 相对于地形的位置。 fillColor Property Color.WHITE optional 字体颜色 Color. outlineColor Property Color.BLACK optional 边框颜色Color。 outlineWidth Property 1.0 optional 边框宽度。 translucencyByDistance Property optional NearFarScalar 属性， 根据与像机的距离设置透明度。 pixelOffsetScaleByDistance Property optional NearFarScalar 属性，根据与像机的距离设置像素偏移量。 scaleByDistance Property optional NearFarScalar 属性， 根据与摄像机的距离设置缩放比例。 distanceDisplayCondition Property optional 指定在距相机某个距离内显示。 disableDepthTestDistance Property optional 指定禁用深度测试的相机距离。

演示Demo：

• Cesium Sandcastle Labels Demo

成员变量

Default Value: new Color(0.165, 0.165, 0.165, 0.8)

Default Value: new Cartesian2(7, 5)

设置/获取视点偏移Cartesian3(在相机坐标系中)。 相机坐标系是一个左手坐标系。

An eye offset is commonly used to arrange multiple labels or objects at the same position, e.g., to arrange a label above its corresponding 3D model.

下面，标注位于地球的中心，但是视点偏移使它总是出现在地球的顶部，不管观察者或地球的方向。

l.eyeOffset = new Cartesian3(0.0, 8000000.0, 0.0);

Default Value: Cartesian3.ZERO

参考：

• CSS font on MDN

Default Value: HeightReference.NONE

设置/获取文本在xy方向的像素偏移 Cartesian2。 这通常用于对齐多个标签和相同位置的标签，例如，一个图像和文本。屏幕空间原点是画布的左上角。

default

l.pixeloffset = new Cartesian2(25, 75);

标注的原点在黄点处。

Default Value: Cartesian2.ZERO

设置/获取比例(比1大。放大，反之，缩小)。

From left to right in the above image, the scales are 0.5, 1.0, and 2.0.

Default Value: 1.0

Default Value: false

内置方法