Cesium API - BoxGeometry 中文文档

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

BoxGeometry API 调用方法

new Cesium.BoxGeometry(options)

Core/BoxGeometry.js 43

描述以原点为中心的立方体。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`minimum`	Cartesian3		盒子的最小x, y, z坐标。
`maximum`	Cartesian3		盒子的最大x, y, z坐标。
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。

示例：

var box = new Cesium.BoxGeometry({
  vertexFormat : Cesium.VertexFormat.POSITION_ONLY,
  maximum : new Cesium.Cartesian3(250000.0, 250000.0, 250000.0),
  minimum : new Cesium.Cartesian3(-250000.0, -250000.0, -250000.0)
});
var geometry = Cesium.BoxGeometry.createGeometry(box);

演示Demo：

Cesium Sandcastle Box Demo

参考：

成员变量

staticCesium.BoxGeometry.packedLength : Number

Core/BoxGeometry.js 139

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

内置方法

staticCesium.BoxGeometry.createGeometry(boxGeometry) → Geometry|undefined

Core/BoxGeometry.js 215

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

Name	Type	Description
`boxGeometry`	BoxGeometry	盒子的描述。

返回值：

计算的顶点和索引。

staticCesium.BoxGeometry.fromAxisAlignedBoundingBox(boundingBox) → BoxGeometry

Core/BoxGeometry.js 124

从AxisAlignedBoundingBox的尺寸创建一个立方体。

Name	Type	Description
`boundingBox`	AxisAlignedBoundingBox	AxisAlignedBoundingBox的描述。

返回值：

示例：

var aabb = Cesium.AxisAlignedBoundingBox.fromPoints(Cesium.Cartesian3.fromDegreesArray([
     -72.0, 40.0,
     -70.0, 35.0,
     -75.0, 30.0,
     -70.0, 30.0,
     -68.0, 40.0
]));
var box = Cesium.BoxGeometry.fromAxisAlignedBoundingBox(aabb);

参考：

BoxGeometry.createGeometry

staticCesium.BoxGeometry.fromDimensions(options) → BoxGeometry

Core/BoxGeometry.js 85

创建一个以给定尺寸的原点为中心的立方体。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`dimensions`	Cartesian3		分别存储在`Cartesian3`的x、y和z坐标中的盒子的宽度、深度和高度。
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。

返回值：

异常情况：

DeveloperError : 所有的维度分量必须大于或等于零。

示例：

var box = Cesium.BoxGeometry.fromDimensions({
  vertexFormat : Cesium.VertexFormat.POSITION_ONLY,
  dimensions : new Cesium.Cartesian3(500000.0, 500000.0, 500000.0)
});
var geometry = Cesium.BoxGeometry.createGeometry(box);

参考：

BoxGeometry.createGeometry

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

Core/BoxGeometry.js 150

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

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

返回值：

被包装到的数组。

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

Core/BoxGeometry.js 184

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

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