由方程
(x / a)^2 + (y / b)^2 + (z / c)^2 = 1. 主要用途
由 Cesium 表示行星体的形状。
而不是直接构造此对象，而是提供的
常量。
| Name | Type | Default | Description |
|---|---|---|---|
x |
number |
0
|
optional x 方向的半径。 |
y |
number |
0
|
optional y 方向的半径。 |
z |
number |
0
|
optional z 方向的半径。 |
Throws:
-
DeveloperError : All radii components must be greater than or equal to zero.
Members
static Cesium.Ellipsoid.default : Ellipsoid
未另行指定时使用的默认椭球体。
Example:
Cesium.Ellipsoid.default = Cesium.Ellipsoid.MOON;
// Apollo 11 landing site
const position = Cesium.Cartesian3.fromRadians(
0.67416,
23.47315,
);static constant Cesium.Ellipsoid.MOON : Ellipsoid
初始化为具有月球半径的球体的 Ellipsoid 实例。
用于将对象打包到数组中的元素数量。
static constant Cesium.Ellipsoid.UNIT_SPHERE : Ellipsoid
初始化为半径 (1.0, 1.0, 1.0) 的 Ellipsoid 实例。
static constant Cesium.Ellipsoid.WGS84 : Ellipsoid
初始化为 WGS84 标准的 Ellipsoid 实例。
获取椭球体的最大半径。
获取椭球体的最小半径。
readonly oneOverRadii : Cartesian3
在椭球体的半径上获取 1。
readonly oneOverRadiiSquared : Cartesian3
在椭球体的平方半径上获取 1。
readonly radii : Cartesian3
获取椭球体的半径。
readonly radiiSquared : Cartesian3
获取椭球体的平方半径。
readonly radiiToTheFourth : Cartesian3
获取椭球体的半径提高到四次方。
Methods
static Cesium.Ellipsoid.clone(ellipsoid, result) → Ellipsoid
复制 Ellipsoid 实例。
| Name | Type | Description |
|---|---|---|
ellipsoid |
Ellipsoid | 要复制的椭球体。 |
result |
Ellipsoid | optional 存储结果的对象，如果新的、 实例。 |
Returns:
克隆的 Ellipsoid。(如果省略球体为 undefined，则返回 undefined)
static Cesium.Ellipsoid.fromCartesian3(cartesian, result) → Ellipsoid
根据指定 x、y 和 z 方向半径的笛卡尔计算椭球体。
| Name | Type | Default | Description |
|---|---|---|---|
cartesian |
Cartesian3 |
Cartesian3.ZERO
|
optional 椭球体在 x、y 和 z 方向上的半径。 |
result |
Ellipsoid | optional 存储结果的对象，如果新的、 实例。 |
Returns:
一个新的 Ellipsoid 实例。
Throws:
-
DeveloperError : All radii components must be greater than or equal to zero.
将提供的实例存储到提供的数组中。
| Name | Type | Default | Description |
|---|---|---|---|
value |
Ellipsoid | 要打包的值。 | |
array |
Array.<number> | 要装入的数组。 | |
startingIndex |
number |
0
|
optional 开始打包元素的数组的索引。 |
Returns:
被装入的数组
static Cesium.Ellipsoid.unpack(array, startingIndex, result) → Ellipsoid
从打包数组中检索实例。
| Name | Type | Default | Description |
|---|---|---|---|
array |
Array.<number> | 打包数组。 | |
startingIndex |
number |
0
|
optional 要解压缩的元素的起始索引。 |
result |
Ellipsoid | optional 要在其中存储结果的对象。 |
Returns:
修改后的结果参数 或者一个新的 Ellipsoid 实例(如果未提供)。
cartesianArrayToCartographicArray(cartesians, result) → Array.<Cartographic>
将提供的笛卡尔数组转换为制图数组。
| Name | Type | Description |
|---|---|---|
cartesians |
Array.<Cartesian3> | 笛卡尔位置的数组。 |
result |
Array.<Cartographic> | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Array 实例(如果未提供)。
Example:
//Create an array of Cartesians and determine their Cartographic representation on a WGS84 ellipsoid.
const positions = [new Cesium.Cartesian3(17832.12, 83234.52, 952313.73),
new Cesium.Cartesian3(17832.13, 83234.53, 952313.73),
new Cesium.Cartesian3(17832.14, 83234.54, 952313.73)]
const cartographicPositions = Cesium.Ellipsoid.WGS84.cartesianArrayToCartographicArray(positions);cartesianToCartographic(cartesian, result) → Cartographic
将提供的笛卡尔表示转换为制图表示。
笛卡尔坐标在椭球体的中心未定义。
| Name | Type | Description |
|---|---|---|
cartesian |
Cartesian3 | 要转换为制图表示的笛卡尔位置。 |
result |
Cartographic | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数，如果未提供任何实例，则为新制图实例，如果笛卡尔位于椭球体的中心，则为 undefined。
Example:
//Create a Cartesian and determine it's Cartographic representation on a WGS84 ellipsoid.
const position = new Cesium.Cartesian3(17832.12, 83234.52, 952313.73);
const cartographicPosition = Cesium.Ellipsoid.WGS84.cartesianToCartographic(position);cartographicArrayToCartesianArray(cartographics, result) → Array.<Cartesian3>
将提供的制图数组转换为笛卡尔数组。
| Name | Type | Description |
|---|---|---|
cartographics |
Array.<Cartographic> | 制图位置数组。 |
result |
Array.<Cartesian3> | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Array 实例(如果未提供)。
Example:
//Convert an array of Cartographics and determine their Cartesian representation on a WGS84 ellipsoid.
const positions = [new Cesium.Cartographic(Cesium.Math.toRadians(21), Cesium.Math.toRadians(78), 0),
new Cesium.Cartographic(Cesium.Math.toRadians(21.321), Cesium.Math.toRadians(78.123), 100),
new Cesium.Cartographic(Cesium.Math.toRadians(21.645), Cesium.Math.toRadians(78.456), 250)];
const cartesianPositions = Cesium.Ellipsoid.WGS84.cartographicArrayToCartesianArray(positions);cartographicToCartesian(cartographic, result) → Cartesian3
将提供的制图转换为笛卡尔表示。
| Name | Type | Description |
|---|---|---|
cartographic |
Cartographic | 制图位置。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。
Example:
//Create a Cartographic and determine it's Cartesian representation on a WGS84 ellipsoid.
const position = new Cesium.Cartographic(Cesium.Math.toRadians(21), Cesium.Math.toRadians(78), 5000);
const cartesianPosition = Cesium.Ellipsoid.WGS84.cartographicToCartesian(position);clone(result) → Ellipsoid
复制 Ellipsoid 实例。
| Name | Type | Description |
|---|---|---|
result |
Ellipsoid | optional 存储结果的对象，如果新的、 实例。 |
Returns:
克隆的 Ellipsoid。
将此 Ellipsoid 与提供的 Ellipsoid 组件进行比较，并返回
true，否则为 false。
| Name | Type | Description |
|---|---|---|
right |
Ellipsoid | optional 另一个椭球体。 |
Returns:
true，否则为false。
geocentricSurfaceNormal(cartesian, result) → Cartesian3
计算从此椭球体中心指向提供的笛卡尔位置的单位向量。
| Name | Type | Description |
|---|---|---|
cartesian |
Cartesian3 | 用于确定地心法线的笛卡尔。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。
geodeticSurfaceNormal(cartesian, result) → Cartesian3
计算在给定位置处与椭球体表面相切的平面的法线。
| Name | Type | Description |
|---|---|---|
cartesian |
Cartesian3 | 用于确定表面法线的笛卡尔位置。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)，则为 undefined(如果未找到法线)。
geodeticSurfaceNormalCartographic(cartographic, result) → Cartesian3
计算在给定位置处与椭球体表面相切的平面的法线。
| Name | Type | Description |
|---|---|---|
cartographic |
Cartographic | 用于确定大地测量法线的制图位置。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。
getLocalCurvature(surfacePosition, result) → Cartesian2
计算曲面上给定位置的椭球体曲率。
| Name | Type | Description |
|---|---|---|
surfacePosition |
Cartesian3 | 椭球体曲面上将计算曲率的位置。 |
result |
Cartesian2 | optional 要将结果复制到的笛卡尔坐标，或 undefined 以创建并返回新实例。 |
Returns:
椭球体表面在提供位置(东向和北向)的局部曲率。
Throws:
-
DeveloperError : position is required.
getSurfaceNormalIntersectionWithZAxis(position, buffer, result) → Cartesian3|undefined
计算一个点，该点是曲面法线与 z 轴的交点。
| Name | Type | Default | Description |
|---|---|---|---|
position |
Cartesian3 | 必须位于椭球体的表面上。 | |
buffer |
number |
0.0
|
optional 检查点是否在椭球体内时要从椭球大小中减去的缓冲区。 在地球情况下，对于公共地球基准面，不需要此缓冲区，因为交点总是(相对)非常靠近中心。 在 WGS84 基准面中，交点位于最大 z = +-42841.31151331382(z 轴的 0.673%)处。 如果 MajorAxis / AxisOfRotation 的比率大于 2 的平方根，则交点可能位于椭球体之外 |
result |
Cartesian3 | optional 要将结果复制到的笛卡尔坐标，或 undefined 来创建 和 返回一个新实例。 |
Returns:
如果交点位于椭球体内部，则为 undefined，否则为 undefined
Throws:
-
DeveloperError : 位置是必需的。
-
DeveloperError : 椭球体必须是公转的椭球体 (radii.x == radii.y)。
-
DeveloperError : Ellipsoid.radii.z 必须大于 0。
scaleToGeocentricSurface(cartesian, result) → Cartesian3
沿地心表面法线缩放提供的笛卡尔位置
使其位于此椭球体的表面上。
| Name | Type | Description |
|---|---|---|
cartesian |
Cartesian3 | 刻度的笛卡尔位置。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。
scaleToGeodeticSurface(cartesian, result) → Cartesian3
沿大地测量表面法线缩放提供的笛卡尔位置
使其位于此椭球体的表面上。 如果位置为
在椭球体的中心，此函数返回 undefined。
| Name | Type | Description |
|---|---|---|
cartesian |
Cartesian3 | 刻度的笛卡尔位置。 |
result |
Cartesian3 | optional 要在其上存储结果的对象。 |
Returns:
修改后的结果参数，如果未提供，则为新的 Cartesian3 实例，如果位置位于中心，则为 undefined。
计算矩形在椭球体表面上的表面积的近似值
Gauss-Legendre 10 阶求积。
| Name | Type | Description |
|---|---|---|
rectangle |
Rectangle | 用于计算表面积的矩形。 |
Returns:
矩形在这个椭球体表面上的近似面积。
创建一个字符串，表示此椭球体，格式为 '(radii.x, radii.y, radii.z)'。
Returns:
表示此椭球体的字符串，格式为 '(radii.x, radii.y, radii.z)'。
transformPositionFromScaledSpace(position, result) → Cartesian3
通过乘以
其分量由
Ellipsoid#radii 的结果。
| Name | Type | Description |
|---|---|---|
position |
Cartesian3 | 要转换的位置。 |
result |
Cartesian3 | optional 将结果复制到的位置，或 undefined 创建 和 返回一个新实例。 |
Returns:
在未缩放空间中表示的位置。 返回的实例是
如果它不是 undefined，则作为 result 参数传递的，或者它是它的新实例。
transformPositionToScaledSpace(position, result) → Cartesian3
通过乘法将笛卡尔 X、Y、Z 位置转换为椭球标度空间
其组件由
Ellipsoid#oneOverRadii 的结果。
| Name | Type | Description |
|---|---|---|
position |
Cartesian3 | 要转换的位置。 |
result |
Cartesian3 | optional 将结果复制到的位置，或 undefined 创建 和 返回一个新实例。 |
Returns:
在缩放空间中表示的位置。 返回的实例是
如果它不是 undefined，则作为 result 参数传递的，或者它是它的新实例。