跳转至

Box3Quaternion / GameQuaternion 四元数

这是一个服务端API

该API仅在服务端脚本使用

查阅官方文档
查阅官方文档(Arena)
查阅社区文档(Arena)

构造函数

Box3Quaternion(w: number, x: number, y: number, z: number): Box3Quaternion
GameQuaternion(w: number, x: number, y: number, z: number): GameQuaternion

新建一个四元数

对于萌新的提示

Box3Quaternion / GameQuaternion对于萌新来说可能会有点困难(甚至比Box3Vector3 / GameVector3还要复杂) 如果不会使用,不需要了解所有方法,使用fromEuler构建Box3Quaternion / GameQuaternion

提示

下列全部[示例]的代码后面的注释为预期的运行结果,可以不用看“<~”,这只是一个提示符

常用

fromEuler rotateX rotateY rotateZ

属性

属性 类型 说明
w number 四元数实部
x number 四元数x虚部
y number 四元数y虚部
z number 四元数z虚部

方法

内容缺失

API文档内容繁多,有一些内容还未完工。
如果你愿意为此贡献一份力量,请加入我们

rotateX (_rad: ):
rotateX (_rad: ):

将这个四元数绕x轴旋转,使用弧度制,单位为\(rad\)

是弧度,不是角度!

弧度

另一种表示角度的方法,单位为\(rad\)\(\pi rad\)相当于\(180°\)\(2\pi rad\)相当于\(360°\)
其定义为:弧长等于圆半径的弧所对应的圆心角为\(1rad\)

rotateY (_rad: ):
rotateY (_rad: ):

将这个四元数绕y轴旋转,使用弧度制,单位为\(rad\)

是弧度,不是角度!

弧度

另一种表示角度的方法,单位为\(rad\)\(\pi rad\)相当于\(180°\)\(2\pi rad\)相当于\(360°\)
其定义为:弧长等于圆半径的弧所对应的圆心角为\(1rad\)

rotateZ (_rad: ):
rotateZ (_rad: ):

将这个四元数绕z轴旋转,使用弧度制,单位为\(rad\)

是弧度,不是角度!

弧度

另一种表示角度的方法,单位为\(rad\)\(\pi rad\)相当于\(180°\)\(2\pi rad\)相当于\(360°\)
其定义为:弧长等于圆半径的弧所对应的圆心角为\(1rad\)

fromEuler (x: number, y: number, z: number): Box3Quaternion
fromEuler (x: number, y: number, z: number): GameQuaternion

从欧拉角生成一个Box3Quaternion / GameQuaternion

提示

使用此方法生成Box3Quaternion / GameQuaternion对萌新来说可能会更加友好

示例
Box3Quaternion.fromEuler(0, 90, 0) //<~ { w:0.7071067811865476, x:0, y:0.7071067811865475, z:0 }
Box3Quaternion.fromEuler(0, 0, 0) // <~ { w:1, x:0, y:0, z:0 }
GameQuaternion.fromEuler(0, 90, 0) //<~ { w:0.7071067811865476, x:0, y:0.7071067811865475, z:0 }
GameQuaternion.fromEuler(0, 0, 0) // <~ { w:1, x:0, y:0, z:0 }

评论区