本文共 2217 字，大约阅读时间需要 7 分钟。

作者：刘大

本文已同步更新于简书文章

LabelGraphics文本实体对象，主要用于在场景中进行标注，展示地物的文本信息；同BillboardGraphics广告牌一样，不管怎么转动相机位置，文本都是正对你展示的；

先来看看简单的实例吧

viewer.entities.add({    id : 'label',    position:Cesium.Cartesian3.fromDegrees(-110.0, 20.0),    label : {        text : "SuperMap",        font:"32px sans-serif",    }});

参数说明

那LabelGraphics有哪些属性尼，一起来看看吧

可以把整个参数划分为3部分：

第一部分：文本样式相关参数

text：需要展示的文字，支持换行符“\n”；

font:字体样式，和css中的font一样； style:文本填充样式，有3中，FILL ，FILL_AND_OUTLINE和OUTLINE，决定下面fillColor和outlineColor属性设置是否有效； fillColor:填充颜色； outlineColor:文本轮廓颜色；outlineWidth：轮廓宽度； show：是否显示，默认为true showBackground：是否显示背景框，默认为false； backgroundColor：背景框颜色； backgroundPadding：背景框在xy方向的边距，值为Cartesian2类型，类似css的padding，x是left和right，y是top和bottom； scale：缩放比例； horizontalOrigin:指定文本水平方向上的原点，默认为CENTER;

verticalOrigin:指定文本垂直方向上的原点，默认为CENTER; ######注：图中白点为添加label的position位置 可结合horizontalOrigin和verticalOrigin这两个属性使用达到需要的放置位置； pixelOffset：文本在xy方向的像素偏移，值为Cartesian2类型；

第二部分：文本显示相关参数

translucencyByDistance：根据与摄像机的距离设置透明度；

translucencyByDistance : new Cesium.NearFarScalar(1.5e5, 1.0, 1.5e7, 0.0)

pixelOffsetScaleByDistance：根据与摄像机的距离设置像素偏移量；

pixelOffset : new Cesium.Cartesian2(0.0, -20),  pixelOffsetScaleByDistance : new Cesium.NearFarScalar(1.0e3, 1.0, 1.5e6, 0.0)

######注：图中白点为添加label的position位置

scaleByDistance：根据与摄像机的距离设置缩放比例

font : '12px Helvetica',scale : 3.0,scaleByDistance : new Cesium.NearFarScalar(1.0e3, 1.0, 1.5e6, 0.0)

######缩放效果是达到了，但是文字有挤压以及模糊的现象，

######我们可以将font的字体变大，然后scale变小

font : '72px Helvetica',scale : 0.5,scaleByDistance : new Cesium.NearFarScalar(1.0e3, 1.0, 1.5e6, 0.0)

这样就清晰啦

distanceDisplayCondition：根据与摄像机的距离设置标签的显隐 heightReference：高度模式，CLAMP_TO_GROUND(贴地)，NONE(绝对高度)默认高度模式,RELATIVE_TO_GROUND (相对地面) disableDepthTestDistance：指定禁用深度测试的相机高离，直白一点就是禁止文本被任何3D物体可能遮挡的的相机高度，比如设置为20000，那在20000的高度以下，文本都不会受深度的影响，不会被地形或者模型等遮挡

disableDepthTestDistance :6000

在相机高度在6000一下是，文本就不被地形遮挡，从而显示了； 要想文本一直显示，可以设置为Number.POSITIVE_INFINITY无穷大 深度检测主要是文本和3D物体的遮挡问题，那如果label被polygon这些对象遮挡如何解决尼

这就涉及到下面这个eyeoffset属性

eyeoffset：根据观察者viewer(屏幕前的我们)的位置来移动label渲染位置。x为正移动到viewer的右边，y为正向上移动，z为正就移动到屏幕里面(远离我们的方向)。 那上面我们就可以设置

eyeOffset :new Cesium.ConstantProperty(new Cesium.Cartesian3(0, 0, -500))

可以发现，当观测者的Z值距离内的话，label会消失，就好像我们走到了文本的前面；

介绍了这些属性，大家可以根据自己的需求进行相应的参数啦

转载地址：http://xcvxi.baihongyu.com/