SuperMap iClient3D for WebGL教程（Entity）-LabelGraphics

作者：刘大

本文已同步更新于简书文章 https://www.jianshu.com/p/4b1a196d11cf

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会消失，就好像我们走到了文本的前面；
介绍了这些属性，大家可以根据自己的需求进行相应的参数啦