LabelGraphics

new Cesium.LabelGraphics ( options )

DataSources/LabelGraphics.js 51

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

示例标签

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

Demo:

• Cesium Sandcastle Labels Demo

Members

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

Default Value: new Cartesian2(7, 5)

获取或设置 Cartesian3 属性，指定标签在眼睛坐标中的偏移量。眼睛坐标是左手坐标系，其中 x 指向观看者的右侧， y 指向上方， z 指向屏幕内。

眼睛偏移通常用于将多个标签或对象排列在同一位置，例如，将标签排列在其对应的 3D 模型上方。

在下方，标签位于地球的中心，但眼球偏移使其始终显示在地球顶部，无论观察者或地球的方向如何。

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

Default Value: Cartesian3.ZERO

See:

• CSS font on MDN

Default Value: HeightReference.NONE

获取或设置 Cartesian2 属性，指定标签在屏幕空间中相对于该标签原点的像素偏移量。这通常用于在同一位置对齐多个标签和标签，例如图像和文本。屏幕空间原点是画布的左上角； x 从左到右增加， y 从上到下增加。

default

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

标签的来源由黄点指示。

Default Value: Cartesian2.ZERO

获取或设置数字属性，指定要应用于图像的统一比例。大于 1.0 的比例会放大标签，而小于 1.0 的比例会缩小标签。

上图中从左到右，比例分别为 0.5 、 1.0 和 2.0 。

Default Value: 1.0

Default Value: false

Methods

Returns:

Type Definitions

Properties:

Name	Type	Attributes	Default	Description
show	Property | boolean	<optional>	true	一个布尔属性，指定标签的可见性。
text	Property | string	<optional>		指定文本的属性。支持显式换行符 ''。
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 属性，用于根据与相机的距离设置 pixelOffset。
scaleByDistance	Property | NearFarScalar	<optional>		NearFarScalar 属性用于根据与相机的距离设置比例。
distanceDisplayCondition	Property | DistanceDisplayCondition	<optional>		一个属性，指定将在距相机多远的距离处显示此标签。
disableDepthTestDistance	Property | number	<optional>		一个属性，指定从相机到禁用深度测试的距离。