三维笛卡尔坐标点。
Name | Type | Default | Description |
---|---|---|---|
x |
Number |
0.0
|
optional X分量。 |
y |
Number |
0.0
|
optional Y分量。 |
z |
Number |
0.0
|
optional Z分量。 |
See:
Members
-
X分量。
-
Default Value:
0.0
-
Y分量。
-
Default Value:
0.0
-
Z分量。
-
Default Value:
0.0
-
用于将对象打包到数组中的元素数量。
-
staticconstantSuperMap3D.Cartesian3.UNIT_X : Cartesian3
-
初始化为(1.0,0.0,0.0)的不可变Cartesian3实例。
-
staticconstantSuperMap3D.Cartesian3.UNIT_Y : Cartesian3
-
初始化为(0.0,1.0,0.0)的不可变Cartesian3实例。
-
staticconstantSuperMap3D.Cartesian3.UNIT_Z : Cartesian3
-
初始化为(0.0,0.0,1.0)的不可变Cartesian3实例。
-
staticconstantSuperMap3D.Cartesian3.ZERO : Cartesian3
-
初始化为(0.0,0.0,0.0)的不可变Cartesian3实例。
Methods
-
clone(result) → Cartesian3
-
复制这个笛卡尔实例。
Name Type Description result
Cartesian3 optional 要在其上存储结果的对象。 Returns:
如果没有提供新的Cartesian3实例,则使用修改后的结果参数。 -
将此笛卡尔与提供的笛卡尔分量进行比较并返回,相等则为
true
,否则为false。Name Type Description right
Cartesian3 optional 右手的笛卡尔坐标。 Returns:
如果它们相等,则为true
, 否则为false
。 -
将此笛卡尔与提供的笛卡尔分量进行比较,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false 。
Name Type Default Description right
Cartesian3 optional 右手的笛卡尔坐标。 relativeEpsilon
Number 用于相等测试的相对 epsilon 容差。 absoluteEpsilon
Number relativeEpsilon
optional 用于相等测试的绝对 epsilon 容差。 Returns:
如果它们在提供的 epsilon 内,则为 true ,否则为 false 。 -
将笛卡尔坐标转换为字符串格式的(x, y, z)。
-
staticSuperMap3D.Cartesian3.abs(cartesian, result) → Cartesian3
-
计算提供的笛卡尔坐标的绝对值。
Name Type Description cartesian
Cartesian3 要计算其绝对值的笛卡尔坐标。 result
Cartesian3 存储结果的对象。 Returns:
修改后的结果参数。 -
staticSuperMap3D.Cartesian3.add(left, right, result) → Cartesian3
-
计算两个笛卡尔的分量和。
Name Type Description left
Cartesian3 第一个笛卡尔。 right
Cartesian3 第二个笛卡尔。 result
Cartesian3 存储结果的对象。 Returns:
修改后的结果参数。 -
返回提供的笛卡尔之间的角度(以弧度为单位)。
Name Type Description left
Cartesian3 第一个笛卡尔。 right
Cartesian3 第二个笛卡尔。 Returns:
笛卡尔之间的角度。 -
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 第一个笛卡尔。 right
Cartesian3 第二个笛卡尔。 result
Cartesian3 存储结果的对象。 Returns:
交叉积。 -
计算两点的距离。
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));
-
计算两点之间的平方距离。使用此函数比较距离的平方比使用 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
-
将提供的笛卡尔分量除以提供的标量。
Name Type Description cartesian
Cartesian3 要划分的笛卡尔坐标。 scalar
Number 要除以的标量。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
staticSuperMap3D.Cartesian3.divideComponents(left, right, result) → Cartesian3
-
计算两个笛卡尔的分量商。
Name Type Description left
Cartesian3 第一个笛卡尔。 right
Cartesian3 第二个笛卡尔。 result
Cartesian3 存储结果的对象。 Returns:
修改后的结果参数。 -
计算两个笛卡尔的点(标量)积。
Name Type Description left
Cartesian3 第一个笛卡尔。 right
Cartesian3 第二个笛卡尔。 Returns:
点积。 -
比较提供的笛卡尔分量,如果相等则返回 true ,否则返回 false 。
Name Type Description left
Cartesian3 optional 第一个笛卡尔。 right
Cartesian3 optional 第二个笛卡尔。 Returns:
如果左右相等,则为 true ,否则为 false 。 -
比较提供的笛卡尔分量,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false 。
Name Type Default Description left
Cartesian3 optional 第一个笛卡尔。 right
Cartesian3 optional 第二个笛卡尔。 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
-
将以度为单位的经、纬度数值转换为笛卡尔坐标。
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>
-
返回笛卡尔位置数组,给定经度和纬度值数组,以度表示。
Name Type Default Description coordinates
Array.<Number> 经度和纬度值的列表。值替代[经度,纬度,经度,纬度…]。 ellipsoid
Ellipsoid Ellipsoid.WGS84
optional 坐标所在的椭球体。 result
Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。 Returns:
位置数组。Example:
var positions = SuperMap3D.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);
-
staticSuperMap3D.Cartesian3.fromDegreesArrayHeights(coordinates, ellipsoid, result) → Array.<Cartesian3>
-
返回一个笛卡尔位置数组,给定经度、纬度和高度值数组,其中经度和纬度以度数表示。
Name Type Default Description coordinates
Array.<Number> 经度、纬度和高度值的列表。值交替[经度,纬度,高度,经度,纬度,高度…]。 ellipsoid
Ellipsoid Ellipsoid.WGS84
optional 位置所在的椭球体。 result
Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。 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
-
将以弧度为单位的经、纬度数值转换为笛卡尔坐标。
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>
-
返回一个笛卡尔位置数组,给定以弧度表示的经度和纬度值数组。
Name Type Default Description coordinates
Array.<Number> 经度和纬度值的列表。值替代[经度,纬度,经度,纬度…]。 ellipsoid
Ellipsoid Ellipsoid.WGS84
optional 坐标所在的椭球体。 result
Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。 Returns:
位置数组。Example:
var positions = SuperMap3D.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);
-
staticSuperMap3D.Cartesian3.fromRadiansArrayHeights(coordinates, ellipsoid, result) → Array.<Cartesian3>
-
返回一个笛卡尔位置数组,给定经度、纬度和高度值数组,其中经度和纬度以弧度表示。
Name Type Default Description coordinates
Array.<Number> 经度、纬度和高度值的列表。值交替[经度,纬度,高度,经度,纬度,高度…]。 ellipsoid
Ellipsoid Ellipsoid.WGS84
optional 位置所在的椭球体。 result
Array.<Cartesian3> optional 存储结果的笛卡尔对象数组。 Returns:
位置数组。Example:
var positions = SuperMap3D.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);
-
staticSuperMap3D.Cartesian3.fromSpherical(spherical, result) → Cartesian3
-
将球面坐标转换为笛卡尔坐标。
Name Type Description spherical
Spherical 待转换的球面坐标。 result
Cartesian3 optional 存储结果的对象。 Returns:
经修改的结果参数,如果没有提供则返回一个新的Cartesian3实例。 -
staticSuperMap3D.Cartesian3.lerp(start, end, t, result) → Cartesian3
-
使用提供的笛卡儿计算t处的线性插值或外推。
Name Type Description start
Cartesian3 对应于t在0.0处的值。 end
Cartesian3 对应于1.0时t的值。 t
Number 沿着t进行插值的点。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
计算笛卡尔的大小(长度)。
Name Type Description cartesian
Cartesian3 要计算其大小的笛卡尔实例。 Returns:
大小。 -
计算给定的笛卡尔坐标的平方幅度。
Name Type Description cartesian
Cartesian3 要计算其模的平方的笛卡尔实例。 Returns:
大小的平方。 -
staticSuperMap3D.Cartesian3.maximumByComponent(first, second, result) → Cartesian3
-
比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最大分量的笛卡尔坐标。
Name Type Description first
Cartesian3 用笛卡尔坐标来比较。 second
Cartesian3 用笛卡尔坐标来比较。 result
Cartesian3 要在其中存储结果的对象。 Returns:
一个有最大分量的笛卡尔坐标。 -
计算所提供的笛卡尔坐标的最大分量的值。
Name Type Description cartesian
Cartesian3 用笛卡尔坐标。 Returns:
最大分量的值。 -
staticSuperMap3D.Cartesian3.minimumByComponent(first, second, result) → Cartesian3
-
比较两个笛卡尔坐标并计算一个包含所提供笛卡尔坐标的最小分量的笛卡尔坐标。
Name Type Description first
Cartesian3 用笛卡尔坐标来比较。 second
Cartesian3 用笛卡尔坐标来比较。 result
Cartesian3 要在其中存储结果的对象。 Returns:
具有最小分量的笛卡尔曲线。 -
为所提供的笛卡尔坐标计算最小分量的值。
Name Type Description cartesian
Cartesian3 用笛卡尔坐标。 Returns:
最小分量的值。 -
staticSuperMap3D.Cartesian3.mostOrthogonalAxis(cartesian, result) → Cartesian3
-
返回与所提供的笛卡尔坐标最正交的轴。
Name Type Description cartesian
Cartesian3 在笛卡尔坐标系上找到最正交的轴。 result
Cartesian3 要在其上存储结果的对象。 Returns:
最正交的轴。 -
staticSuperMap3D.Cartesian3.multiplyByScalar(cartesian, scalar, result) → Cartesian3
-
将所提供的笛卡尔分量与所提供的标量相乘。
Name Type Description cartesian
Cartesian3 要缩放的笛卡尔坐标。 scalar
Number 与之相乘的标量。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
staticSuperMap3D.Cartesian3.multiplyComponents(left, right, result) → Cartesian3
-
计算两个笛卡尔坐标的分量积。
Name Type Description left
Cartesian3 第一个笛卡尔坐标系。 right
Cartesian3 第二个笛卡尔坐标系。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
staticSuperMap3D.Cartesian3.negate(cartesian, result) → Cartesian3
-
否定提供的笛卡尔坐标。
Name Type Description cartesian
Cartesian3 笛卡尔坐标被否定了。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
staticSuperMap3D.Cartesian3.normalize(cartesian, result) → Cartesian3
-
计算提供的笛卡尔坐标的规范化形式。
Name Type Description cartesian
Cartesian3 笛卡尔坐标被归一化。 result
Cartesian3 要在其上存储结果的对象。 Returns:
修改后的结果参数。 -
将提供的实例存储到提供的数组中。
Name Type Default Description value
Cartesian3 要打包的值。 array
Array.<Number> 要装入的数组。 startingIndex
Number 0
optional 开始打包元素的数组的索引。 Returns:
被装入的数组。 -
将 Cartesian3s的数组平展为一个分量数组。
Name Type Description array
Array.<Cartesian3> 要打包的Cartesian数组。 result
Array.<Number> 要在其中存储结果的数组。 Returns:
打包数组。 -
staticSuperMap3D.Cartesian3.subtract(left, right, result) → Cartesian3
-
计算两个笛卡尔坐标的分量差。
Name Type Description left
Cartesian3 第一个笛卡尔坐标系。 right
Cartesian3 第二个笛卡尔坐标系。 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>
-
将一个笛卡尔分量数组解包为一个Cartesian3s数组。
Name Type Description array
Array.<Number> 要解包的组件数组。 result
Array.<Cartesian3> 要在其中存储结果的数组。 Returns:
未打包的数组。