LabelGraphics

new Cesium.LabelGraphics(options)

描述一个位于包含 Entity 位置的二维标签。


示例标签

Name Type Description
options LabelGraphics.ConstructorOptions optional 描述初始化选项的对象
Demo:

Members

获取或设置属性,指定背景 Color
Default Value: new Color(0.165, 0.165, 0.165, 0.8)
获取或设置 Cartesian2 属性,指定标签的水平和垂直背景填充(以像素为单位)。
Default Value: new Cartesian2(7, 5)
获取在属性或子属性更改或修改时引发的事件。

disableDepthTestDistance : Property|undefined

获取或设置距离相机的距离,在此距离禁用深度测试。 设置为零时,始终应用深度测试;设置为 Number.POSITIVE_INFINITY 时,深度测试将永远不应用。

distanceDisplayCondition : Property|undefined

获取或设置 DistanceDisplayCondition 属性,指定在距离相机的多远时显示该标签。
获取或设置 Cartesian3 属性,指定标签的眼坐标偏移。 眼坐标系是一个左手坐标系统,其中 x 指向观察者的右侧,y 指向上方, z 指向屏幕内侧。
Default Value: Cartesian3.ZERO
获取或设置属性,指定填充 Color
获取或设置字符串属性,指定 CSS 语法的字体。
See:
获取或设置属性,指定 HeightReference
Default Value: HeightReference.NONE
获取或设置属性,指定 HorizontalOrigin
获取或设置属性,指定轮廓 Color
获取或设置数值属性,指定轮廓宽度。
获取或设置 Cartesian2 属性,指定该标签在屏幕空间中从原点的像素偏移。 这通常用于将多个标签和其他对象排列在同一位置,例如图像和文本。
Default Value: Cartesian2.ZERO

pixelOffsetScaleByDistance : Property|undefined

获取或设置 NearFarScalar 属性,基于相机距离设置标签的像素偏移。 标签的像素偏移将在 NearFarScalar#nearValueNearFarScalar#farValue 之间插值, 当相机距离在指定的 NearFarScalar#nearNearFarScalar#far 的范围内。 超出这些范围,标签的像素偏移将保持在最近的边界。
获取或设置数值属性,指定应用于图像的均匀缩放。 大于 1.0 的缩放会放大标签,而小于 1.0 的缩放会缩小它。


上图中的缩放值从左到右分别为 0.51.02.0

Default Value: 1.0
获取或设置 NearFarScalar 属性,基于相机距离设置标签的缩放。 标签的缩放将在 NearFarScalar#nearValueNearFarScalar#farValue 之间插值, 当相机距离在指定的 NearFarScalar#nearNearFarScalar#far 的范围内。 超出这些范围,标签的缩放将保持在最近的边界。如果未定义, scaleByDistance 将被禁用。
获取或设置布尔属性,指定标签的可见性。
获取或设置布尔属性,指定标签后背景的可见性。
Default Value: false
获取或设置属性,指定 LabelStyle
获取或设置字符串属性,指定标签的文本。 显式换行符 '\n' 受到支持。

translucencyByDistance : Property|undefined

获取或设置 NearFarScalar 属性,基于距离相机设置标签的半透明度。 标签的半透明度将在 NearFarScalar#nearValueNearFarScalar#farValue 之间插值, 当相机距离在指定的 NearFarScalar#nearNearFarScalar#far 的范围内。 超出这些范围,标签的半透明度将保持在最近的边界。
获取或设置属性,指定 VerticalOrigin

Methods

复制此实例。
Name Type Description
result LabelGraphics optional 存储结果的对象。
Returns:
修改后的结果参数,如果未提供则返回一个新实例。
将此对象上每个未分配的属性赋值为提供的源对象上同名属性的值。
Name Type Description
source LabelGraphics 要合并到此对象中的对象。

Type Definitions

Cesium.LabelGraphics.ConstructorOptions

LabelGraphics 构造函数的初始化选项
Properties:
Name Type Attributes Default Description
show Property | boolean <optional>
true 一个布尔属性,指定标签的可见性。
text Property | string <optional>
一个属性,指定文本。支持显式换行符 '\n'。
font Property | string <optional>
'30px sans-serif' 一个属性,指定 CSS 字体。
style Property | LabelStyle <optional>
LabelStyle.FILL 一个属性,指定 LabelStyle
scale Property | number <optional>
1.0 一个数值属性,指定应用于文本的缩放比例。
showBackground Property | boolean <optional>
false 一个布尔属性,指定标签后背景的可见性。
backgroundColor Property | Color <optional>
new Color(0.165, 0.165, 0.165, 0.8) 一个属性,指定背景 Color
backgroundPadding Property | Cartesian2 <optional>
new Cartesian2(7, 5) 一个 Cartesian2 属性,指定背景的水平和垂直填充(以像素为单位)。
pixelOffset Property | Cartesian2 <optional>
Cartesian2.ZERO 一个 Cartesian2 属性,指定像素偏移。
eyeOffset Property | Cartesian3 <optional>
Cartesian3.ZERO 一个 Cartesian3 属性,指定眼偏移。
horizontalOrigin Property | HorizontalOrigin <optional>
HorizontalOrigin.CENTER 一个属性,指定 HorizontalOrigin
verticalOrigin Property | VerticalOrigin <optional>
VerticalOrigin.CENTER 一个属性,指定 VerticalOrigin
heightReference Property | HeightReference <optional>
HeightReference.NONE 一个属性,指定高度的相对参考。
fillColor Property | Color <optional>
Color.WHITE 一个属性,指定填充 Color
outlineColor Property | Color <optional>
Color.BLACK 一个属性,指定轮廓 Color
outlineWidth Property | number <optional>
1.0 一个数值属性,指定轮廓宽度。
translucencyByDistance Property | NearFarScalar <optional>
一个 NearFarScalar 属性,用于根据距离相机设置半透明度。
pixelOffsetScaleByDistance Property | NearFarScalar <optional>
一个 NearFarScalar 属性,用于根据距离相机设置像素偏移。
scaleByDistance Property | NearFarScalar <optional>
一个 NearFarScalar 属性,用于根据距离相机设置缩放。
distanceDisplayCondition Property | DistanceDisplayCondition <optional>
一个属性,指定在距离相机的多远时显示该标签。
disableDepthTestDistance Property | number <optional>
一个属性,指定距离相机的距离,在此处禁用深度测试。
需要帮助?获得答案的最快方法是来自社区和团队 Cesium Forum.