Cartesian3

Cartesian3是CesiumJS中一个向量类，用于表示三维空间中的坐标。

构造函数

new Cartesian3(x, y, z);

• x : Number，向量的x坐标。
• y : Number，向量的y坐标。
• z : Number，向量的z坐标。

静态方法

fromArray(array, startingIndex, result)

从数组中创建一个3D向量。

• array : 数组，包含要解析的Cartesian3元素。
• startingIndex : Number，数组中的初始化索引。 default: 0
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

fromElements(x, y, z, result)

使用x，y，z值创建3D向量。

• x : Number，向量的x坐标。
• y : Number，向量的y坐标。
• z : Number，向量的z坐标。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

add(left, right, result)

计算两个3D向量的和。

• left : Cartesian3，左操作数。
• right : Cartesian3，右操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

clone(cartesian, result)

复制传入的Cartesian3对象。

• cartesian : Cartesian3，要复制的对象。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

distance(left, right)

计算两个3D向量之间的距离。

• left : Cartesian3，左操作数。
• right : Cartesian3，右操作数。

dot(left, right)

计算两个3D向量的点积。

• left : Cartesian3，左操作数。
• right : Cartesian3，右操作数。

magnitude(vector)

计算3D向量的模。

• vector : Cartesian3，操作数。

normalize(vector, result)

将3D向量规格化。

• vector : Cartesian3，操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

subtract(left, right, result)

计算两个3D向量的差。

• left : Cartesian3，左操作数。
• right : Cartesian3，右操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

属性

x

向量的x坐标。

y

向量的y坐标。

z

向量的z坐标。

方法

clone(result)

返回此向量的副本。

• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

equals(right, relativeTolerance)

比较两个3D向量是否相等。

• right : Cartesian3，要进行相等判断的3D向量。
• relativeTolerance : Number，自定义浮点误差的相对容差值。 default: Cesium.Math.EPSILON15

toString()

返回一个字符串，表示此向量的所有坐标。

add(right, result)

计算此向量和另一个3D向量的和。

• right : Cartesian3，右操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

subtract(right, result)

计算此向量和另一个3D向量的差。

• right : Cartesian3，右操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

multiplyByScalar(scalar, result)

将此向量缩放一个标量值。

• scalar : Number，缩放值。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

divideByScalar(scalar, result)

将此向量除以一个标量值。

• scalar : Number，除数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

negate(result)

将此向量的每个坐标取反。

• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

dot(right)

计算此向量和另一个3D向量的点积。

• right : Cartesian3，右操作数。

cross(right, result)

计算此向量和另一个3D向量的叉积。

• right : Cartesian3，右操作数。
• result : Cartesian3，可选参数，指定计算结果的变量，避免创建新的实例对象。如果不设置此参数，则会创建一个新的Cartesian3对象。

mostOrthogonalAxis()

返回最接近此向量的两条坐标轴（x、y或z）中的一条。

equalsEpsilon(right, epsilon)

比较两个3D向量是否相等。

• right : Cartesian3，要进行相等判断的3D向量。
• epsilon : Number，自定义浮点误差的值。 default: Cesium.Math.EPSILON15