Ellipsoid - SuperMap3D Documentation

Ellipsoid

new SuperMap3D.Ellipsoid(options, x, y, z)

由等式 (x/a)^2 + (y/b)^2 + (z/c)^2 = 1 在Cartesian坐标中定义的二次曲面。通常使用提供的常量之一，而不是直接构造此对象。

Name	Type	Default	Description
`options`	Object		具有以下属性的对象:
`x`	Number	`0`	optional X方向的半径值。
`y`	Number	`0`	optional Y方向的半径值。
`z`	Number	`0`	optional Z方向的半径值。

Throws:

DeveloperError : 所有的半径值必须大于或等于0。

See:

Ellipsoid.WGS84

Members

staticconstantSuperMap3D.Ellipsoid.CGCS2000 : Ellipsoid

CGCS2000椭球体，其x,y,z方向的半径分别为6378137.0, 6378137.0, 6356752.31。

staticconstantSuperMap3D.Ellipsoid.MOON : Ellipsoid

一个 Ellipsoid 实例初始化为具有月球半径的球体。

staticSuperMap3D.Ellipsoid.packedLength : Number

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

staticconstantSuperMap3D.Ellipsoid.UNIT_SPHERE : Ellipsoid

一个 Ellipsoid 实例初始化为 (1.0, 1.0, 1.0) 的半径。

staticconstantSuperMap3D.Ellipsoid.WGS84 : Ellipsoid

球的实例，默认是椭球模式，即x,y,z方向的半径分别设为6378137, 6378137, 6356752.3142451793。

Example:

SuperMap3D.Ellipsoid.WGS84 = SuperMap3D.freezeObject(new SuperMap3D.Ellipsoid(6378137.0, 6378137.0, 6356752.3142451793));

staticconstantSuperMap3D.Ellipsoid.XIAN80 : Ellipsoid

西安80椭球体，其x,y,z方向的半径分别为6378140.0, 6378140.0, 6356755.29。

Example:

var ellipsoid = SuperMap3D.Ellipsoid.XIAN80;

readonlymaximumRadius : Number

获取椭圆体的最大半径。

readonlyminimumRadius : Number

获取椭圆体的最小半径。

readonlyoneOverRadii : Cartesian3

在椭球半径范围内获取一。

readonlyoneOverRadiiSquared : Cartesian3

在椭球半径的平方范围内取一。

readonlyradii : Cartesian3

获取椭球的半径。

readonlyradiiSquared : Cartesian3

获取椭圆体的平方半径。

readonlyradiiToTheFourth : Cartesian3

获取椭球半径的四次方。

Methods

staticSuperMap3D.Ellipsoid.clone(ellipsoid, result) → Ellipsoid

复制一个椭圆体实例。

Name	Type	Description
`ellipsoid`	Ellipsoid	要复制的椭圆体。
`result`	Ellipsoid	optional 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

克隆的椭球体。（如果椭圆体未定义，则返回未定义）

staticSuperMap3D.Ellipsoid.fromCartesian3(cartesian, result) → Ellipsoid

根据指定 x、y 和 z 方向的半径的Cartesian计算椭圆体。

Name	Type	Default	Description
`cartesian`	Cartesian3	`Cartesian3.ZERO`	optional 椭球在 x、y 和 z 方向上的半径。
`result`	Ellipsoid		optional 存储结果的对象，如果应该创建一个新实例，则为 undefined。

Returns:

一个新的 Ellipsoid 实例。

Throws:

DeveloperError : 所有半径必须大于或等于零。

See:

staticSuperMap3D.Ellipsoid.pack(value, array, startingIndex) → Array.<Number>

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

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

Returns:

装入的数组。

staticSuperMap3D.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>

将提供的Cartesian数组转换为投影数组。

Name	Type	Description
`cartesians`	Array.<Cartesian3>	Cartesian位置数组。
`result`	Array.<Cartographic>	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的 Array 实例。

Example:

//Create an array of Cartesians and determine their Cartographic representation on a WGS84 ellipsoid.
var positions = [new SuperMap3D.Cartesian3(17832.12, 83234.52, 952313.73),
                 new SuperMap3D.Cartesian3(17832.13, 83234.53, 952313.73),
                 new SuperMap3D.Cartesian3(17832.14, 83234.54, 952313.73)]
var cartographicPositions = SuperMap3D.Ellipsoid.WGS84.cartesianArrayToCartographicArray(positions);

cartesianToCartographic(cartesian, result) → Cartographic

将提供的Cartesian坐标转换为投影表示，Cartesian在椭圆体的中心未定义。

Name	Type	Description
`cartesian`	Cartesian3	要转换为投影表示的Cartesian位置。
`result`	Cartographic	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供新的投影实例，或者如果Cartesian位于椭圆体的中心，则为未定义。

Example:

//Create a Cartesian and determine it's Cartographic representation on a WGS84 ellipsoid.
var position = new SuperMap3D.Cartesian3(17832.12, 83234.52, 952313.73);
var cartographicPosition = SuperMap3D.Ellipsoid.WGS84.cartesianToCartographic(position);

cartographicArrayToCartesianArray(cartographics, result) → Array.<Cartesian3>

将提供的投影数组转换为Cartesian数组。

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.
var positions = [new SuperMap3D.Cartographic(SuperMap3D.Math.toRadians(21), SuperMap3D.Math.toRadians(78), 0),
                 new SuperMap3D.Cartographic(SuperMap3D.Math.toRadians(21.321), SuperMap3D.Math.toRadians(78.123), 100),
                 new SuperMap3D.Cartographic(SuperMap3D.Math.toRadians(21.645), SuperMap3D.Math.toRadians(78.456), 250)];
var cartesianPositions = SuperMap3D.Ellipsoid.WGS84.cartographicArrayToCartesianArray(positions);

cartographicToCartesian(cartographic, result) → Cartesian3

将提供的投影转换为Cartesian表示法。

Name	Type	Description
`cartographic`	Cartographic	投影位置。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的 Cartesian3 实例。

Example:

//Create a Cartographic and determine it's Cartesian representation on a WGS84 ellipsoid.
var position = new SuperMap3D.Cartographic(SuperMap3D.Math.toRadians(21), SuperMap3D.Math.toRadians(78), 5000);
var cartesianPosition = SuperMap3D.Ellipsoid.WGS84.cartographicToCartesian(position);

clone(result) → Ellipsoid

复制一个 Ellipsoid 实例。

Name	Type	Description
`result`	Ellipsoid	optional 要复制的椭圆体。

Returns:

存储结果的对象，如果应该创建一个新实例，则为 undefined。

equals(right) → Boolean

将此 Ellipsoid 与提供的 Ellipsoid 进行比较，如果它们相等则返回 true ，否则返回 false 。

Name	Type	Description
`right`	Ellipsoid	optional 另一个椭球体。

Returns:

如果相等，则为 true ，否则为 false 。

geocentricSurfaceNormal(cartesian, result) → Cartesian3

计算从该椭球中心指向提供的Cartesian位置的单位向量。

Name	Type	Description
`cartesian`	Cartesian3	确定地心法线的cartesian。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的 Cartesian3 实例。

geodeticSurfaceNormal(cartesian, result) → Cartesian3

计算在给定位置与椭球表面相切的平面法线。

Name	Type	Description
`cartesian`	Cartesian3	要确定表面法线的cartesian位置。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

如果没有提供修改的结果参数或新的 Cartesian3 实例，或者如果找不到法线则未定义。

geodeticSurfaceNormalCartographic(cartographic, result) → Cartesian3

计算在给定位置与椭球表面相切的平面法线。

Name	Type	Description
`cartographic`	Cartographic	确定大地法线的投影位置。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的 Cartesian3 实例。

getSurfaceNormalIntersectionWithZAxis(position, buffer, result) → Cartesian|undefined

计算一个点，该点是表面法线与 z 轴的交点。

Name	Type	Default	Description
`position`	Cartesian3		位置。必须在椭球的表面上。
`buffer`	Number	`0.0`	optional 检查点是否在椭球内时从椭球大小中减去的缓冲区。在地球情况下，使用公共地球基准，不需要这个缓冲区，因为交点总是（相对）非常靠近中心。在 WGS84 基准中，交点位于最大 z = +-42841.31151331382（z 轴的 0.673%）。如果 MajorAxis/AxisOfRotation 的比率大于 2 的平方根，则交点可能在椭球之外
`result`	Cartesian		optional 要将结果复制到的Cartesian坐标系，或者 undefined 以创建和返回新实例。

Returns:

如果它在椭圆体内，则为交点，否则为未定义。

Throws:

DeveloperError : 位置是必需的。
DeveloperError : 椭球体必须是旋转椭球体 (radii.x == radii.y)。
DeveloperError : Ellipsoid.radii.z 必须大于 0。

scaleToGeocentricSurface(cartesian, result) → Cartesian3

沿地心表面法线缩放提供的cartesian位置，使其位于该椭圆体的表面上。

Name	Type	Description
`cartesian`	Cartesian3	要缩放的Cartesian位置。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

如果未提供修改的结果参数或新的 Cartesian3 实例。

scaleToGeodeticSurface(cartesian, result) → Cartesian3

沿大地表面法线缩放提供的Cartesian位置，使其位于该椭圆体的表面上。如果该位置在椭圆体的中心，则此函数返回 undefined。

Name	Type	Description
`cartesian`	Cartesian3	要缩放的Cartesian位置。
`result`	Cartesian3	optional 存储结果的对象。

Returns:

修改后的结果参数，如果没有提供新的 Cartesian3 实例，如果位置在中心，则为 undefined。

toString() → String

以'（radii.x，radii.y，radii.z）'格式创建一个表示此椭圆体的字符串。

Returns:

以'（radii.x，radii.y，radii.z）'格式表示此椭球的字符串。

transformPositionFromScaledSpace(position, result) → Cartesian3

通过将其分量乘以 Ellipsoid#radii的结果，从椭圆体缩放空间转换Cartesian X、Y、Z 位置。

Name	Type	Description
`position`	Cartesian3	要变换的位置。
`result`	Cartesian3	optional 要将结果复制到的位置，或者 undefined 以创建和返回新实例。

Returns:

在未缩放空间中表示的位置。如果它不是未定义的，则返回的实例是作为结果参数传递的实例，或者它的新实例。

transformPositionToScaledSpace(position, result) → Cartesian3

通过将其分量乘以Ellipsoid#oneOverRadii的结果，将Cartesian X、Y、Z 位置转换为椭圆体缩放空间。

Name	Type	Description
`position`	Cartesian3	要变换的位置。
`result`	Cartesian3	optional 要将结果复制到的位置，或者 undefined 以创建和返回新实例。

Returns:

在缩放空间中表示的位置。如果它不是未定义的，则返回的实例是作为结果参数传递的实例，或者它的新实例。