Cesium API - PolylineGeometry 中文文档

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

PolylineGeometry API 调用方法

new Cesium.PolylineGeometry(options)

Core/PolylineGeometry.js 132

以线带（line strip）形式建模的折线的描述；前两个位置定义一个线段，每个额外的位置和前一个位置的定义一个线段。折线可以用一种材质来显示。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		一个`Cartesian3`数组，它将折线中的位置定义为一条线带（line strip）。
`width`	Number	`1.0`	optional 宽度（以像素为单位）。
`colors`	Array.<Color>		optional 定义每个顶点或每个段颜色的`Color`数组。
`colorsPerVertex`	Boolean	`false`	optional 一个布尔值，它决定颜色是在每段直线上是单调的（flat）还是在顶点上是插值的。
`arcType`	ArcType	`ArcType.GEODESIC`	optional 折线段必须遵循的线的类型。
`granularity`	Number	`CesiumMath.RADIANS_PER_DEGREE`	optional 每个纬度和经度之间的距离（以弧度表示），如果options.arcType不是ArcType.NONE。确定缓冲区中的位置数。
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 用作参考的椭球体。

异常情况：

DeveloperError : 至少需要两个位置。
DeveloperError : width必须大于等于1。
DeveloperError : colors的长度无效。

示例：

// 两条线段相连的折线
var polyline = new Cesium.PolylineGeometry({
  positions : Cesium.Cartesian3.fromDegreesArray([
    0.0, 0.0,
    5.0, 0.0,
    5.0, 5.0
  ]),
  width : 10.0
});
var geometry = Cesium.PolylineGeometry.createGeometry(polyline);

演示Demo：

Cesium Sandcastle Polyline Demo

参考：

PolylineGeometry#createGeometry

成员变量

packedLength : Number

Core/PolylineGeometry.js 173

用于将对象打包成数组的元素数。

内置方法

staticCesium.PolylineGeometry.createGeometry(polylineGeometry) → Geometry|undefined

Core/PolylineGeometry.js 342

计算折线的几何表示，包括其顶点、索引和包围球。

Name	Type	Description
`polylineGeometry`	PolylineGeometry	折线的描述。

返回值：

计算的顶点和索引。

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

Core/PolylineGeometry.js 194

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

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

返回值：

被包装到的数组。

staticCesium.PolylineGeometry.unpack(array, startingIndex, result) → PolylineGeometry

Core/PolylineGeometry.js 267

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

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