描述一条折线。前两个位置定义一条线段，每个附加位置定义从前一个位置开始的线段。
这些线段可以是线性连接点、大圆弧或贴合地形。
| Name | Type | Description |
|---|---|---|
options |
PolylineGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
Demo:
See:
Members
arcType : Property|undefined
获取或设置
ArcType 属性，指定线段应为大圆弧、等角航线还是线性连接。
-
Default Value:
ArcType.GEODESIC
clampToGround : Property|undefined
获取或设置布尔属性，指定折线是否应贴合地面。
-
Default Value:
false
classificationType : Property|undefined
获取或设置
ClassificationType 属性，指定此折线在贴地时是否对地形、3D Tiles 或两者进行分类。
-
Default Value:
ClassificationType.BOTH
readonly definitionChanged : Event
获取当属性或子属性更改或修改时引发的事件。
depthFailMaterial : MaterialProperty
获取或设置指定当折线未通过深度测试时用于绘制折线的材质的属性。
需要 EXT_frag_depth WebGL 扩展才能正确渲染。如果不支持该扩展， 可能会出现伪影。
-
Default Value:
undefined
distanceDisplayCondition : Property|undefined
获取或设置
DistanceDisplayCondition 属性，指定从相机多远距离显示此折线。
granularity : Property|undefined
获取或设置数值属性，如果 arcType 不是 ArcType.NONE 且 clampToGround 为 false，则指定每个经纬度之间的角距离。
-
Default Value:
Cesium.Math.RADIANS_PER_DEGREE
获取或设置指定用于绘制折线的材质的属性。
-
Default Value:
Color.WHITE
positions : Property|undefined
获取或设置指定定义线带的
Cartesian3 位置数组的属性。
shadows : Property|undefined
获取或设置枚举属性，指定折线是否从光源投射或接收阴影。
-
Default Value:
ShadowMode.DISABLED
show : Property|undefined
获取或设置指定折线可见性的布尔属性。
-
Default Value:
true
width : Property|undefined
获取或设置指定宽度（像素）的数值属性。
-
Default Value:
1.0
zIndex : ConstantProperty|undefined
获取或设置 zIndex 属性，指定折线的排序顺序。仅在 `clampToGround` 为 true 且支持地形上的折线时有效。
-
Default Value:
0
Methods
clone(result) → PolylineGraphics
复制此实例。
| Name | Type | Description |
|---|---|---|
result |
PolylineGraphics | optional 用于存储结果的object。 |
Returns:
修改后的结果参数，如果未提供则返回新实例。
将此对象上每个未赋值的属性设置为提供的源对象上相同属性的值。
| Name | Type | Description |
|---|---|---|
source |
PolylineGraphics | 要合并到此对象中的对象。 |
Type Definitions
PolylineGraphics 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
show |
Property | boolean |
<optional> |
true | 布尔属性，指定折线的可见性。 |
positions |
Property | Array.<Cartesian3> |
<optional> |
指定定义线带（line strip）的 Cartesian3 位置数组的属性。 |
|
width |
Property | number |
<optional> |
1.0 | 数值属性，指定宽度（像素）。 |
granularity |
Property | number |
<optional> |
Cesium.Math.RADIANS_PER_DEGREE | 数值属性，如果 arcType 不是 ArcType.NONE，则指定每个经纬度之间的角距离。 |
material |
MaterialProperty | Color |
<optional> |
Color.WHITE | 指定用于绘制折线的材质的属性。 |
depthFailMaterial |
MaterialProperty | Color |
<optional> |
指定当折线在地形下方时用于绘制折线的材质的属性。 | |
arcType |
Property | ArcType |
<optional> |
ArcType.GEODESIC | 折线线段必须遵循的线条类型。 |
clampToGround |
Property | boolean |
<optional> |
false | 布尔属性，指定折线是否应贴合地面。 |
shadows |
Property | ShadowMode |
<optional> |
ShadowMode.DISABLED | 枚举属性，指定折线是否从光源投射或接收阴影。 |
distanceDisplayCondition |
Property | DistanceDisplayCondition |
<optional> |
指定从相机多远距离显示此折线的属性。 | |
classificationType |
Property | ClassificationType |
<optional> |
ClassificationType.BOTH | 枚举属性，指定此折线在贴地时是否对地形、3D Tiles 或两者进行分类。 |
zIndex |
Property | number |
<optional> |
0 | 指定用于排序地面几何体的 zIndex 的属性。仅在 `clampToGround` 为 true 且支持地形上的折线时有效。 |