描述一条折线。前两个位置定义一条线段,
每个额外的位置定义一条从上一个位置延伸的线段。这些线段
可以是线性连接的点、大圆弧,或贴合地形。
| 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
positions 数组的属性。
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 用于存储结果的对象。 |
Returns:
修改后的 result 参数,如果未提供则返回新实例。
将此对象上每个未赋值的属性设为
所提供源对象上相同属性的值。
| Name | Type | Description |
|---|---|---|
source |
PolylineGraphics | 要合并到此对象中的对象。 |
Type Definitions
PolylineGraphics 构造函数的初始化选项
Properties:
| Name | Type | Attributes | Default | Description |
|---|---|---|---|---|
show |
Property | boolean |
<optional> |
true | 一个布尔属性,指定折线的可见性。 |
positions |
Property | Array.<Cartesian3> |
<optional> |
一个属性,指定定义线串的 Cartesian3 positions 数组。 |
|
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 且地形上的折线受支持时生效。 |
