Cesium API - EllipseGeometry 中文文档

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

EllipseGeometry API 调用方法

new Cesium.EllipseGeometry(options)

Core/EllipseGeometry.js 767

在椭球面上对椭圆的描述。椭圆几何可以被Primitive和GroundPrimitive渲染。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`center`	Cartesian3		椭圆的中心点。
`semiMajorAxis`	Number		椭圆长半轴的长度，以米为单位。
`semiMinorAxis`	Number		椭圆短半轴的长度，以米为单位。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 椭圆将放到的椭球面。
`height`	Number	`0.0`	optional 椭圆和椭球面之间的距离，以米为单位。
`extrudedHeight`	Number		optional 椭圆的挤压面与椭球面之间的距离，以米为单位。
`rotation`	Number	`0.0`	optional 从北方逆时针旋转的角度。
`stRotation`	Number	`0.0`	optional 从北方逆时针旋转的纹理的角度。
`granularity`	Number	`CesiumMath.RADIANS_PER_DEGREE`	optional 椭圆上点之间的角距离，以弧度表示。
`vertexFormat`	VertexFormat	`VertexFormat.DEFAULT`	optional 要计算的顶点属性。

异常情况：

DeveloperError : 长半轴和短半轴必须大于0。
DeveloperError : 长半轴必须大于或等于短半轴。
DeveloperError : 粒度（granularity）必须大于零。

示例：

// 创建一个椭圆。
var ellipse = new Cesium.EllipseGeometry({
  center : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
  semiMajorAxis : 500000.0,
  semiMinorAxis : 300000.0,
  rotation : Cesium.Math.toRadians(60.0)
});
var geometry = Cesium.EllipseGeometry.createGeometry(ellipse);

参考：

EllipseGeometry.createGeometry

成员变量

staticCesium.EllipseGeometry.packedLength : Number

Core/EllipseGeometry.js 818

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

内置方法

staticCesium.EllipseGeometry.computeRectangle(options, result) → Rectangle

Core/EllipseGeometry.js 986

根据提供的选项计算椭圆的包围矩形。

Name Type Description

options

Object

对象，具有以下属性：

Name	Type	Default	Description
`center`	Cartesian3		椭圆的中心点。
`semiMajorAxis`	Number		椭圆长半轴的长度，以米为单位。
`semiMinorAxis`	Number		椭圆短半轴的长度，以米为单位。
`ellipsoid`	Ellipsoid	`Ellipsoid.WGS84`	optional 椭圆将放到的椭球面。
`rotation`	Number	`0.0`	optional 从北方逆时针旋转的角度。
`granularity`	Number	`CesiumMath.RADIANS_PER_DEGREE`	optional 椭圆上各点之间的角距离，以弧度表示。

result Rectangle optional 存储结果的对象。

返回值：

结果矩形。

staticCesium.EllipseGeometry.createGeometry(ellipseGeometry) → Geometry|undefined

Core/EllipseGeometry.js 1023

计算椭圆在椭球面上的几何表示，包括其顶点、索引和包围球。

Name	Type	Description
`ellipseGeometry`	EllipseGeometry	椭圆的描述。

返回值：

计算的顶点和索引。

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

Core/EllipseGeometry.js 838

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

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

返回值：

被包装到的数组。

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

Core/EllipseGeometry.js 902

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

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