Cartesian3

new Cesium.Cartesian3 ( x , y , z )

一个 3D 笛卡尔点。
Name Type Default Description
x Number 0.0 可选 X 组件。
y Number 0.0 可选 Y 分量。
z Number 0.0 可选 Z 分量。
See:

Members

X 组件。
Default Value: 0.0
Y 分量。
Default Value: 0.0
Z 分量。
Default Value: 0.0

static constant Cesium.Cartesian3.ONE : Cartesian3

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

static Cesium.Cartesian3.packedLength : Number

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

static constant Cesium.Cartesian3.UNIT_X : Cartesian3

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

static constant Cesium.Cartesian3.UNIT_Y : Cartesian3

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

static constant Cesium.Cartesian3.UNIT_Z : Cartesian3

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

static constant Cesium.Cartesian3.ZERO : Cartesian3

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

Methods

复制此 Cartesian3 实例。
Name Type Description
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。

equals ( right ) Boolean

将此笛卡尔与提供的笛卡尔分量进行比较,如果它们相等则返回 true ,否则返回 false
Name Type Description
right Cartesian3 可选 右手边的笛卡尔。
Returns:
如果它们相等,则为 true ,否则为 false

equalsEpsilon ( right , relativeEpsilon , absoluteEpsilon ) Boolean

将此笛卡尔与提供的笛卡尔分量进行比较,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false
Name Type Default Description
right Cartesian3 可选 右手边的笛卡尔。
relativeEpsilon Number 0 可选 用于相等测试的相对 epsilon 容差。
absoluteEpsilon Number relativeEpsilon 可选 用于相等测试的绝对 epsilon 容差。
Returns:
如果它们在提供的 epsilon 内,则为 true ,否则为 false

toString () String

以'(x,y,z)'格式创建一个表示此笛卡尔坐标的字符串。
Returns:
以 '(x, y, z)' 格式表示此笛卡尔坐标的字符串。

static Cesium.Cartesian3.abs (cartesian, result) Cartesian3

计算提供的笛卡尔坐标的绝对值。
Name Type Description
cartesian Cartesian3 要计算其绝对值的笛卡尔坐标。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.add (left, right, result) Cartesian3

计算两个笛卡尔的分量和。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.angleBetween (left, right) Number

返回提供的笛卡尔之间的角度(以弧度为单位)。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
Returns:
笛卡尔之间的角度。

static Cesium.Cartesian3.clamp (cartesian, min, max, result) Cartesian3

将一个值限制在两个值之间。
Name Type Description
cartesian Cartesian3 要钳位的值。
min Cartesian3 最小界限。
max Cartesian3 最大界限。
result Cartesian3 存储结果的对象。
Returns:
钳制值,使得 min <= value <= max。

static Cesium.Cartesian3.clone (cartesian, result ) Cartesian3

复制 Cartesian3 实例。
Name Type Description
cartesian Cartesian3 要复制的笛卡尔坐标。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。 (如果笛卡尔未定义,则返回未定义)

static Cesium.Cartesian3.cross (left, right, result) Cartesian3

计算两个笛卡尔的叉(外)积。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
交叉产品。

static Cesium.Cartesian3.distance (left, right) Number

计算两点之间的距离。
Name Type Description
left Cartesian3 计算距离的第一个点。
right Cartesian3 计算距离的第二个点。
Returns:
两点之间的距离。
Example:
// Returns 1.0
const d = Cesium.Cartesian3.distance(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(2.0, 0.0, 0.0));

static Cesium.Cartesian3.distanceSquared (left, right) Number

计算两点之间的平方距离。使用此函数比较距离的平方比使用 Cartesian3#distance 比较距离更有效。
Name Type Description
left Cartesian3 计算距离的第一个点。
right Cartesian3 计算距离的第二个点。
Returns:
两点之间的距离。
Example:
// Returns 4.0, not 2.0
const d = Cesium.Cartesian3.distanceSquared(new Cesium.Cartesian3(1.0, 0.0, 0.0), new Cesium.Cartesian3(3.0, 0.0, 0.0));

static Cesium.Cartesian3.divideByScalar (cartesian, scalar, result) Cartesian3

将提供的笛卡尔分量除以提供的标量。
Name Type Description
cartesian Cartesian3 笛卡尔被划分。
scalar Number 要除以的标量。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.divideComponents (left, right, result) Cartesian3

计算两个笛卡尔的分量商。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.dot (left, right) Number

计算两个笛卡尔的点(标量)积。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
Returns:
点积。

static Cesium.Cartesian3.equals ( left , right ) Boolean

比较提供的笛卡尔分量,如果相等则返回 true ,否则返回 false
Name Type Description
left Cartesian3 可选 第一个笛卡尔。
right Cartesian3 可选 第二个笛卡尔。
Returns:
如果左右相等,则为 true ,否则为 false

static Cesium.Cartesian3.equalsEpsilon ( left , right , relativeEpsilon , absoluteEpsilon ) Boolean

比较提供的笛卡尔分量,如果它们通过绝对或相对容差测试,则返回 true ,否则返回 false
Name Type Default Description
left Cartesian3 可选 第一个笛卡尔。
right Cartesian3 可选 第二个笛卡尔。
relativeEpsilon Number 0 可选 用于相等测试的相对 epsilon 容差。
absoluteEpsilon Number relativeEpsilon 可选 用于相等测试的绝对 epsilon 容差。
Returns:
true left 和 right 在提供的 epsilon 内,则为 true,否则为 false

static Cesium.Cartesian3.fromArray (array, startingIndex , result ) Cartesian3

从数组中的三个连续元素创建 Cartesian3。
Name Type Default Description
array Array.<Number> 其三个连续元素分别对应于 x、y 和 z 分量的数组。
startingIndex Number 0 可选 第一个元素在数组中的偏移量,对应于 x 分量。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。
Example:
// Create a Cartesian3 with (1.0, 2.0, 3.0)
const v = [1.0, 2.0, 3.0];
const p = Cesium.Cartesian3.fromArray(v);

// Create a Cartesian3 with (1.0, 2.0, 3.0) using an offset into an array
const v2 = [0.0, 0.0, 1.0, 2.0, 3.0];
const p2 = Cesium.Cartesian3.fromArray(v2, 2);

static Cesium.Cartesian3.fromCartesian4 (cartesian, result ) Cartesian3

从现有的 Cartesian4 创建一个 Cartesian3 实例。这只是简单地采用笛卡尔4 的x、y 和z 属性并丢弃w。
Name Type Description
cartesian Cartesian4 要从中创建 Cartesian3 实例的 Cartesian4 实例。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。

static Cesium.Cartesian3.fromDegrees (longitude, latitude, height , ellipsoid , result ) Cartesian3

从以度为单位的经度和纬度值返回 Cartesian3 位置。
Name Type Default Description
longitude Number 经度,以度为单位
latitude Number 纬度,以度为单位
height Number 0.0 可选 椭圆体上方的高度,以米为单位。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭球体。
result Cartesian3 可选 存储结果的对象。
Returns:
职位
Example:
const position = Cesium.Cartesian3.fromDegrees(-115.0, 37.0);

static Cesium.Cartesian3.fromDegreesArray (coordinates, ellipsoid , result ) Array.< Cartesian3 >

给定一个以度为单位的经度和纬度值数组,返回一个笛卡尔位置数组。
Name Type Default Description
coordinates Array.<Number> 经度和纬度值的列表。值交替[经度,纬度,经度,纬度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 坐标所在的椭球体。
result Array.< Cartesian3 > 可选 要存储结果的 Cartesian3 对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromDegreesArray([-115.0, 37.0, -107.0, 33.0]);

static Cesium.Cartesian3.fromDegreesArrayHeights (coordinates, ellipsoid , result ) Array.< Cartesian3 >

给定一个经度、纬度和高度值数组,其中经度和纬度以度为单位,返回一个笛卡尔位置数组。
Name Type Default Description
coordinates Array.<Number> 经度、纬度和高度值的列表。值交替[经度,纬度,高度,经度,纬度,高度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭球体。
result Array.< Cartesian3 > 可选 要存储结果的 Cartesian3 对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromDegreesArrayHeights([-115.0, 37.0, 100000.0, -107.0, 33.0, 150000.0]);

static Cesium.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 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。

static Cesium.Cartesian3.fromRadians (longitude, latitude, height , ellipsoid , result ) Cartesian3

从以弧度给出的经度和纬度值返回 Cartesian3 位置。
Name Type Default Description
longitude Number 经度,以弧度为单位
latitude Number 纬度,以弧度为单位
height Number 0.0 可选 椭圆体上方的高度,以米为单位。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭球体。
result Cartesian3 可选 存储结果的对象。
Returns:
职位
Example:
const position = Cesium.Cartesian3.fromRadians(-2.007, 0.645);

static Cesium.Cartesian3.fromRadiansArray (coordinates, ellipsoid , result ) Array.< Cartesian3 >

在给定以弧度为单位的经度和纬度值数组的情况下,返回 Cartesian3 位置数组。
Name Type Default Description
coordinates Array.<Number> 经度和纬度值的列表。值交替[经度,纬度,经度,纬度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 坐标所在的椭球体。
result Array.< Cartesian3 > 可选 要存储结果的 Cartesian3 对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromRadiansArray([-2.007, 0.645, -1.867, .575]);

static Cesium.Cartesian3.fromRadiansArrayHeights (coordinates, ellipsoid , result ) Array.< Cartesian3 >

返回给定经度、纬度和高度值数组的笛卡尔位置数组,其中经度和纬度以弧度为单位。
Name Type Default Description
coordinates Array.<Number> 经度、纬度和高度值的列表。值交替[经度,纬度,高度,经度,纬度,高度...]。
ellipsoid Ellipsoid Ellipsoid.WGS84 可选 位置所在的椭球体。
result Array.< Cartesian3 > 可选 要存储结果的 Cartesian3 对象数组。
Returns:
位置数组。
Example:
const positions = Cesium.Cartesian3.fromRadiansArrayHeights([-2.007, 0.645, 100000.0, -1.867, .575, 150000.0]);

static Cesium.Cartesian3.fromSpherical (spherical, result ) Cartesian3

将提供的 Spherical 转换为 Cartesian3 坐标。
Name Type Description
spherical Spherical 要转换为 Cartesian3 的 Spherical。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。

static Cesium.Cartesian3.lerp (start, end, t, result) Cartesian3

使用提供的笛卡尔计算在 t 处的线性插值或外插。
Name Type Description
start Cartesian3 在 0.0 时对应于 t 的值。
end Cartesian3 在 1.0 时对应于 t 的值。
t Number 沿 t 进行插值的点。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.magnitude (cartesian) Number

计算笛卡尔的大小(长度)。
Name Type Description
cartesian Cartesian3 要计算其大小的笛卡尔实例。
Returns:
幅度。

static Cesium.Cartesian3.magnitudeSquared (cartesian) Number

计算提供的笛卡尔平方幅度。
Name Type Description
cartesian Cartesian3 要计算其平方幅度的笛卡尔实例。
Returns:
平方幅度。

static Cesium.Cartesian3.maximumByComponent (first, second, result) Cartesian3

比较两个笛卡尔并计算包含所提供笛卡尔的最大分量的笛卡尔。
Name Type Description
first Cartesian3 一个笛卡尔比较。
second Cartesian3 一个笛卡尔比较。
result Cartesian3 存储结果的对象。
Returns:
具有最大分量的笛卡尔。

static Cesium.Cartesian3.maximumComponent (cartesian) Number

计算提供的笛卡尔坐标的最大分量的值。
Name Type Description
cartesian Cartesian3 要使用的笛卡尔。
Returns:
最大分量的值。

static Cesium.Cartesian3.midpoint (left, right, result) Cartesian3

计算左右笛卡尔之间的中点。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
中点。

static Cesium.Cartesian3.minimumByComponent (first, second, result) Cartesian3

比较两个笛卡尔并计算包含所提供笛卡尔的最小分量的笛卡尔。
Name Type Description
first Cartesian3 一个笛卡尔比较。
second Cartesian3 一个笛卡尔比较。
result Cartesian3 存储结果的对象。
Returns:
具有最少分量的笛卡尔坐标。

static Cesium.Cartesian3.minimumComponent (cartesian) Number

计算提供的笛卡尔坐标的最小分量的值。
Name Type Description
cartesian Cartesian3 要使用的笛卡尔。
Returns:
最小分量的值。

static Cesium.Cartesian3.mostOrthogonalAxis (cartesian, result) Cartesian3

返回与提供的笛卡尔坐标最正交的轴。
Name Type Description
cartesian Cartesian3 找到最正交轴的笛卡尔坐标。
result Cartesian3 存储结果的对象。
Returns:
最正交的轴。

static Cesium.Cartesian3.multiplyByScalar (cartesian, scalar, result) Cartesian3

将提供的笛卡尔分量乘以提供的标量。
Name Type Description
cartesian Cartesian3 要缩放的笛卡尔坐标。
scalar Number 要与之相乘的标量。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.multiplyComponents (left, right, result) Cartesian3

计算两个笛卡尔的分量乘积。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.negate (cartesian, result) Cartesian3

否定提供的笛卡尔坐标。
Name Type Description
cartesian Cartesian3 笛卡尔被否定。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.normalize (cartesian, result) Cartesian3

计算提供的笛卡尔坐标的规范化形式。
Name Type Description
cartesian Cartesian3 要归一化的笛卡尔坐标。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.pack (value, array, startingIndex ) Array.<Number>

将提供的实例存储到提供的数组中。
Name Type Default Description
value Cartesian3 要打包的值。
array Array.<Number> 要打包的数组。
startingIndex Number 0 可选 开始打包元素的数组索引。
Returns:
装入的数组

static Cesium.Cartesian3.packArray (array, result ) Array.<Number>

将 Cartesian3 数组展平为组件数组。
Name Type Description
array Array.< Cartesian3 > 要打包的笛卡尔数组。
result Array.<Number> 可选 存储结果的数组。如果这是一个类型化数组,它必须有 array.length * 3 个组件,否则会抛出 DeveloperError 。如果它是一个常规数组,它将被调整大小以具有 (array.length * 3) 个元素。
Returns:
打包的数组。

static Cesium.Cartesian3.projectVector (a, b, result) Cartesian3

将向量 a 投影到向量 b
Name Type Description
a Cartesian3 需要投影的向量
b Cartesian3 投影到的向量
result Cartesian3 结果笛卡尔
Returns:
修改后的结果参数

static Cesium.Cartesian3.subtract (left, right, result) Cartesian3

计算两个笛卡尔的分量差。
Name Type Description
left Cartesian3 第一个笛卡尔。
right Cartesian3 第二个笛卡尔。
result Cartesian3 存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Cartesian3.unpack (array, startingIndex , result ) Cartesian3

从打包数组中检索实例。
Name Type Default Description
array Array.<Number> 打包的数组。
startingIndex Number 0 可选 要解包的元素的起始索引。
result Cartesian3 可选 存储结果的对象。
Returns:
修改后的结果参数或新的 Cartesian3 实例(如果未提供)。

static Cesium.Cartesian3.unpackArray (array, result ) Array.< Cartesian3 >

将一组笛卡尔分量解压缩为一组笛卡尔3。
Name Type Description
array Array.<Number> 要解包的组件数组。
result Array.< Cartesian3 > 可选 存储结果的数组。
Returns:
解压后的数组。