Quat 类型

继承于 ValueType

模块: cc 父模块: cc

表示 2D 向量和坐标

索引

属性（properties）

• x Number
• y Number
• z Number
• w Number

方法

• constructor 构造函数，可查看 cc.quat
• mul 计算四元数乘积的结果
• clone 获得指定四元数的拷贝
• copy 复制目标四元数
• set 设置四元数值
• identity 将目标赋值为单位四元数
• rotationTo 设置四元数为两向量间的最短路径旋转，默认两向量都已归一化
• getAxisAngle 获取四元数的旋转轴和旋转弧度
• multiply 四元数乘法
• multiplyScalar 四元数标量乘法
• scaleAndAdd 四元数乘加：A + B * scale
• rotateX 绕 X 轴旋转指定四元数
• rotateY 绕 Y 轴旋转指定四元数
• rotateZ 绕 Z 轴旋转指定四元数
• rotateAround 绕世界空间下指定轴旋转四元数
• rotateAroundLocal 绕本地空间下指定轴旋转四元数
• calculateW 根据 xyz 分量计算 w 分量，默认已归一化
• dot 四元数点积（数量积）
• lerp 逐元素线性插值： A + t * (B - A)
• sqlerp 带两个控制点的四元数球面插值
• invert 四元数求逆
• conjugate 求共轭四元数，对单位四元数与求逆等价，但更高效
• len 求四元数长度
• lengthSqr 求四元数长度平方
• normalize 归一化四元数
• fromAxes 根据本地坐标轴朝向计算四元数，默认三向量都已归一化且相互垂直
• fromViewUp 根据视口的前方向和上方向计算四元数
• fromAxisAngle 根据旋转轴和旋转弧度计算四元数
• `` Set a quaternion from the given euler angle 0, 0, z.
• fromMat3 根据三维矩阵信息计算四元数，默认输入矩阵不含有缩放信息
• fromEuler 根据欧拉角信息计算四元数，旋转顺序为 YZX
• toAxisX 返回定义此四元数的坐标系 X 轴向量
• toAxisY 返回定义此四元数的坐标系 Y 轴向量
• toAxisZ 返回定义此四元数的坐标系 Z 轴向量
• toEuler 根据四元数计算欧拉角，返回角度 x, y 在 [-180, 180] 区间内, z 默认在 [-90, 90] 区间内，旋转顺序为 YZX
• strictEquals 四元数等价判断
• equals 排除浮点数误差的四元数近似等价判断
• toArray 四元数转数组
• fromArray 数组转四元数
• clone 克隆一个四元数并返回
• set 用另一个四元数的值设置到当前对象上。
• equals 当前的四元数是否与指定的四元数相等。
• toEuler 转换四元数到欧拉角
• fromEuler 转换欧拉角到四元数
• lerp 计算四元数的插值结果
• multiply 计算四元数乘积的结果
• rotateAround 围绕世界空间轴按给定弧度旋转四元数
• toString 转换为方便阅读的字符串。

Details

属性（properties）

x

y

z

w

方法

constructor

构造函数，可查看 cc.quat

参数列表

• x number
• y number
• z number
• w number

mul

计算四元数乘积的结果

参数列表

• other Quat
• out Quat

clone

获得指定四元数的拷贝

copy

复制目标四元数

set

设置四元数值

identity

将目标赋值为单位四元数

rotationTo

设置四元数为两向量间的最短路径旋转，默认两向量都已归一化

getAxisAngle

获取四元数的旋转轴和旋转弧度

参数列表

• outAxis Vec3 旋转轴输出
• q Quat 源四元数

multiply

四元数乘法

multiplyScalar

四元数标量乘法

scaleAndAdd

四元数乘加：A + B * scale

rotateX

绕 X 轴旋转指定四元数

参数列表

• rad Unknown 旋转弧度

rotateY

绕 Y 轴旋转指定四元数

参数列表

• rad Unknown 旋转弧度

rotateZ

绕 Z 轴旋转指定四元数

参数列表

• rad Unknown 旋转弧度

rotateAround

绕世界空间下指定轴旋转四元数

参数列表

• axis Unknown 旋转轴，默认已归一化
• rad Unknown 旋转弧度

rotateAroundLocal

绕本地空间下指定轴旋转四元数

参数列表

• axis Unknown 旋转轴
• rad Unknown 旋转弧度

calculateW

根据 xyz 分量计算 w 分量，默认已归一化

dot

四元数点积（数量积）

lerp

逐元素线性插值： A + t * (B - A)

sqlerp

带两个控制点的四元数球面插值

invert

四元数求逆

conjugate

求共轭四元数，对单位四元数与求逆等价，但更高效

len

求四元数长度

lengthSqr

求四元数长度平方

normalize

归一化四元数

fromAxes

根据本地坐标轴朝向计算四元数，默认三向量都已归一化且相互垂直

fromViewUp

根据视口的前方向和上方向计算四元数

参数列表

• view Unknown 视口面向的前方向，必须归一化
• up Unknown 视口的上方向，必须归一化，默认为 (0, 1, 0)

fromAxisAngle

根据旋转轴和旋转弧度计算四元数

Set a quaternion from the given euler angle 0, 0, z.

参数列表

• out Quat Quaternion to store result.
• z number Angle to rotate around Z axis in degrees.

fromMat3

根据三维矩阵信息计算四元数，默认输入矩阵不含有缩放信息

fromEuler

根据欧拉角信息计算四元数，旋转顺序为 YZX

toAxisX

返回定义此四元数的坐标系 X 轴向量

toAxisY

返回定义此四元数的坐标系 Y 轴向量

toAxisZ

返回定义此四元数的坐标系 Z 轴向量

toEuler

根据四元数计算欧拉角，返回角度 x, y 在 [-180, 180] 区间内, z 默认在 [-90, 90] 区间内，旋转顺序为 YZX

参数列表

• outerZ Unknown z 取值范围区间改为 [-180, -90] U [90, 180]

strictEquals

四元数等价判断

equals

排除浮点数误差的四元数近似等价判断

toArray

四元数转数组

参数列表

• ofs Unknown 数组内的起始偏移量

fromArray

数组转四元数

参数列表

• ofs Unknown 数组起始偏移量

clone

克隆一个四元数并返回

set

用另一个四元数的值设置到当前对象上。

参数列表

• newValue Quat !#en new value to set. !#zh 要设置的新值

equals

当前的四元数是否与指定的四元数相等。

参数列表

• other Quat

toEuler

转换四元数到欧拉角

参数列表

• out Vec3

fromEuler

转换欧拉角到四元数

参数列表

• euler Vec3

lerp

计算四元数的插值结果

参数列表

• to Quat
• ratio Number
• out Quat

multiply

计算四元数乘积的结果

参数列表

• other Quat

rotateAround

围绕世界空间轴按给定弧度旋转四元数

参数列表

• rot Quat Quaternion to rotate
• axis Vec3 The axis around which to rotate in world space
• rad Number Angle (in radians) to rotate
• out Quat Quaternion to store result

toString

转换为方便阅读的字符串。