Quaternion

Quaternion class

Quaternion is usually used to perform rotation in computer graphics.

Properties

NameDescription
wThe w component.
xThe x component.
yThe y component.
zThe z component.
IDENTITYThe Identity quaternion.

Methods

constructor

NameDescription
constructor()

Result:


constructor_overload

NameDescription
constructor_overload(w, x, y, z)Initializes a new instance of the Quaternion class.

Parameters:

NameTypeDescription
wNumberw component of the quaternion
xNumberx component of the quaternion
yNumbery component of the quaternion
zNumberz component of the quaternion

Result:


getLength

NameDescription
getLength()Gets the length of the quaternion

Result:


equals

NameDescription
equals(obj)Check if two quaternions equals

Parameters:

NameTypeDescription
objObjectThe object to check equality.

Result: boolean


hashCode

NameDescription
hashCode()Gets the hash code of Quaternion

Result: Number


conjugate

NameDescription
conjugate()Returns a conjugate quaternion of current quaternion

Result: Quaternion


inverse

NameDescription
inverse()Returns a inverse quaternion of current quaternion

Result: Quaternion


dot

NameDescription
dot(q)Dots product

Parameters:

NameTypeDescription
qQuaternionThe quaternion

Result: Number


eulerAngles

NameDescription
eulerAngles()Converts quaternion to rotation represented by Euler angles All components are in radian

Result: Vector3


normalize

NameDescription
normalize()Normalize the quaternion

Result: Quaternion


concat

NameDescription
concat(rhs)Concatenate two quaternions

Parameters:

NameTypeDescription
rhQuaternionnull

Result: Quaternion


fromAngleAxis

NameDescription
fromAngleAxis(a, axis)Creates a quaternion around given axis and rotate in clockwise

Parameters:

NameTypeDescription
aNumberClockwise rotation in radian
axisVector3Axis

Result: Quaternion


fromRotation

NameDescription
fromRotation(orig, dest)Creates a quaternion that rotate from original to destination direction

Parameters:

NameTypeDescription
origVector3Original direction
destVector3Destination direction

Result: Quaternion


fromEulerAngle

NameDescription
fromEulerAngle(pitch, yaw, roll)Creates quaternion from given Euler angle

Parameters:

NameTypeDescription
pitchNumberPitch in radian
yawNumberYaw in radian
rollNumberRoll in radian

Result: Quaternion


fromEulerAngle

NameDescription
fromEulerAngle(eulerAngle)Creates quaternion from given Euler angle

Parameters:

NameTypeDescription
eulerAngleVector3Euler angle in radian

Result: Quaternion


toMatrix

NameDescription
toMatrix()Convert the rotation presented by quaternion to transform matrix.

Result: Matrix4


toString

NameDescription
toString()Gets the representation of quaternion in string

Result: String


interpolate

NameDescription
interpolate(t, from, to)Populates this quaternion with the interpolated value between the given quaternion arguments for a t between from and to.

Parameters:

NameTypeDescription
tNumberThe coefficient to interpolate.
fromQuaternionSource quaternion.
toQuaternionTarget quaternion.

Result: Quaternion