笛卡尔坐标系中由等式定义的二次曲面
(x/a)^ 2 +(y/b)^ 2 +(z/c)^ 2 = 1
。主要用于用cesium表示行星体的形状。与其直接构造此对象,不如提供通常使用常量。
Name | Type | Default | Description |
---|---|---|---|
x
|
Number |
0
|
可选 x方向上的半径。 |
y
|
Number |
0
|
可选 y方向上的半径。 |
z
|
Number |
0
|
可选 z方向上的半径。 |
Throws:
-
DeveloperError :所有半径分量必须大于或等于零。
Members
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
在椭圆半径上获取一个。
readonly oneOverRadiiSquared : Cartesian3
在椭球的平方半径上获取一个。
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 | 可选 将结果存储到的对象,如果是新对象则为undefined 实例应该被创建。 |
Returns:
克隆的椭球体。 (如果未定义椭球,则返回undefined)
static Cesium.Ellipsoid.fromCartesian3 ( cartesian , result ) → Ellipsoid
从笛卡尔计算一个椭球,指定沿x,y和z方向的半径。
Name | Type | Default | Description |
---|---|---|---|
cartesian
|
Cartesian3 |
Cartesian3.ZERO
|
可选 椭圆体在x,y和z方向上的半径。 |
result
|
Ellipsoid | 可选 将结果存储到的对象,如果是新对象则为undefined 实例应该被创建。 |
Returns:
一个新的Ellipsoid实例。
Throws:
-
DeveloperError :所有半径分量必须大于或等于零。
将提供的实例存储到提供的数组中。
Name | Type | Default | Description |
---|---|---|---|
value
|
Ellipsoid | 要打包的值。 | |
array
|
Array.<Number> | 要打包的数组。 | |
startingIndex
|
Number |
0
|
可选 开始包装元素的数组索引。 |
Returns:
打包到的数组
static Cesium.Ellipsoid.unpack (array, startingIndex , result ) → Ellipsoid
从压缩数组中检索实例。
Name | Type | Default | Description |
---|---|---|---|
array
|
Array.<Number> | 压缩数组。 | |
startingIndex
|
Number |
0
|
可选 要解压缩的元素的起始索引。 |
result
|
Ellipsoid | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数;如果未提供,则为新的Ellipsoid实例。
cartesianArrayToCartographicArray (cartesians, result ) → Array.< Cartographic >
将提供的笛卡尔坐标数组转换为地图学数组。
Name | Type | Description |
---|---|---|
cartesians
|
Array.< Cartesian3 > | 笛卡尔位置数组。 |
result
|
Array.< Cartographic > | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数或新的Array实例(如果未提供)。
Example:
//Create an array of Cartesians and determine their Cartographic representation on a WGS84 ellipsoid.
var 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)]
var cartographicPositions = Cesium.Ellipsoid.WGS84.cartesianArrayToCartographicArray(positions);
cartesianToCartographic (cartesian, result ) → Cartographic
将提供的笛卡尔转换为制图表达。直角坐标在椭圆体的中心是不确定的。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要转换为制图表达的笛卡尔位置。 |
result
|
Cartographic | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果未提供,则为新的制图实例;如果笛卡尔位于椭圆体的中心,则为未定义。
Example:
//Create a Cartesian and determine it's Cartographic representation on a WGS84 ellipsoid.
var position = new Cesium.Cartesian3(17832.12, 83234.52, 952313.73);
var cartographicPosition = Cesium.Ellipsoid.WGS84.cartesianToCartographic(position);
cartographicArrayToCartesianArray (cartographics, result ) → Array.< Cartesian3 >
将提供的地图学数组转换为笛卡尔数组。
Name | Type | Description |
---|---|---|
cartographics
|
Array.< Cartographic > | 一系列的制图位置。 |
result
|
Array.< Cartesian3 > | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数或新的Array实例(如果未提供)。
Example:
//Convert an array of Cartographics and determine their Cartesian representation on a WGS84 ellipsoid.
var 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)];
var cartesianPositions = Cesium.Ellipsoid.WGS84.cartographicArrayToCartesianArray(positions);
cartographicToCartesian (cartographic, result ) → Cartesian3
将提供的制图转换为直角表示。
Name | Type | Description |
---|---|---|
cartographic
|
Cartographic | 制图位置。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果没有提供则提供新的Cartesian3实例。
Example:
//Create a Cartographic and determine it's Cartesian representation on a WGS84 ellipsoid.
var position = new Cesium.Cartographic(Cesium.Math.toRadians(21), Cesium.Math.toRadians(78), 5000);
var cartesianPosition = Cesium.Ellipsoid.WGS84.cartographicToCartesian(position);
clone ( result ) → Ellipsoid
复制一个Ellipsoid实例。
Name | Type | Description |
---|---|---|
result
|
Ellipsoid | 可选 将结果存储到的对象,如果是新对象则为undefined 实例应该被创建。 |
Returns:
克隆的椭球体。
将此Ellipsoid与提供的Ellipsoid组件进行比较,然后返回如果相等,则为
true
,否则为
false
。
Name | Type | Description |
---|---|---|
right
|
Ellipsoid | 可选 另一个椭球。 |
Returns:
真正
如果相等,
假
除此以外。
geocentricSurfaceNormal (cartesian, result ) → Cartesian3
计算从此椭球的中心指向提供的笛卡尔位置的单位向量。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要确定其地心法线的笛卡尔坐标。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果没有提供则提供新的Cartesian3实例。
geodeticSurfaceNormal (cartesian, result ) → Cartesian3
在指定位置计算与椭圆表面相切的平面的法线。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 要确定表面法线的笛卡尔位置。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果没有提供则提供新的Cartesian3实例。
geodeticSurfaceNormalCartographic (cartographic, result ) → Cartesian3
在指定位置计算与椭圆表面相切的平面的法线。
Name | Type | Description |
---|---|---|
cartographic
|
Cartographic | 要确定大地法线的地图位置。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果没有提供则提供新的Cartesian3实例。
getSurfaceNormalIntersectionWithZAxis (position, buffer , result ) → Cartesian3 |undefined
计算一个点,该点是表面法线与z轴的交点。
Name | Type | Default | Description |
---|---|---|---|
position
|
Cartesian3 | 位置。必须在椭球表面上。 | |
buffer
|
Number |
0.0
|
可选 检查点是否在椭圆体内部时从椭圆体大小中减去的缓冲区。 在大地情况下,使用公共大地基准,则不需要此缓冲区,因为相交点始终(相对)非常靠近中心。 在WGS84基准中,交点最大为z = + -42841.31151331382(z轴的0.673%)。 如果MajorAxis/AxisOfRotation的比大于2的平方根,则交点可能在椭圆体之外。 |
result
|
Cartesian3 | 可选 将结果复制到的笛卡尔坐标,或者未定义的笛卡尔坐标创建和 返回一个新实例。 |
Returns:
相交点(如果在椭圆体内),否则未定义
Throws:
-
DeveloperError :位置是必需的。
-
DeveloperError :椭球体必须是旋转的椭球体(radii.x == radii.y)。
-
DeveloperError :Ellipsoid.radii.z必须大于0。
scaleToGeocentricSurface (cartesian, result ) → Cartesian3
沿地心曲面法线缩放提供的笛卡尔位置这样它就在这个椭球的表面上。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 直角坐标位置。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果没有提供则提供新的Cartesian3实例。
scaleToGeodeticSurface (cartesian, result ) → Cartesian3
沿大地表面法线缩放提供的笛卡尔位置这样它就在这个椭球的表面上。如果位置是在椭圆体的中心,此函数返回undefined。
Name | Type | Description |
---|---|---|
cartesian
|
Cartesian3 | 直角坐标位置。 |
result
|
Cartesian3 | 可选 将结果存储到的对象。 |
Returns:
修改后的结果参数,如果未提供,则为新的Cartesian3实例;如果位置为中心,则未定义。
创建以'(radii.x,radii.y,radii.z)'格式表示此Ellipsoid的字符串。
Returns:
以'(radii.x,radii.y,radii.z)格式表示此椭球的字符串。
transformPositionFromScaledSpace (position, result ) → Cartesian3
通过乘以变换椭圆形缩放空间的笛卡尔X,Y,Z位置由
Ellipsoid#radii
的结果得出。
Name | Type | Description |
---|---|---|
position
|
Cartesian3 | 要转换的位置。 |
result
|
Cartesian3 | 可选 将结果复制到的位置,或者未定义的位置来创建和 返回一个新实例。 |
Returns:
在无标度空间中表示的位置。返回的实例是 如果未定义,则将其作为结果参数传递,或者将其作为新实例传递。
transformPositionToScaledSpace (position, result ) → Cartesian3
通过相乘将笛卡尔X,Y,Z位置转换为椭圆形缩放的空间
Ellipsoid#oneOverRadii
的结果。
Name | Type | Description |
---|---|---|
position
|
Cartesian3 | 要转换的位置。 |
result
|
Cartesian3 | 可选 将结果复制到的位置,或者未定义的位置来创建和 返回一个新实例。 |
Returns:
在比例空间中表示的位置。返回的实例是 如果未定义,则将其作为结果参数传递,或者将其作为新实例传递。