Cesium API - Label 中文文档

成员变量

Default Value: false

示例：

// 例1
// 在初始化之前设置标签的rightToLeft
Cesium.Label.enableRightToLeftDetection = true;
var myLabelEntity = viewer.entities.add({
  label: {
    id: 'my label',
    text: 'זה טקסט בעברית \n ועכשיו יורדים שורה',
  }
});

// 例2
var myLabelEntity = viewer.entities.add({
  label: {
    id: 'my label',
    text: 'English text'
  }
});
// 在初始化之后设置标签的rightToLeft
Cesium.Label.enableRightToLeftDetection = true;
myLabelEntity.text = 'טקסט חדש';

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

Default Value: new Cartesian2(7, 5)

Default Value: undefined

获取或设置在视点坐标中应用于此标签的3D笛卡尔偏移。 视点坐标是左手坐标系，其中 x 指向查看者的右侧， y 指向上方，并且 z 指向屏幕。视点坐标与世界坐标和模型坐标使用相同的比例，通常是米。



在下方，标签位于地球中心，但视点偏移使它始终无论观看者或地球的方向如何，它都会出现在地球的顶部。

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

Default Value: Cartesian3.ZERO

Default Value: Color.WHITE

参考：

• HTML canvas 2D context fill and stroke styles

Default Value: '30px sans-serif'

参考：

• HTML canvas 2D context text styles

Default Value: HeightReference.NONE

获取或者设置标签的水平原点位置。(左侧，中心或者右侧)

Default Value: HorizontalOrigin.LEFT

示例：

//原点在上面右侧
l.horizontalOrigin = Cesium.HorizontalOrigin.RIGHT;
l.verticalOrigin = Cesium.VerticalOrigin.TOP;

Default Value: Color.BLACK

参考：

• HTML canvas 2D context fill and stroke styles

Default Value: 1.0

参考：

• HTML canvas 2D context fill and stroke styles

获取或设置屏幕空间中距此标签原点的像素偏移量。 屏幕空间原点是画布的左上角； x 从左到右增加， y 从上到下增加。

default

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

标签的原点由黄点表示。

Default Value: Cartesian2.ZERO

示例：

// 例1
// 当相机距离标签1500米时，将标签的像素偏移比例设置为0.0；当相机距离为8.0e6米，在y方向将相机距离设置为10.0像素。
text.pixelOffset = new Cesium.Cartesian2(0.0, 1.0);
text.pixelOffsetScaleByDistance = new Cesium.NearFarScalar(1.5e2, 0.0, 8.0e6, 10.0);

// 例2
// 禁用像素偏移的距离
text.pixelOffsetScaleByDistance = undefined;

获取或设置与标签的缩放系数。

应用大比例尺值可能会使标签像素化。要使文本变大而不产生像素化，请在调用Label#font时使用更大的字体。

From left to right in the above image, the scales are 0.5, 1.0, and 2.0.

Default Value: 1.0

示例：

// 例1
// 当相机距离标签1500米时，将标签的scaleByDistance设置为1.5，当相机距离接近8.0e6米时，将标签的scaleByDistance设置为1.5。
label.scaleByDistance = new Cesium.NearFarScalar(1.5e2, 1.5, 8.0e6, 0.0);

// 例2
// 禁用按距离缩放
label.scaleByDistance = undefined;

Default Value: true

Default Value: false

Default Value: LabelStyle.FILL

Default Value: 1.0

示例：

// 例1
// 当相机距离标签1500米时，将标签的半透明距离设置为1.0，当相机距离接近8.0e6米时，将标签的半透明距离设置为1.0。
text.translucencyByDistance = new Cesium.NearFarScalar(1.5e2, 1.0, 8.0e6, 0.0);

// 例2
// 通过距离禁用半透明
text.translucencyByDistance = undefined;

获取或者设置标签的垂直原点位置。(上面，中心或者下面)

Default Value: VerticalOrigin.BASELINE

示例：

// 原点在上面右侧
l.horizontalOrigin = Cesium.HorizontalOrigin.RIGHT;
l.verticalOrigin = Cesium.VerticalOrigin.TOP;

内置方法

• DeveloperError

示例：

console.log(l.computeScreenSpacePosition(scene).toString());

参考：

• Label#eyeOffset
• Label#pixelOffset