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
meta description
类型 Number
定义于 cocos2d/core/value-types/quat.ts:844
y
meta description
类型 Number
定义于 cocos2d/core/value-types/quat.ts:848
z
meta description
类型 Number
定义于 cocos2d/core/value-types/quat.ts:852
w
meta description
类型 Number
定义于 cocos2d/core/value-types/quat.ts:856

方法

constructor

构造函数,可查看 cc.quat

meta description
定义于 cocos2d/core/value-types/quat.ts:48
参数列表
mul

计算四元数乘积的结果

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:65
参数列表
clone

获得指定四元数的拷贝

meta description
定义于 cocos2d/core/value-types/quat.ts:79
copy

复制目标四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:91
set

设置四元数值

meta description
定义于 cocos2d/core/value-types/quat.ts:107
identity

将目标赋值为单位四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:123
rotationTo

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

meta description
定义于 cocos2d/core/value-types/quat.ts:139
getAxisAngle

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

meta description
返回 Number
定义于 cocos2d/core/value-types/quat.ts:173
参数列表
  • outAxis Vec3 旋转轴输出
  • q Quat 源四元数
multiply

四元数乘法

meta description
定义于 cocos2d/core/value-types/quat.ts:200
multiplyScalar

四元数标量乘法

meta description
定义于 cocos2d/core/value-types/quat.ts:220
scaleAndAdd

四元数乘加:A + B * scale

meta description
定义于 cocos2d/core/value-types/quat.ts:236
rotateX

绕 X 轴旋转指定四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:252
参数列表
  • rad Unknown 旋转弧度
rotateY

绕 Y 轴旋转指定四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:274
参数列表
  • rad Unknown 旋转弧度
rotateZ

绕 Z 轴旋转指定四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:296
参数列表
  • rad Unknown 旋转弧度
rotateAround

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

meta description
定义于 cocos2d/core/value-types/quat.ts:318
参数列表
  • axis Unknown 旋转轴,默认已归一化
  • rad Unknown 旋转弧度
rotateAroundLocal

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

meta description
定义于 cocos2d/core/value-types/quat.ts:338
参数列表
  • axis Unknown 旋转轴
  • rad Unknown 旋转弧度
calculateW

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

meta description
定义于 cocos2d/core/value-types/quat.ts:354
dot

四元数点积(数量积)

meta description
定义于 cocos2d/core/value-types/quat.ts:371
lerp

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

meta description
定义于 cocos2d/core/value-types/quat.ts:383
sqlerp

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

meta description
定义于 cocos2d/core/value-types/quat.ts:444
invert

四元数求逆

meta description
定义于 cocos2d/core/value-types/quat.ts:459
conjugate

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

meta description
定义于 cocos2d/core/value-types/quat.ts:480
len

求四元数长度

meta description
定义于 cocos2d/core/value-types/quat.ts:496
lengthSqr

求四元数长度平方

meta description
定义于 cocos2d/core/value-types/quat.ts:508
normalize

归一化四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:520
fromAxes

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

meta description
定义于 cocos2d/core/value-types/quat.ts:540
fromViewUp

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

meta description
定义于 cocos2d/core/value-types/quat.ts:557
参数列表
  • view Unknown 视口面向的前方向,必须归一化
  • up Unknown 视口的上方向,必须归一化,默认为 (0, 1, 0)
fromAxisAngle

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

meta description
定义于 cocos2d/core/value-types/quat.ts:572

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

meta description
定义于 cocos2d/core/value-types/quat.ts:590
参数列表
  • out Quat Quaternion to store result.
  • z number Angle to rotate around Z axis in degrees.
fromMat3

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

meta description
定义于 cocos2d/core/value-types/quat.ts:605
fromEuler

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

meta description
定义于 cocos2d/core/value-types/quat.ts:657
toAxisX

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

meta description
定义于 cocos2d/core/value-types/quat.ts:685
toAxisY

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

meta description
定义于 cocos2d/core/value-types/quat.ts:703
toAxisZ

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

meta description
定义于 cocos2d/core/value-types/quat.ts:722
toEuler

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

meta description
定义于 cocos2d/core/value-types/quat.ts:741
参数列表
  • outerZ Unknown z 取值范围区间改为 [-180, -90] U [90, 180]
strictEquals

四元数等价判断

meta description
定义于 cocos2d/core/value-types/quat.ts:781
equals

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

meta description
定义于 cocos2d/core/value-types/quat.ts:793
toArray

四元数转数组

meta description
定义于 cocos2d/core/value-types/quat.ts:809
参数列表
  • ofs Unknown 数组内的起始偏移量
fromArray

数组转四元数

meta description
定义于 cocos2d/core/value-types/quat.ts:826
参数列表
  • ofs Unknown 数组起始偏移量
clone

克隆一个四元数并返回

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:878
set

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

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:888
参数列表
  • newValue Quat !#en new value to set. !#zh 要设置的新值
equals

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

meta description
返回 Boolean
定义于 cocos2d/core/value-types/quat.ts:904
参数列表
toEuler

转换四元数到欧拉角

meta description
返回 Vec3
定义于 cocos2d/core/value-types/quat.ts:915
参数列表
fromEuler

转换欧拉角到四元数

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:926
参数列表
lerp

计算四元数的插值结果

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:937
参数列表
multiply

计算四元数乘积的结果

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:952
参数列表
rotateAround

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

meta description
返回 Quat
定义于 cocos2d/core/value-types/quat.ts:963
参数列表
  • 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

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

meta description
返回 string
定义于 cocos2d/core/value-types/value-type.ts:92

条与 "" 相匹配的结果

    没有与 "" 匹配的结果