描述多段线。前两个位置定义一条线段
,每个额外的位置定义从前一个位置开始的线段。细分
可以是线性连接点、大圆弧或固定到地形。
Name | Type | Description |
---|---|---|
options |
PolylineGraphics.ConstructorOptions | optional 描述初始化选项的对象 |
Demo:
See:
Members
arcType : Property|undefined
获取或设置
ArcType
指定线段应为大圆弧、恒向线还是线性连接的属性。
-
Default Value:
ArcType.GEODESIC
clampToGround : Property|undefined
获取或设置boolean 属性,指定多段线是否
应夹在地面上。
-
Default Value:
false
classificationType : Property|undefined
获取或设置
ClassificationType
指定此多段线在地面上时是分类地形、3D 瓦片还是两者的属性。
-
Default Value:
ClassificationType.BOTH
readonly definitionChanged : Event
获取在更改或修改属性或子属性时引发的事件。
depthFailMaterial : MaterialProperty
获取或设置指定在深度测试失败时用于绘制多段线的材料的属性。
需要 EXT_frag_depth WebGL 扩展才能正确呈现。如果该扩展不受支持,则 可能存在伪影。
-
Default Value:
undefined
distanceDisplayCondition : Property|undefined
获取或设置
DistanceDisplayCondition
指定此多段线将在距相机多远处显示的属性。
granularity : Property|undefined
获取或设置numeric 属性,如果 arcType 不是 ArcType.NONE 且 clampToGround 为 false,则指定每个纬度和经度之间的角度距离。
-
Default Value:
Cesium.Math.RADIANS_PER_DEGREE
获取或设置指定用于绘制多段线的材料的属性。
-
Default Value:
Color.WHITE
positions : Property|undefined
获取或设置指定
Cartesian3
数组的属性
定义线带的位置。
shadows : Property|undefined
获取或设置 enum 属性,指定 polyline 是否
从光源投射或接收阴影。
-
Default Value:
ShadowMode.DISABLED
show : Property|undefined
获取或设置boolean 指定多段线可见性的属性。
-
Default Value:
true
width : Property|undefined
获取或设置numeric 属性,用于指定宽度(以像素为单位)。
-
Default Value:
1.0
zIndex : ConstantProperty|undefined
获取或设置zIndex 属性指定折线的顺序。仅当 'clampToGround' 为 true 并且支持地形上的折线时才有效。
-
Default Value:
0
Methods
clone(result) → PolylineGraphics
复制实例。
Name | Type | Description |
---|---|---|
result |
PolylineGraphics | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或者一个新实例(如果未提供)。
将此对象上每个未分配的属性分配给值
的 API 值。
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 位置数组。 |
|
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 | 一个布尔属性,指定是否应将 Polyline 固定在地面上。 |
shadows |
Property | ShadowMode |
<optional> |
ShadowMode.DISABLED | 一个枚举属性,指定多段线是投射还是接收来自光源的阴影。 |
distanceDisplayCondition |
Property | DistanceDisplayCondition |
<optional> |
一个属性,指定此多段线将在距摄像机多远处显示。 | |
classificationType |
Property | ClassificationType |
<optional> |
ClassificationType.BOTH | 一个枚举属性,指定此多段线在地面上时是对地形、3D 瓦片进行分类,还是对两者进行分类。 |
zIndex |
Property | number |
<optional> |
0 | 指定用于对地面几何图形进行排序的 zIndex 的属性。仅当 'clampToGround' 为 true 并且支持地形上的折线时才有效。 |