Cesium API - WallGeometry 中文文档

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

WallGeometry API 调用方法

new Cesium.WallGeometry(options)

Core/WallGeometry.js 101

一种对墙的描述，类似于KML行字符串。墙是由一系列的点构成的，这些点向下延伸到地面。可选地，它们可以向下挤压到指定的高度。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		笛卡尔对象数组，它们是墙的点。
`granularity`	Number	`CesiumMath.RADIANS_PER_DEGREE`	optional 每个经度和纬度之间的距离，以弧度表示。确定缓冲区中的位置数。
`maximumHeights`	Array.<Number>		optional 与`positions`并行的数组，给出了在`positions`处墙的最大高度。如果未定义，则使用每个位置的高度。
`minimumHeights`	Array.<Number>		optional 与`positions`并行的数组，给出了在`positions`处墙的最小高度。如果未定义，则每个位置的高度为0.0。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 用于坐标操作的椭球体
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。

异常情况：

DeveloperError : positions 长度必须大于等于2。
DeveloperError : positions 和 maximumHeights 的长度必须相同
DeveloperError : positions 和 minimumHeights 的长度必须相同

示例：

// 建一堵从地面到10000米的墙
var wall = new Cesium.WallGeometry({
  positions : Cesium.Cartesian3.fromDegreesArrayHeights([
    19.0, 47.0, 10000.0,
    19.0, 48.0, 10000.0,
    20.0, 48.0, 10000.0,
    20.0, 47.0, 10000.0,
    19.0, 47.0, 10000.0
  ])
});
var geometry = Cesium.WallGeometry.createGeometry(wall);

演示Demo：

Cesium Sandcastle Wall Demo

参考：

WallGeometry#createGeometry
WallGeometry#fromConstantHeight

成员变量

packedLength : Number

Core/WallGeometry.js 148

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

内置方法

staticCesium.WallGeometry.createGeometry(wallGeometry) → Geometry|undefined

Core/WallGeometry.js 429

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

Name	Type	Description
`wallGeometry`	WallGeometry	墙的描述。

返回值：

计算的顶点和索引。

staticCesium.WallGeometry.fromConstantHeights(options) → WallGeometry

Core/WallGeometry.js 373

一种对墙的描述，类似于KML行字符串。墙是由一系列的点构成的，这些点向下延伸到地面。可选地，它们可以向下挤压到指定的高度。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`positions`	Array.<Cartesian3>		笛卡尔对象数组，它们是墙的点。
`maximumHeight`	Number		optional 定义在`positions`处的墙的最大高度的常量。如果未定义，则使用每个位置的高度。
`minimumHeight`	Number		optional 定义在`positions`处的墙的最小高度的常量。如果未定义，则每个位置的高度为0.0。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 用于坐标操作的椭球体
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。

返回值：

示例：

// 建造一堵从10000米到20000米的墙
var wall = Cesium.WallGeometry.fromConstantHeights({
  positions : Cesium.Cartesian3.fromDegreesArray([
    19.0, 47.0,
    19.0, 48.0,
    20.0, 48.0,
    20.0, 47.0,
    19.0, 47.0,
  ]),
  minimumHeight : 20000.0,
  maximumHeight : 10000.0
});
var geometry = Cesium.WallGeometry.createGeometry(wall);

参考：

WallGeometry#createGeometry

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

Core/WallGeometry.js 169

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

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

返回值：

被包装到的数组。

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

Core/WallGeometry.js 249

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

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