Quaternion

new Cesium.Quaternion(x, y, z, w)
engine/Source/Core/Quaternion.js 21

一组 4 维坐标，用于表示 3 维空间中的旋转。
Name Type Default Description
x number 0.0 optional X分量。
y number 0.0 optional Y分量。
z number 0.0 optional Z分量。
w number 0.0 optional W分量。
See:

Members

static constant Cesium.Quaternion.IDENTITY : Quaternion
engine/Source/Core/Quaternion.js 1102

初始化Quaternion实例为 (0.0, 0.0, 0.0, 1.0).

static Cesium.Quaternion.packedInterpolationLength : number
engine/Source/Core/Quaternion.js 281

用于将对象以可插值形式存储到数组中的元素数。

static Cesium.Quaternion.packedLength : number
engine/Source/Core/Quaternion.js 225

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

static constant Cesium.Quaternion.ZERO : Quaternion
engine/Source/Core/Quaternion.js 1094

初始化Quaternion实例为 (0.0, 0.0, 0.0, 0.0).

w : number
engine/Source/Core/Quaternion.js 48

W分量。
Default Value: 0.0

x : number
engine/Source/Core/Quaternion.js 27

X分量。
Default Value: 0.0

y : number
engine/Source/Core/Quaternion.js 34

Y分量。
Default Value: 0.0

z : number
engine/Source/Core/Quaternion.js 41

Z分量。
Default Value: 0.0

Methods

static Cesium.Quaternion.add(left, right, result) → Quaternion
engine/Source/Core/Quaternion.js 511

计算两个四元数的分量和。
Name Type Description
left Quaternion 第一个四元数。
right Quaternion 第二个四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.clone(quaternion, result) → Quaternion
engine/Source/Core/Quaternion.js 391

复制Quaternion 实例。
Name Type Description
quaternion Quaternion 要复制的四元数。
result Quaternion optional 要在其上存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。(如果未定义四元数，则返回 undefined)

static Cesium.Quaternion.computeAngle(quaternion) → number
engine/Source/Core/Quaternion.js 703

计算提供的四元数的旋转角度。
Name Type Description
quaternion Quaternion 要使用的四元数。
Returns:
旋转角度。

static Cesium.Quaternion.computeAxis(quaternion, result) → Cartesian3
engine/Source/Core/Quaternion.js 673

计算提供的四元数的旋转轴。
Name Type Description
quaternion Quaternion 要使用的四元数。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.computeInnerQuadrangle(q0, q1, q2, result) → Quaternion
engine/Source/Core/Quaternion.js 858

计算内部四边形点。

这将计算确保小队曲线为 C1 的四元数。

Name Type Description
q0 Quaternion 第一个四元数。
q1 Quaternion 第二个四元数。
q2 Quaternion 第三个四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。
See:
  • Quaternion#squad

static Cesium.Quaternion.conjugate(quaternion, result) → Quaternion
engine/Source/Core/Quaternion.js 419

计算提供的四元数的共轭。
Name Type Description
quaternion Quaternion 要共轭的四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.convertPackedArrayForInterpolation(packedArray, startingIndex, lastIndex, result)
engine/Source/Core/Quaternion.js 291

将打包数组转换为适合插值的形式。
Name Type Default Description
packedArray Array.<number> 打包数组。
startingIndex number 0 optional 要转换的第一个元素的索引。
lastIndex number packedArray.length optional 最后一个要转换的元素的索引。
result Array.<number> optional 要在其中存储结果的对象。

static Cesium.Quaternion.divideByScalar(quaternion, scalar, result) → Quaternion
engine/Source/Core/Quaternion.js 652

将提供的四元数分量除以提供的标量。
Name Type Description
quaternion Quaternion 要划分的四元数。
scalar number 要除以的标量。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.dot(left, right) → number
engine/Source/Core/Quaternion.js 574

计算两个四元数的点(标量)积。
Name Type Description
left Quaternion 第一个四元数。
right Quaternion 第二个四元数。
Returns:
点积。

static Cesium.Quaternion.equals(left, right) → boolean
engine/Source/Core/Quaternion.js 1052

对提供的四元数进行组件比较，并返回 true，否则为false。
Name Type Description
left Quaternion optional 第一个quaternion.
right Quaternion optional 第二个 quaternion.
Returns:
true如果左和右相等，否则false。

static Cesium.Quaternion.equalsEpsilon(left, right, epsilon) → boolean
engine/Source/Core/Quaternion.js 1074

对提供的四元数进行组件比较，并返回 true，如果它们位于提供的 epsilon 内， 否则false 。
Name Type Default Description
left Quaternion optional 第一个quaternion.
right Quaternion optional 第二个 quaternion.
epsilon number 0 optional 用来检验等式。
Returns:
true如果左和右在提供的epsilon内，否则 false。

static Cesium.Quaternion.exp(cartesian, result) → Quaternion
engine/Source/Core/Quaternion.js 820

指数四元数函数。
Name Type Description
cartesian Cartesian3 笛卡尔。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.fastSlerp(start, end, t, result) → Quaternion
engine/Source/Core/Quaternion.js 950

使用提供的四元数计算球面线性插值或 t 处的外插。 此实现比 Quaternion#slerp 更快，但仅在 10-6 以下精确。
Name Type Description
start Quaternion 对应于t在0.0处的值。
end Quaternion 对应于1.0时t的值。
t number 沿着t进行插值的点。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。
See:
  • Quaternion#slerp

static Cesium.Quaternion.fastSquad(q0, q1, s0, s1, t, result) → Quaternion
engine/Source/Core/Quaternion.js 1029

计算四元数之间的球形四边形插值。 比 Quaternion#squad 更快的实现，但准确性较低。
Name Type Description
q0 Quaternion 第一个四元数。
q1 Quaternion 第二个四元数。
s0 Quaternion 第一个内部四边形。
s1 Quaternion 第二个内四边形。
t number [0,1] 中用于插值的时间。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数或者如果未提供任何实例，则为新实例。
See:
  • Quaternion#squad

static Cesium.Quaternion.fromAxisAngle(axis, angle, result) → Quaternion
engine/Source/Core/Quaternion.js 61

计算表示绕轴旋转的四元数。
Name Type Description
axis Cartesian3 旋转轴。
angle number 绕轴旋转的弧度角度。
result Quaternion optional 要在其上存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。

static Cesium.Quaternion.fromHeadingPitchRoll(headingPitchRoll, result) → Quaternion
engine/Source/Core/Quaternion.js 187

根据给定的航向角、俯仰角和横滚角计算旋转。heading 是围绕 负 Z 轴。Pitch 是绕负 y 轴的旋转。Roll 是旋转 正 x 轴。
Name Type Description
headingPitchRoll HeadingPitchRoll 以航向、俯仰和滚动表示的旋转。
result Quaternion optional 要在其上存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。

static Cesium.Quaternion.fromRotationMatrix(matrix, result) → Quaternion
engine/Source/Core/Quaternion.js 96

从提供的 Matrix3 实例计算四元数。
Name Type Description
matrix Matrix3 旋转矩阵。
result Quaternion optional 要在其上存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。
See:

static Cesium.Quaternion.inverse(quaternion, result) → Quaternion
engine/Source/Core/Quaternion.js 493

计算提供的四元数的倒数。
Name Type Description
quaternion Quaternion 要归一化的四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.lerp(start, end, t, result) → Quaternion
engine/Source/Core/Quaternion.js 724

使用提供的四元数计算 t 处的线性插值或外插。
Name Type Description
start Quaternion 对应于t在0.0处的值。
end Quaternion 对应于1.0时t的值。
t number 沿着t进行插值的点。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.log(quaternion, result) → Cartesian3
engine/Source/Core/Quaternion.js 797

对数四元数函数。
Name Type Description
quaternion Quaternion 单位四元数。
result Cartesian3 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.magnitude(quaternion) → number
engine/Source/Core/Quaternion.js 457

计算提供的四元数的大小。
Name Type Description
quaternion Quaternion 要共轭的四元数。
Returns:
的大小。

static Cesium.Quaternion.magnitudeSquared(quaternion) → number
engine/Source/Core/Quaternion.js 438

计算提供的四元数的量级平方。
Name Type Description
quaternion Quaternion 要共轭的四元数。
Returns:
大小的平方。

static Cesium.Quaternion.multiply(left, right, result) → Quaternion
engine/Source/Core/Quaternion.js 593

计算两个四元数的乘积。
Name Type Description
left Quaternion 第一个四元数。
right Quaternion 第二个四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.multiplyByScalar(quaternion, scalar, result) → Quaternion
engine/Source/Core/Quaternion.js 630

将提供的四元数分量乘以提供的标量。
Name Type Description
quaternion Quaternion 要缩放的四元数。
scalar number 与之相乘的标量。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.negate(quaternion, result) → Quaternion
engine/Source/Core/Quaternion.js 554

对提供的四元数求反。
Name Type Description
quaternion Quaternion 要取反的四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.normalize(quaternion, result) → Quaternion
engine/Source/Core/Quaternion.js 468

计算提供的四元数的规范化形式。
Name Type Description
quaternion Quaternion 要归一化的四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.pack(value, array, startingIndex) → Array.<number>
engine/Source/Core/Quaternion.js 236

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

static Cesium.Quaternion.slerp(start, end, t, result) → Quaternion
engine/Source/Core/Quaternion.js 751

使用提供的四元数计算球面线性插值或 t 处的外插。
Name Type Description
start Quaternion 对应于t在0.0处的值。
end Quaternion 对应于1.0时t的值。
t number 沿着t进行插值的点。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。
See:
  • Quaternion#fastSlerp

static Cesium.Quaternion.squad(q0, q1, s0, s1, t, result) → Quaternion
engine/Source/Core/Quaternion.js 905

计算四元数之间的球形四边形插值。
Name Type Description
q0 Quaternion 第一个四元数。
q1 Quaternion 第二个四元数。
s0 Quaternion 第一个内部四边形。
s1 Quaternion 第二个内四边形。
t number [0,1] 中用于插值的时间。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。
Example:
// 1. compute the squad interpolation between two quaternions on a curve
const s0 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[i - 1], quaternions[i], quaternions[i + 1], new Cesium.Quaternion());
const s1 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[i], quaternions[i + 1], quaternions[i + 2], new Cesium.Quaternion());
const q = Cesium.Quaternion.squad(quaternions[i], quaternions[i + 1], s0, s1, t, new Cesium.Quaternion());

// 2. compute the squad interpolation as above but where the first quaternion is a end point.
const s1 = Cesium.Quaternion.computeInnerQuadrangle(quaternions[0], quaternions[1], quaternions[2], new Cesium.Quaternion());
const q = Cesium.Quaternion.squad(quaternions[0], quaternions[1], quaternions[0], s1, t, new Cesium.Quaternion());
See:
  • Quaternion#computeInnerQuadrangle

static Cesium.Quaternion.subtract(left, right, result) → Quaternion
engine/Source/Core/Quaternion.js 533

计算两个四元数的分量差。
Name Type Description
left Quaternion 第一个四元数。
right Quaternion 第二个四元数。
result Quaternion 要在其上存储结果的对象。
Returns:
修改后的结果参数。

static Cesium.Quaternion.unpack(array, startingIndex, result) → Quaternion
engine/Source/Core/Quaternion.js 260

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

static Cesium.Quaternion.unpackInterpolationResult(array, sourceArray, firstIndex, lastIndex, result) → Quaternion
engine/Source/Core/Quaternion.js 352

从使用 convertPackedArrayForInterpolation 转换的打包数组中检索实例。
Name Type Default Description
array Array.<number> 先前打包用于插值的数组。
sourceArray Array.<number> 原始打包数组。
firstIndex number 0 optional 用于转换数组的 firstIndex。
lastIndex number packedArray.length optional 用于转换数组的 lastIndex。
result Quaternion optional 要在其中存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。

clone(result) → Quaternion
engine/Source/Core/Quaternion.js 1110

复制Quaternion实例。
Name Type Description
result Quaternion optional 要在其上存储结果的对象。
Returns:
修改后的结果参数或者新的 Quaternion 实例(如果未提供)。

equals(right) → boolean
engine/Source/Core/Quaternion.js 1121

将此函数与提供的四元数组件进行比较，并返回 true，否则为false。
Name Type Description
right Quaternion optional 右边 quaternion.
Returns:
true如果左和右相等，否则false。

equalsEpsilon(right, epsilon) → boolean
engine/Source/Core/Quaternion.js 1134

将此函数与提供的四元数组件进行比较，并返回 true如果它们位于提供的 epsilon 内， 否则false 。
Name Type Default Description
right Quaternion optional 右边 quaternion.
epsilon number 0 optional 用来检验等式。
Returns:
true如果左和右在提供的epsilon内，否则 false。

toString() → string
engine/Source/Core/Quaternion.js 1143

返回一个字符串，格式为 (x, y, z, w) 表示此四元数。
Returns:
表示此四元数的字符串。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.
packages/engine
packages/widgets