| Name | Type | Description |
|---|---|---|
options |
LabelGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
Members
backgroundColor : Property|undefined
获取或设置属性,指定背景
Color。
-
Default Value:
new Color(0.165, 0.165, 0.165, 0.8)
backgroundPadding : Property|undefined
获取或设置
Cartesian2 属性,指定标签的水平和垂直背景填充(以像素为单位)。
-
Default Value:
new Cartesian2(7, 5)
readonly definitionChanged : Event
获取在属性或子属性更改或修改时引发的事件。
disableDepthTestDistance : Property|undefined
获取或设置距离相机的距离,在此距离禁用深度测试。
设置为零时,始终应用深度测试;设置为 Number.POSITIVE_INFINITY 时,深度测试将永远不应用。
distanceDisplayCondition : Property|undefined
获取或设置
DistanceDisplayCondition 属性,指定在距离相机的多远时显示该标签。
eyeOffset : Property|undefined
-
Default Value:
Cartesian3.ZERO
fillColor : Property|undefined
获取或设置属性,指定填充
Color。
font : Property|undefined
获取或设置字符串属性,指定 CSS 语法的字体。
See:
heightReference : Property|undefined
获取或设置属性,指定
HeightReference。
-
Default Value:
HeightReference.NONE
horizontalOrigin : Property|undefined
获取或设置属性,指定
HorizontalOrigin。
outlineColor : Property|undefined
获取或设置属性,指定轮廓
Color。
outlineWidth : Property|undefined
获取或设置数值属性,指定轮廓宽度。
pixelOffset : Property|undefined
获取或设置
Cartesian2 属性,指定该标签在屏幕空间中从原点的像素偏移。
这通常用于将多个标签和其他对象排列在同一位置,例如图像和文本。
-
Default Value:
Cartesian2.ZERO
pixelOffsetScaleByDistance : Property|undefined
获取或设置
NearFarScalar 属性,基于相机距离设置标签的像素偏移。
标签的像素偏移将在 NearFarScalar#nearValue 和 NearFarScalar#farValue 之间插值,
当相机距离在指定的 NearFarScalar#near 和 NearFarScalar#far 的范围内。
超出这些范围,标签的像素偏移将保持在最近的边界。
scale : Property|undefined
获取或设置数值属性,指定应用于图像的均匀缩放。
大于

上图中的缩放值从左到右分别为
1.0 的缩放会放大标签,而小于 1.0 的缩放会缩小它。

上图中的缩放值从左到右分别为
0.5、1.0 和 2.0。
-
Default Value:
1.0
scaleByDistance : Property|undefined
获取或设置
NearFarScalar 属性,基于相机距离设置标签的缩放。
标签的缩放将在 NearFarScalar#nearValue 和 NearFarScalar#farValue 之间插值,
当相机距离在指定的 NearFarScalar#near 和 NearFarScalar#far 的范围内。
超出这些范围,标签的缩放将保持在最近的边界。如果未定义,
scaleByDistance 将被禁用。
show : Property|undefined
获取或设置布尔属性,指定标签的可见性。
showBackground : Property|undefined
获取或设置布尔属性,指定标签后背景的可见性。
-
Default Value:
false
style : Property|undefined
获取或设置属性,指定
LabelStyle。
text : Property|undefined
获取或设置字符串属性,指定标签的文本。
显式换行符 '\n' 受到支持。
translucencyByDistance : Property|undefined
获取或设置
NearFarScalar 属性,基于距离相机设置标签的半透明度。
标签的半透明度将在 NearFarScalar#nearValue 和 NearFarScalar#farValue 之间插值,
当相机距离在指定的 NearFarScalar#near 和 NearFarScalar#far 的范围内。
超出这些范围,标签的半透明度将保持在最近的边界。
verticalOrigin : Property|undefined
获取或设置属性,指定
VerticalOrigin。
Methods
clone(result) → LabelGraphics
复制此实例。
| Name | Type | Description |
|---|---|---|
result |
LabelGraphics | optional 存储结果的对象。 |
Returns:
修改后的结果参数,如果未提供则返回一个新实例。
将此对象上每个未分配的属性赋值为提供的源对象上同名属性的值。
| Name | Type | Description |
|---|---|---|
source |
LabelGraphics | 要合并到此对象中的对象。 |
Type Definitions
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> |
一个属性,指定距离相机的距离,在此处禁用深度测试。 |

