Cartesian3

Members

x : Number

X分量。

Default Value: 0.0

y : Number

Y分量。

Default Value: 0.0

z : Number

Z分量。

Default Value: 0.0

staticSuperMap3D.Cartesian3.packedLength : Number

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

staticconstantSuperMap3D.Cartesian3.UNIT_X : Cartesian3

一个不可变的 Cartesian3 实例，初始化为 (1.0, 0.0, 0.0)。

staticconstantSuperMap3D.Cartesian3.UNIT_Y : Cartesian3

一个不可变的 Cartesian3 实例，初始化为 (0.0, 1.0, 0.0)。

staticconstantSuperMap3D.Cartesian3.UNIT_Z : Cartesian3

一个不可变的 Cartesian3 实例，初始化为 (0.0, 0.0, 1.0)。

staticconstantSuperMap3D.Cartesian3.ZERO : Cartesian3

一个不可变的 Cartesian3 实例，初始化为 (0.0, 0.0, 0.0)。

Methods

clone(result) → Cartesian3

复制此 Cartesian3 实例。

Name	Type	Description
result	Cartesian3	optional 存储结果的对象。

Returns:

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

equals(right) → Boolean

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

Name	Type	Description
right	Cartesian3	optional 右侧的Cartesian。

Returns:

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

equalsEpsilon(right, relativeEpsilon, absoluteEpsilon) → Boolean

将此Cartesian与提供的Cartesian分量进行比较，如果它们通过绝对或相对容差测试，则返回 true ，否则返回 false 。

Name	Type	Default	Description
right	Cartesian3		optional 右侧的Cartesian。
relativeEpsilon	Number		用于相等测试的相对 epsilon 容差。
absoluteEpsilon	Number	relativeEpsilon	optional 用于相等测试的绝对 epsilon 容差。

Returns:

如果它们在提供的 epsilon 内，则为 true ，否则为 false 。

toString()

将Cartesian坐标转换为字符串格式的(x, y, z)。

staticSuperMap3D.Cartesian3.abs(cartesian, result) → Cartesian3

计算提供的Cartesian坐标的绝对值。

Name	Type	Description
cartesian	Cartesian3	要计算其绝对值的Cartesian坐标。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.add(left, right, result) → Cartesian3

计算两个Cartesians的分量和。

Name	Type	Description
left	Cartesian3	第一个Cartesian。
right	Cartesian3	第二个Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.angleBetween(left, right) → Number

返回提供的Cartesians之间的角度（以弧度为单位）。

Name	Type	Description
left	Cartesian3	第一个 Cartesian。
right	Cartesian3	第二个 Cartesian。

Returns:

Cartesians之间的角度。

staticSuperMap3D.Cartesian3.clone(cartesian, result) → Cartesian3

复制一个Cartesian3实例。

Name	Type	Description
cartesian	Cartesian3	待复制对象。
result	Cartesian3	optional 存储结果的对象。

Returns:

经修改的结果参数，如果没有提供则返回一个新的Cartesian3实例。如果cartesian未定义，则返回undefined。

staticSuperMap3D.Cartesian3.cross(left, right, result) → Cartesian3

计算两个直角坐标系的交叉乘积。

Name	Type	Description
left	Cartesian3	第一个 Cartesian。
right	Cartesian3	第二个 Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

交叉乘积。

staticSuperMap3D.Cartesian3.distance(left, right) → Number

计算两点的距离。

Name	Type	Description
left	Cartesian3	用于计算距离的第一个点。
right	Cartesian3	用于计算距离的第二个点。

Returns:

两点间距离值。

Example:

// 计算两点的距离，返回1.0。
var d = SuperMap3D.Cartesian3.distance(new SuperMap3D.Cartesian3(1.0, 0.0, 0.0), new SuperMap3D.Cartesian3(2.0, 0.0, 0.0));

staticSuperMap3D.Cartesian3.distanceSquared(left, right) → Number

计算两点之间的平方距离。使用此函数比较距离的平方比使用Cartesian3#distance比较距离更有效。

Name	Type	Description
left	Cartesian3	计算距离的第一个点。
right	Cartesian3	计算距离的第二个点。

Returns:

两点之间的距离。

Example:

// Returns 4.0, not 2.0
var d = SuperMap3D.Cartesian3.distanceSquared(new SuperMap3D.Cartesian3(1.0, 0.0, 0.0), new SuperMap3D.Cartesian3(3.0, 0.0, 0.0));

staticSuperMap3D.Cartesian3.divideByScalar(cartesian, scalar, result) → Cartesian3

将提供的Cartesian分量除以提供的标量。

Name	Type	Description
cartesian	Cartesian3	被划分的 Cartesian。
scalar	Number	要除以的标量。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.divideComponents(left, right, result) → Cartesian3

计算两个Cartesians的分量商。

Name	Type	Description
left	Cartesian3	第一个Cartesian。
right	Cartesian3	第二个Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.dot(left, right) → Number

计算两个Cartesians的点（标量）积。

Name	Type	Description
left	Cartesian3	第一个Cartesian。
right	Cartesian3	第二个Cartesian。

Returns:

点积。

staticSuperMap3D.Cartesian3.equals(left, right) → Boolean

比较提供的Cartesian分量，如果相等则返回 true ，否则返回 false 。

Name	Type	Description
left	Cartesian3	optional 第一个 Cartesian。
right	Cartesian3	optional 第二个 Cartesian。

Returns:

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

staticSuperMap3D.Cartesian3.equalsEpsilon(left, right, relativeEpsilon, absoluteEpsilon) → Boolean

比较提供的Cartesian分量，如果它们通过绝对或相对容差测试，则返回 true ，否则返回 false 。

Name	Type	Default	Description
left	Cartesian3		optional 第一个 Cartesian。
right	Cartesian3		optional 第二个 Cartesian。
relativeEpsilon	Number		用于相等测试的相对 epsilon 容差。
absoluteEpsilon	Number	relativeEpsilon	optional 用于相等测试的绝对 epsilon 容差。

Returns:

在提供的 epsilon 内，则为 true，否则为 false 。

staticSuperMap3D.Cartesian3.fromArray(array, startingIndex, result) → Cartesian3

根据数组的三个连续元素创建Cartesian3实例。

Name	Type	Default	Description
array	Array.<Number>		数组对象，数组中的三个连续元素分别对应x、y、z分量。
startingIndex	Number	0	optional 第一个元素在数组中的偏移量，即数组的第"startingIndex+1"个元素对应x分量。
result	Cartesian3		optional 存储结果的对象。

Returns:

经修改的结果参数，如果没有提供则返回一个新的Cartesian3实例。

Example:

//创建Cartesian3实例(1.0, 2.0, 3.0)。
var v = [1.0, 2.0, 3.0];
var p = SuperMap3D.Cartesian3.fromArray(v);

// 创建Cartesian3实例(1.0, 2.0, 3.0)，指定偏移量为2，则第3个数据对应着x分量。
var v2 = [0.0, 0.0, 1.0, 2.0, 3.0];
var p2 = SuperMap3D.Cartesian3.fromArray(v2, 2);

staticSuperMap3D.Cartesian3.fromCartesian4(cartesian, result) → Cartesian3

根据已知的Cartesian4创建一个Cartesian3实例。将保留Cartesian4的x、y、z分量，舍去w分量。

Name	Type	Description
cartesian	Cartesian4	用于创建Cartesian3实例的Cartesian4对象。
result	Cartesian3	optional 存储结果的对象。

Returns:

经修改的结果参数，如果没有提供则返回一个新的Cartesian3实例。

staticSuperMap3D.Cartesian3.fromDegrees(longitude, latitude, height, ellipsoid, result) → Cartesian3

将以度为单位的经、纬度数值转换为Cartesian坐标。

Name	Type	Default	Description
longitude	Number		以度为单位的经度值。
latitude	Number		以度为单位的纬度值。
height	Number	0.0	optional 以米为单位的椭球高。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 椭球体。
result	Cartesian3		optional 存储结果的对象。

Returns:

转换后的位置坐标。

Example:

var position = SuperMap3D.Cartesian3.fromDegrees(-115.0, 37.0);

staticSuperMap3D.Cartesian3.fromDegreesArray(coordinates, ellipsoid, result) → Array.<Cartesian3>

给定一个以度为单位的经度和纬度值数组，返回一个Cartesian位置数组。

Name	Type	Default	Description
coordinates	Array.<Number>		经度和纬度值的列表。值交替[经度，纬度，经度，纬度...]。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 坐标所在的椭球体。
result	Array.<Cartesian3>		optional 要存储结果的 Cartesian3 对象数组。

Returns:

位置数组。

Example:

var positions = SuperMap3D.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);

staticSuperMap3D.Cartesian3.fromDegreesArrayHeights(coordinates, ellipsoid, result) → Array.<Cartesian3>

给定一个经度、纬度和高度值数组，其中经度和纬度以度为单位，返回一个Cartesian位置数组。

Name	Type	Default	Description
coordinates	Array.<Number>		经度、纬度和高度值的列表。值交替[经度，纬度，高度，经度，纬度，高度...]。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 位置所在的椭球体。
result	Array.<Cartesian3>		optional 要存储结果的 Cartesian3 对象数组。

Returns:

位置数组。

Example:

var positions = SuperMap3D.Cartesian3.fromDegreesArrayHeights([-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]);

staticSuperMap3D.Cartesian3.fromElements(x, y, z, result) → Cartesian3

根据x、y、z坐标创建Cartesian3实例。

Name	Type	Description
x	Number	x坐标。
y	Number	y坐标。
z	Number	z坐标。
result	Cartesian3	optional 存储结果的对象。

Returns:

经修改的结果参数，如果没有提供则返回一个新的Cartesian3实例。

staticSuperMap3D.Cartesian3.fromRadians(longitude, latitude, height, ellipsoid, result) → Cartesian3

将以弧度为单位的经、纬度数值转换为Cartesian坐标。

Name	Type	Default	Description
longitude	Number		以弧度为单位的经度值。
latitude	Number		以弧度为单位的纬度值。
height	Number	0.0	optional 以米为单位的椭球高。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 椭球体。
result	Cartesian3		optional 存储结果的对象。

Returns:

转换后的位置坐标。

Example:

var position = SuperMap3D.Cartesian3.fromRadians(-2.007, 0.645);

staticSuperMap3D.Cartesian3.fromRadiansArray(coordinates, ellipsoid, result) → Array.<Cartesian3>

在给定以弧度为单位的经度和纬度值数组的情况下，返回 Cartesian3 位置数组。

Name	Type	Default	Description
coordinates	Array.<Number>		经度和纬度值的列表。值交替[经度，纬度，经度，纬度...]。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 坐标所在的椭球体。
result	Array.<Cartesian3>		optional 要存储结果的 Cartesian3 对象数组。

Returns:

位置数组。

Example:

var positions = SuperMap3D.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);

staticSuperMap3D.Cartesian3.fromRadiansArrayHeights(coordinates, ellipsoid, result) → Array.<Cartesian3>

返回给定经度、纬度和高度值数组的Cartesian位置数组，其中经度和纬度以弧度为单位。

Name	Type	Default	Description
coordinates	Array.<Number>		经度、纬度和高度值的列表。值交替[经度，纬度，高度，经度，纬度，高度...]。
ellipsoid	Ellipsoid	Ellipsoid.WGS84	optional 位置所在的椭球体。
result	Array.<Cartesian3>		optional 要存储结果的 Cartesian3 对象数组。

Returns:

位置数组。

Example:

var positions = SuperMap3D.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);

staticSuperMap3D.Cartesian3.fromSpherical(spherical, result) → Cartesian3

将球面坐标转换为Cartesian坐标。

Name	Type	Description
spherical	Spherical	待转换的球面坐标。
result	Cartesian3	optional 存储结果的对象。

Returns:

经修改的结果参数，如果没有提供则返回一个新的Cartesian3实例。

staticSuperMap3D.Cartesian3.lerp(start, end, t, result) → Cartesian3

使用提供的Cartesian计算在 t 处的线性插值或外插。

Name	Type	Description
start	Cartesian3	在 0.0 时对应于 t 的值。
end	Cartesian3	在 1.0 时对应于 t 的值。
t	Number	沿 t 进行插值的点。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.magnitude(cartesian) → Number

计算Cartesian的大小（长度）。

Name	Type	Description
cartesian	Cartesian3	要计算其大小的cartesian实例。

Returns:

幅度。

staticSuperMap3D.Cartesian3.magnitudeSquared(cartesian) → Number

计算提供的cartesian平方幅度。

Name	Type	Description
cartesian	Cartesian3	要计算其平方幅度的cartesian实例。

Returns:

平方幅度。

staticSuperMap3D.Cartesian3.maximumByComponent(first, second, result) → Cartesian3

比较两个Cartesians并计算包含所提供Cartesian的最大分量的Cartesian。

Name	Type	Description
first	Cartesian3	第一个Cartesian坐标。
second	Cartesian3	第二个Cartesian坐标。
result	Cartesian3	存储结果的对象。

Returns:

具有最大分量的Cartesian坐标。

staticSuperMap3D.Cartesian3.maximumComponent(cartesian) → Number

计算提供的Cartesian坐标的最大分量的值。

Name	Type	Description
cartesian	Cartesian3	要使用的cartesian。

Returns:

最大分量的值。

staticSuperMap3D.Cartesian3.minimumByComponent(first, second, result) → Cartesian3

比较两个Cartesians并计算包含所提供Cartesian的最小分量的Cartesian。

Name	Type	Description
first	Cartesian3	第一个Cartesian。
second	Cartesian3	第二个Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

具有最少分量的Cartesian。

staticSuperMap3D.Cartesian3.minimumComponent(cartesian) → Number

计算提供的Cartesian坐标的最小分量的值。

Name	Type	Description
cartesian	Cartesian3	要使用的cartesian。

Returns:

最小分量的值。

staticSuperMap3D.Cartesian3.mostOrthogonalAxis(cartesian, result) → Cartesian3

返回与提供的Cartesian坐标最正交的轴。

Name	Type	Description
cartesian	Cartesian3	找到最正交轴的Cartesian坐标。
result	Cartesian3	存储结果的对象。

Returns:

最正交的轴。

staticSuperMap3D.Cartesian3.multiplyByScalar(cartesian, scalar, result) → Cartesian3

将提供的Cartesian分量乘以提供的标量。

Name	Type	Description
cartesian	Cartesian3	要缩放的Cartesian。
scalar	Number	要与之相乘的标量。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.multiplyComponents(left, right, result) → Cartesian3

计算两个Cartesian的分量乘积。

Name	Type	Description
left	Cartesian3	第一个Cartesian。
right	Cartesian3	第二个Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.negate(cartesian, result) → Cartesian3

否定所提供的Cartesian。

Name	Type	Description
cartesian	Cartesian3	要被否定的Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.normalize(cartesian, result) → Cartesian3

计算提供的Cartesian坐标的规范化形式。

Name	Type	Description
cartesian	Cartesian3	要规范化的Cartesian坐标。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

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

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

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

Returns:

被装入的数组。

staticSuperMap3D.Cartesian3.packArray(array, result) → Array.<Number>

将 Cartesian3 数组展平为组件数组。

Name	Type	Description
array	Array.<Cartesian3>	要打包的cartesians数组。
result	Array.<Number>	存储结果的数组。

Returns:

打包的数组。

staticSuperMap3D.Cartesian3.subtract(left, right, result) → Cartesian3

计算两个Cartesians的分量差。

Name	Type	Description
left	Cartesian3	第一个Cartesian。
right	Cartesian3	第二个Cartesian。
result	Cartesian3	存储结果的对象。

Returns:

修改后的结果参数。

staticSuperMap3D.Cartesian3.unpack(array, startingIndex, result) → Cartesian3

从打包数组中检索实例。

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

Returns:

如果没有提供新的Cartesian3实例，则使用修改后的结果参数。

staticSuperMap3D.Cartesian3.unpackArray(array, result) → Array.<Cartesian3>

将一组Cartesian分量解压缩为一组Cartesian3s。

Name	Type	Description
array	Array.<Number>	要解包的组件数组。
result	Array.<Cartesian3>	存储结果的数组。

Returns:

解压后的数组。