Cesium API - GroundPolylineGeometry 中文文档

本文介绍下Cesium中 GroundPolylineGeometry API的详细使用说明。

GroundPolylineGeometry API 调用方法

new Cesium.GroundPolylineGeometry(options)

Core/GroundPolylineGeometry.js 75

对地形或3D Tiles上折线的描述。只能与GroundPolylinePrimitive一起使用。

Name Type Description

options

Object

具有以下属性：

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		定义折线点的`Cartesian3`数组。椭球上的高度将被忽略。
`width`	Number	`1.0`	optional 屏幕空间宽度（以像素为单位）。
`granularity`	Number	`9999.0`	optional 距离间隔（以米为单位），用于插值options.points.。默认为9999.0米。0表示没有插值。
`loop`	Boolean	`false`	optional 在几何图形创建过程中，是否在最后一行和第一行线位置之间添加线段以使该折线成为循环。
`arcType`	ArcType	`ArcType.GEODESIC`	optional 折线段必须遵循的线的类型。有效的选项是`ArcType.GEODESIC`和`ArcType.RHUMB`。

异常情况：

DeveloperError : 至少需要两个位置。

示例：

var positions = Cesium.Cartesian3.fromDegreesArray([
  -112.1340164450331, 36.05494287836128,
  -112.08821010582645, 36.097804071380715,
  -112.13296079730024, 36.168769146801104
]);
var geometry = new Cesium.GroundPolylineGeometry({
  positions : positions
});

参考：

GroundPolylinePrimitive

成员变量

arcType : ArcType

Core/GroundPolylineGeometry.js 117

折线必须遵循的路径类型。有效的选项是ArcType.GEODESIC和ArcType.RHUMB。

Default Value: ArcType.GEODESIC

granularity : Boolean

Core/GroundPolylineGeometry.js 102

用于插值options.points的距离间隔。0表示没有插值。默认为9999.0允许厘米精度和32位浮点数。

Default Value: 9999.0

loop : Boolean

Core/GroundPolylineGeometry.js 110

在几何图形创建过程中，是否在最后一行和第一行线位置之间添加线段以使该折线成为循环。如果几何图形有两个位置，这个参数将被忽略。

Default Value: false

width : Number

Core/GroundPolylineGeometry.js 92

屏幕空间宽度（以像素为单位）。

内置方法

staticCesium.GroundPolylineGeometry.pack(value, array, startingIndex) → Array.<Number>

Core/GroundPolylineGeometry.js 258

将提供的实例存储到提供的数组中。

Name	Type	Default	Description
`value`	PolygonGeometry		要包装的值。
`array`	Array.<Number>		要被包装到的数组。
`startingIndex`	Number	`0`	optional 开始包装元素的数组索引。

返回值：

被包装到的数组。

staticCesium.GroundPolylineGeometry.unpack(array, startingIndex, result) → PolygonGeometry

Core/GroundPolylineGeometry.js 305

从已包装的数组中检索实例。

Name	Type	Default	Description
`array`	Array.<Number>		包装的数组。
`startingIndex`	Number	`0`	optional 要解包的元素的起始索引。
`result`	PolygonGeometry		optional 存储结果的对象。