Class Quaternionf
- All Implemented Interfaces:
Externalizable,Serializable,Cloneable,Quaternionfc
- Author:
- Richard Greenlees, Kai Burjack
- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionCreate a newQuaternionfand initialize it with(x=0, y=0, z=0, w=1), where(x, y, z)is the vector part of the quaternion andwis the real/scalar part.Quaternionf(double x, double y, double z, double w) Create a newQuaternionfand initialize its components to the given values.Quaternionf(float x, float y, float z, float w) Create a newQuaternionfand initialize its components to the given values.Quaternionf(AxisAngle4d axisAngle) Create a newQuaterniondwhich represents the rotation of the givenAxisAngle4d.Quaternionf(AxisAngle4f axisAngle) Create a newQuaternionfwhich represents the rotation of the givenAxisAngle4f.Quaternionf(Quaterniondc source) Create a newQuaternionfand initialize its components to the same values as the givenQuaterniondc.Quaternionf(Quaternionfc source) Create a newQuaternionfand initialize its components to the same values as the givenQuaternionfc. -
Method Summary
Modifier and TypeMethodDescriptionadd(float x, float y, float z, float w) Add the quaternion(x, y, z, w)to this quaternion.add(float x, float y, float z, float w, Quaternionf dest) Add the quaternion(x, y, z, w)to this quaternion and store the result indest.add(Quaternionfc q2) Addq2to this quaternion.add(Quaternionfc q2, Quaternionf dest) Addq2to this quaternion and store the result indest.floatangle()Return the angle in radians represented by this normalized quaternion rotation.clone()Conjugate this quaternion.conjugate(Quaternionf dest) Conjugate this quaternion and store the result indest.Conjugatethisby the given quaternionqby computingq * this * q^-1.conjugateBy(Quaternionfc q, Quaternionf dest) Conjugatethisby the given quaternionqby computingq * this * q^-1and store the result intodest.difference(Quaternionf other) Compute the difference betweenthisand theotherquaternion and store the result inthis.difference(Quaternionfc other, Quaternionf dest) Compute the difference betweenthisand theotherquaternion and store the result indest.div(Quaternionfc b) Dividethisquaternion byb.div(Quaternionfc b, Quaternionf dest) Dividethisquaternion byband store the result indest.floatdot(Quaternionf otherQuat) Return the dot of this quaternion andotherQuat.booleanequals(float x, float y, float z, float w) booleanbooleanequals(Quaternionfc q, float delta) Compare the quaternion components ofthisquaternion with the given quaternion using the givendeltaand return whether all of them are equal within a maximum difference ofdelta.fromAxisAngleDeg(float axisX, float axisY, float axisZ, float angle) Set this quaternion to be a representation of the supplied axis and angle (in degrees).fromAxisAngleDeg(Vector3fc axis, float angle) Set this quaternion to be a representation of the supplied axis and angle (in degrees).fromAxisAngleRad(float axisX, float axisY, float axisZ, float angle) Set this quaternion to be a representation of the supplied axis and angle (in radians).fromAxisAngleRad(Vector3fc axis, float angle) Set this quaternion to be a representation of the supplied axis and angle (in radians).get(AxisAngle4d dest) Set the givenAxisAngle4dto represent the rotation ofthisquaternion.get(AxisAngle4f dest) Set the givenAxisAngle4fto represent the rotation ofthisquaternion.Set the given destination matrix to the rotation represented bythis.Set the given destination matrix to the rotation represented bythis.Set the given destination matrix to the rotation represented bythis.Set the given destination matrix to the rotation represented bythis.get(Matrix4x3d dest) Set the given destination matrix to the rotation represented bythis.get(Matrix4x3f dest) Set the given destination matrix to the rotation represented bythis.get(Quaterniond dest) Set the givenQuaterniondto the values ofthis.get(Quaternionf dest) Set the givenQuaternionfto the values ofthis.getAsMatrix3f(ByteBuffer dest) Store the 3x3 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.getAsMatrix3f(FloatBuffer dest) Store the 3x3 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.getAsMatrix4f(ByteBuffer dest) Store the 4x4 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.getAsMatrix4f(FloatBuffer dest) Store the 4x4 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.getAsMatrix4x3f(ByteBuffer dest) Store the 4x3 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.getAsMatrix4x3f(FloatBuffer dest) Store the 4x3 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.getEulerAnglesXYZ(Vector3f eulerAngles) Get the euler angles in radians in rotation sequenceXYZof this quaternion and store them in the provided parametereulerAngles.getEulerAnglesYXZ(Vector3f eulerAngles) Get the euler angles in radians in rotation sequenceYXZof this quaternion and store them in the provided parametereulerAngles.getEulerAnglesZXY(Vector3f eulerAngles) Get the euler angles in radians in rotation sequenceZXYof this quaternion and store them in the provided parametereulerAngles.getEulerAnglesZYX(Vector3f eulerAngles) Get the euler angles in radians in rotation sequenceZYXof this quaternion and store them in the provided parametereulerAngles.inthashCode()identity()Set this quaternion to the identity.integrate(float dt, float vx, float vy, float vz) Integrate the rotation given by the angular velocity(vx, vy, vz)around the x, y and z axis, respectively, with respect to the given elapsed time deltadtand add the differentiate rotation to the rotation represented by this quaternion.integrate(float dt, float vx, float vy, float vz, Quaternionf dest) Integrate the rotation given by the angular velocity(vx, vy, vz)around the x, y and z axis, respectively, with respect to the given elapsed time deltadtand add the differentiate rotation to the rotation represented by this quaternion and store the result intodest.invert()Invert this quaternion andnormalizeit.invert(Quaternionf dest) Invert this quaternion and store thenormalizedresult indest.booleanisFinite()floatReturn the square of the length of this quaternion.lookAlong(float dirX, float dirY, float dirZ, float upX, float upY, float upZ) Apply a rotation to this quaternion that maps the given direction to the positive Z axis.lookAlong(float dirX, float dirY, float dirZ, float upX, float upY, float upZ, Quaternionf dest) Apply a rotation to this quaternion that maps the given direction to the positive Z axis, and store the result indest.Apply a rotation to this quaternion that maps the given direction to the positive Z axis.lookAlong(Vector3fc dir, Vector3fc up, Quaternionf dest) Apply a rotation to this quaternion that maps the given direction to the positive Z axis, and store the result indest.mul(float f) Multiply this quaternion by the given scalar.mul(float qx, float qy, float qz, float qw) Multiply this quaternion by the quaternion represented via(qx, qy, qz, qw).mul(float qx, float qy, float qz, float qw, Quaternionf dest) Multiply this quaternion by the quaternion represented via(qx, qy, qz, qw)and store the result indest.mul(float f, Quaternionf dest) Multiply this quaternion by the given scalar and store the result indest.mul(Quaternionfc q) Multiply this quaternion byq.mul(Quaternionfc q, Quaternionf dest) Multiply this quaternion byqand store the result indest.static Quaternionfcnlerp(Quaternionfc[] qs, float[] weights, Quaternionf dest) Interpolate between all of the quaternions given inqsvia non-spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.nlerp(Quaternionfc q, float factor) Compute a linear (non-spherical) interpolation ofthisand the given quaternionqand store the result inthis.nlerp(Quaternionfc q, float factor, Quaternionf dest) Compute a linear (non-spherical) interpolation ofthisand the given quaternionqand store the result indest.static QuaternionfcnlerpIterative(Quaternionf[] qs, float[] weights, float dotThreshold, Quaternionf dest) Interpolate between all of the quaternions given inqsvia iterative non-spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.nlerpIterative(Quaternionfc q, float alpha, float dotThreshold) Compute linear (non-spherical) interpolations ofthisand the given quaternionqiteratively and store the result inthis.nlerpIterative(Quaternionfc q, float alpha, float dotThreshold, Quaternionf dest) Compute linear (non-spherical) interpolations ofthisand the given quaternionqiteratively and store the result indest.Normalize this quaternion.normalize(Quaternionf dest) Normalize this quaternion and store the result indest.Obtain the direction of+Xbefore the rotation transformation represented bythisnormalized quaternion is applied.Obtain the direction of+Ybefore the rotation transformation represented bythisnormalized quaternion is applied.Obtain the direction of+Zbefore the rotation transformation represented bythisnormalized quaternion is applied.Obtain the direction of+Xbefore the rotation transformation represented bythisquaternion is applied.Obtain the direction of+Ybefore the rotation transformation represented bythisquaternion is applied.Obtain the direction of+Zbefore the rotation transformation represented bythisquaternion is applied.premul(float qx, float qy, float qz, float qw) Pre-multiply this quaternion by the quaternion represented via(qx, qy, qz, qw).premul(float qx, float qy, float qz, float qw, Quaternionf dest) Pre-multiply this quaternion by the quaternion represented via(qx, qy, qz, qw)and store the result indest.Pre-multiply this quaternion byq.premul(Quaternionfc q, Quaternionf dest) Pre-multiply this quaternion byqand store the result indest.voidrotateAxis(float angle, float axisX, float axisY, float axisZ) Apply a rotation tothisquaternion rotating the given radians about the specified axis.rotateAxis(float angle, float axisX, float axisY, float axisZ, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the specified axis and store the result indest.rotateAxis(float angle, Vector3fc axis) Apply a rotation tothisquaternion rotating the given radians about the specified axis.rotateAxis(float angle, Vector3fc axis, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the specified axis and store the result indest.rotateLocalX(float angle) Apply a rotation tothisquaternion rotating the given radians about the local x axis.rotateLocalX(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the local x axis and store the result indest.rotateLocalY(float angle) Apply a rotation tothisquaternion rotating the given radians about the local y axis.rotateLocalY(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the local y axis and store the result indest.rotateLocalZ(float angle) Apply a rotation tothisquaternion rotating the given radians about the local z axis.rotateLocalZ(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the local z axis and store the result indest.rotateTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ) Apply a rotation tothisthat rotates thefromDirvector to point alongtoDir.rotateTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ, Quaternionf dest) Apply a rotation tothisthat rotates thefromDirvector to point alongtoDirand store the result indest.Apply a rotation tothisthat rotates thefromDirvector to point alongtoDir.rotateTo(Vector3fc fromDir, Vector3fc toDir, Quaternionf dest) Apply a rotation tothisthat rotates thefromDirvector to point alongtoDirand store the result indest.rotateX(float angle) Apply a rotation tothisquaternion rotating the given radians about the x axis.rotateX(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the x axis and store the result indest.rotateXYZ(float angleX, float angleY, float angleZ) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles using rotation sequenceXYZ.rotateXYZ(float angleX, float angleY, float angleZ, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles using rotation sequenceXYZand store the result indest.rotateY(float angle) Apply a rotation tothisquaternion rotating the given radians about the y axis.rotateY(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the y axis and store the result indest.rotateYXZ(float angleY, float angleX, float angleZ) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceYXZ.rotateYXZ(float angleY, float angleX, float angleZ, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceYXZand store the result indest.rotateZ(float angle) Apply a rotation tothisquaternion rotating the given radians about the z axis.rotateZ(float angle, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the z axis and store the result indest.rotateZYX(float angleZ, float angleY, float angleX) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceZYX.rotateZYX(float angleZ, float angleY, float angleX, Quaternionf dest) Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceZYXand store the result indest.rotationAxis(float angle, float axisX, float axisY, float axisZ) Set this quaternion to a rotation of the given angle in radians about the supplied axis.rotationAxis(float angle, Vector3fc axis) Set this quaternion to a rotation of the given angle in radians about the supplied axis.rotationAxis(AxisAngle4f axisAngle) Set thisQuaternionfto a rotation of the given angle in radians about the supplied axis, all of which are specified via theAxisAngle4f.rotationTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ) Setthisquaternion to a rotation that rotates thefromDirvector to point alongtoDir.rotationTo(Vector3fc fromDir, Vector3fc toDir) Setthisquaternion to a rotation that rotates thefromDirvector to point alongtoDir.rotationX(float angle) Set this quaternion to represent a rotation of the given radians about the x axis.rotationXYZ(float angleX, float angleY, float angleZ) Set this quaternion from the supplied euler angles (in radians) with rotation order XYZ.rotationY(float angle) Set this quaternion to represent a rotation of the given radians about the y axis.rotationYXZ(float angleY, float angleX, float angleZ) Set this quaternion from the supplied euler angles (in radians) with rotation order YXZ.rotationZ(float angle) Set this quaternion to represent a rotation of the given radians about the z axis.rotationZYX(float angleZ, float angleY, float angleX) Set this quaternion from the supplied euler angles (in radians) with rotation order ZYX.scale(float factor) Apply scaling to this quaternion, which results in any vector transformed by this quaternion to change its length by the givenfactor.scale(float factor, Quaternionf dest) Apply scaling to this quaternion, which results in any vector transformed by the quaternion to change its length by the givenfactor, and store the result indest.scaling(float factor) Set this quaternion to represent scaling, which results in a transformed vector to change its length by the givenfactor.set(float x, float y, float z, float w) Set this quaternion to the given values.set(AxisAngle4d axisAngle) Set this quaternion to a rotation equivalent to the givenAxisAngle4d.set(AxisAngle4f axisAngle) Set this quaternion to a rotation equivalent to the givenAxisAngle4f.set(Quaterniondc q) Set this quaternion to be a copy ofq.set(Quaternionfc q) Set this quaternion to be a copy ofq.setAngleAxis(double angle, double x, double y, double z) Set this quaternion to a rotation equivalent to the supplied axis and angle (in radians).setAngleAxis(float angle, float x, float y, float z) Set this quaternion to a rotation equivalent to the supplied axis and angle (in radians).Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.Set this quaternion to be a representation of the rotational component of the given matrix.static Quaternionfcslerp(Quaternionf[] qs, float[] weights, Quaternionf dest) Interpolate between all of the quaternions given inqsvia spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.slerp(Quaternionfc target, float alpha) slerp(Quaternionfc target, float alpha, Quaternionf dest) toString()Return a string representation of this quaternion.toString(NumberFormat formatter) Return a string representation of this quaternion by formatting the components with the givenNumberFormat.Transform the given vector(x, y, z)by this quaternion and store the result indest.Transform the given vector(x, y, z)by this quaternion and store the result indest.Transform the given vector(x, y, z)by this quaternion and store the result indest.Transform the given vector(x, y, z)by this quaternion and store the result indest.Transform the given vector(x, y, z)by this quaternion and store the result indest.Transform the given vector by this quaternion.Transform the given vector by this quaternion and store the result indest.Transform the given vector by this quaternion.Transform the given vector by this quaternion and store the result indest.Transform the given vector by this quaternion.Transform the given vector by this quaternion and store the result indest.Transform the given vector by this quaternion.Transform the given vector by this quaternion and store the result indest.transformInverse(double x, double y, double z, Vector3d dest) Transform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.transformInverse(double x, double y, double z, Vector4d dest) Transform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.transformInverse(float x, float y, float z, Vector3d dest) Transform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.transformInverse(float x, float y, float z, Vector3f dest) Transform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.transformInverse(float x, float y, float z, Vector4f dest) Transform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.transformInverse(Vector3d vec) Transform the given vector by the inverse of this quaternion.transformInverse(Vector3dc vec, Vector3d dest) Transform the given vector by the inverse of this quaternion and store the result indest.transformInverse(Vector3f vec) Transform the given vector by the inverse of this quaternion.transformInverse(Vector3fc vec, Vector3f dest) Transform the given vector by the inverse of quaternion and store the result indest.transformInverse(Vector4d vec) Transform the given vector by the inverse of this quaternion.transformInverse(Vector4dc vec, Vector4d dest) Transform the given vector by the inverse of this quaternion and store the result indest.transformInverse(Vector4f vec) Transform the given vector by the inverse of this quaternion.transformInverse(Vector4fc vec, Vector4f dest) Transform the given vector by the inverse of this quaternion and store the result indest.transformInverseUnit(double x, double y, double z, Vector3d dest) Transform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.transformInverseUnit(double x, double y, double z, Vector4d dest) Transform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.transformInverseUnit(float x, float y, float z, Vector3d dest) Transform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.transformInverseUnit(float x, float y, float z, Vector3f dest) Transform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.transformInverseUnit(float x, float y, float z, Vector4f dest) Transform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.transformInverseUnit(Vector3dc vec, Vector3d dest) Transform the given vector by the inverse of this unit quaternion and store the result indest.Transform the given vector by the inverse of this unit quaternion.transformInverseUnit(Vector3fc vec, Vector3f dest) Transform the given vector by the inverse of this unit quaternion and store the result indest.Transform the given vector by the inverse of this unit quaternion.transformInverseUnit(Vector4dc vec, Vector4d dest) Transform the given vector by the inverse of this unit quaternion and store the result indest.Transform the given vector by the inverse of this unit quaternion.transformInverseUnit(Vector4fc vec, Vector4f dest) Transform the given vector by the inverse of this unit quaternion and store the result indest.transformPositiveX(Vector3d dest) Transform the vector(1, 0, 0)by this quaternion.transformPositiveX(Vector3f dest) Transform the vector(1, 0, 0)by this quaternion.transformPositiveX(Vector4d dest) Transform the vector(1, 0, 0)by this quaternion.transformPositiveX(Vector4f dest) Transform the vector(1, 0, 0)by this quaternion.transformPositiveY(Vector3d dest) Transform the vector(0, 1, 0)by this quaternion.transformPositiveY(Vector3f dest) Transform the vector(0, 1, 0)by this quaternion.transformPositiveY(Vector4d dest) Transform the vector(0, 1, 0)by this quaternion.transformPositiveY(Vector4f dest) Transform the vector(0, 1, 0)by this quaternion.transformPositiveZ(Vector3d dest) Transform the vector(0, 0, 1)by this quaternion.transformPositiveZ(Vector3f dest) Transform the vector(0, 0, 1)by this quaternion.transformPositiveZ(Vector4d dest) Transform the vector(0, 0, 1)by this quaternion.transformPositiveZ(Vector4f dest) Transform the vector(0, 0, 1)by this quaternion.transformUnit(double x, double y, double z, Vector3d dest) Transform the given vector(x, y, z)by this unit quaternion and store the result indest.transformUnit(double x, double y, double z, Vector4d dest) Transform the given vector(x, y, z)by this unit quaternion and store the result indest.transformUnit(float x, float y, float z, Vector3d dest) Transform the given vector(x, y, z)by this unit quaternion and store the result indest.transformUnit(float x, float y, float z, Vector3f dest) Transform the given vector(x, y, z)by this unit quaternion and store the result indest.transformUnit(float x, float y, float z, Vector4f dest) Transform the given vector(x, y, z)by this unit quaternion and store the result indest.transformUnit(Vector3dc vec, Vector3d dest) Transform the given vector by this unit quaternion and store the result indest.transformUnit(Vector3f vec) Transform the given vector by this unit quaternion.transformUnit(Vector3fc vec, Vector3f dest) Transform the given vector by this unit quaternion and store the result indest.transformUnit(Vector4d vec) Transform the given vector by this unit quaternion.transformUnit(Vector4dc vec, Vector4d dest) Transform the given vector by this unit quaternion and store the result indest.transformUnit(Vector4f vec) Transform the given vector by this unit quaternion.transformUnit(Vector4fc vec, Vector4f dest) Transform the given vector by this unit quaternion and store the result indest.Transform the vector(1, 0, 0)by this unit quaternion.Transform the vector(1, 0, 0)by this unit quaternion.Transform the vector(1, 0, 0)by this unit quaternion.Transform the vector(1, 0, 0)by this unit quaternion.Transform the vector(0, 1, 0)by this unit quaternion.Transform the vector(0, 1, 0)by this unit quaternion.Transform the vector(0, 1, 0)by this unit quaternion.Transform the vector(0, 1, 0)by this unit quaternion.Transform the vector(0, 0, 1)by this unit quaternion.Transform the vector(0, 0, 1)by this unit quaternion.Transform the vector(0, 0, 1)by this unit quaternion.Transform the vector(0, 0, 1)by this unit quaternion.floatw()voidfloatx()floaty()floatz()
-
Field Details
-
x
public float xThe first component of the vector part. -
y
public float yThe second component of the vector part. -
z
public float zThe third component of the vector part. -
w
public float wThe real/scalar part of the quaternion.
-
-
Constructor Details
-
Quaternionf
public Quaternionf()Create a newQuaternionfand initialize it with(x=0, y=0, z=0, w=1), where(x, y, z)is the vector part of the quaternion andwis the real/scalar part. -
Quaternionf
public Quaternionf(double x, double y, double z, double w) Create a newQuaternionfand initialize its components to the given values.- Parameters:
x- the first component of the imaginary party- the second component of the imaginary partz- the third component of the imaginary partw- the real part
-
Quaternionf
public Quaternionf(float x, float y, float z, float w) Create a newQuaternionfand initialize its components to the given values.- Parameters:
x- the first component of the imaginary party- the second component of the imaginary partz- the third component of the imaginary partw- the real part
-
Quaternionf
Create a newQuaternionfand initialize its components to the same values as the givenQuaternionfc.- Parameters:
source- theQuaternionfcto take the component values from
-
Quaternionf
Create a newQuaternionfand initialize its components to the same values as the givenQuaterniondc.- Parameters:
source- theQuaterniondcto take the component values from
-
Quaternionf
Create a newQuaternionfwhich represents the rotation of the givenAxisAngle4f.- Parameters:
axisAngle- theAxisAngle4f
-
Quaternionf
Create a newQuaterniondwhich represents the rotation of the givenAxisAngle4d.- Parameters:
axisAngle- theAxisAngle4d
-
-
Method Details
-
x
public float x()- Specified by:
xin interfaceQuaternionfc- Returns:
- the first component of the vector part
-
y
public float y()- Specified by:
yin interfaceQuaternionfc- Returns:
- the second component of the vector part
-
z
public float z()- Specified by:
zin interfaceQuaternionfc- Returns:
- the third component of the vector part
-
w
public float w()- Specified by:
win interfaceQuaternionfc- Returns:
- the real/scalar part of the quaternion
-
normalize
Normalize this quaternion.- Returns:
- this
-
normalize
Description copied from interface:QuaternionfcNormalize this quaternion and store the result indest.- Specified by:
normalizein interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
add
Add the quaternion(x, y, z, w)to this quaternion.- Parameters:
x- the x component of the vector party- the y component of the vector partz- the z component of the vector partw- the real/scalar component- Returns:
- this
-
add
Description copied from interface:QuaternionfcAdd the quaternion(x, y, z, w)to this quaternion and store the result indest.- Specified by:
addin interfaceQuaternionfc- Parameters:
x- the x component of the vector party- the y component of the vector partz- the z component of the vector partw- the real/scalar componentdest- will hold the result- Returns:
- dest
-
add
Addq2to this quaternion.- Parameters:
q2- the quaternion to add to this- Returns:
- this
-
add
Description copied from interface:QuaternionfcAddq2to this quaternion and store the result indest.- Specified by:
addin interfaceQuaternionfc- Parameters:
q2- the quaternion to add to thisdest- will hold the result- Returns:
- dest
-
dot
Return the dot of this quaternion andotherQuat.- Parameters:
otherQuat- the other quaternion- Returns:
- the dot product
-
angle
public float angle()Description copied from interface:QuaternionfcReturn the angle in radians represented by this normalized quaternion rotation.This quaternion must be
normalized.- Specified by:
anglein interfaceQuaternionfc- Returns:
- the angle in radians
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the given destination matrix to the rotation represented bythis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- the matrix to write the rotation into- Returns:
- the passed in destination
- See Also:
-
get
Description copied from interface:QuaternionfcSet the givenAxisAngle4fto represent the rotation ofthisquaternion.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- theAxisAngle4fto set- Returns:
- the passed in destination
-
get
Description copied from interface:QuaternionfcSet the givenAxisAngle4dto represent the rotation ofthisquaternion.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- theAxisAngle4dto set- Returns:
- the passed in destination
-
get
Description copied from interface:QuaternionfcSet the givenQuaterniondto the values ofthis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- theQuaterniondto set- Returns:
- the passed in destination
- See Also:
-
get
Set the givenQuaternionfto the values ofthis.- Specified by:
getin interfaceQuaternionfc- Parameters:
dest- theQuaternionfto set- Returns:
- the passed in destination
- See Also:
-
getAsMatrix3f
Description copied from interface:QuaternionfcStore the 3x3 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.This is equivalent to calling:
this.get(new Matrix3f()).get(dest)- Specified by:
getAsMatrix3fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
getAsMatrix3f
Description copied from interface:QuaternionfcStore the 3x3 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.This is equivalent to calling:
this.get(new Matrix3f()).get(dest)- Specified by:
getAsMatrix3fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
getAsMatrix4f
Description copied from interface:QuaternionfcStore the 4x4 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.This is equivalent to calling:
this.get(new Matrix4f()).get(dest)- Specified by:
getAsMatrix4fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
getAsMatrix4f
Description copied from interface:QuaternionfcStore the 4x4 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.This is equivalent to calling:
this.get(new Matrix4f()).get(dest)- Specified by:
getAsMatrix4fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
getAsMatrix4x3f
Description copied from interface:QuaternionfcStore the 4x3 float matrix representation ofthisquaternion in column-major order into the givenByteBuffer.This is equivalent to calling:
this.get(new Matrix4x3f()).get(dest)- Specified by:
getAsMatrix4x3fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
getAsMatrix4x3f
Description copied from interface:QuaternionfcStore the 4x3 float matrix representation ofthisquaternion in column-major order into the givenFloatBuffer.This is equivalent to calling:
this.get(new Matrix4x3f()).get(dest)- Specified by:
getAsMatrix4x3fin interfaceQuaternionfc- Parameters:
dest- the destination buffer- Returns:
- dest
-
set
Set this quaternion to the given values.- Parameters:
x- the new value of xy- the new value of yz- the new value of zw- the new value of w- Returns:
- this
-
set
Set this quaternion to be a copy ofq.- Parameters:
q- theQuaternionfcto copy- Returns:
- this
-
set
Set this quaternion to be a copy ofq.- Parameters:
q- theQuaterniondcto copy- Returns:
- this
-
set
Set this quaternion to a rotation equivalent to the givenAxisAngle4f.- Parameters:
axisAngle- theAxisAngle4f- Returns:
- this
-
set
Set this quaternion to a rotation equivalent to the givenAxisAngle4d.- Parameters:
axisAngle- theAxisAngle4d- Returns:
- this
-
setAngleAxis
Set this quaternion to a rotation equivalent to the supplied axis and angle (in radians).This method assumes that the given rotation axis
(x, y, z)is already normalized- Parameters:
angle- the angle in radiansx- the x-component of the normalized rotation axisy- the y-component of the normalized rotation axisz- the z-component of the normalized rotation axis- Returns:
- this
-
setAngleAxis
Set this quaternion to a rotation equivalent to the supplied axis and angle (in radians).This method assumes that the given rotation axis
(x, y, z)is already normalized- Parameters:
angle- the angle in radiansx- the x-component of the normalized rotation axisy- the y-component of the normalized rotation axisz- the z-component of the normalized rotation axis- Returns:
- this
-
rotationAxis
Set thisQuaternionfto a rotation of the given angle in radians about the supplied axis, all of which are specified via theAxisAngle4f.- Parameters:
axisAngle- theAxisAngle4fgiving the rotation angle in radians and the axis to rotate about- Returns:
- this
- See Also:
-
rotationAxis
Set this quaternion to a rotation of the given angle in radians about the supplied axis.- Parameters:
angle- the rotation angle in radiansaxisX- the x-coordinate of the rotation axisaxisY- the y-coordinate of the rotation axisaxisZ- the z-coordinate of the rotation axis- Returns:
- this
-
rotationAxis
Set this quaternion to a rotation of the given angle in radians about the supplied axis.- Parameters:
angle- the rotation angle in radiansaxis- the axis to rotate about- Returns:
- this
- See Also:
-
rotationX
Set this quaternion to represent a rotation of the given radians about the x axis.- Parameters:
angle- the angle in radians to rotate about the x axis- Returns:
- this
-
rotationY
Set this quaternion to represent a rotation of the given radians about the y axis.- Parameters:
angle- the angle in radians to rotate about the y axis- Returns:
- this
-
rotationZ
Set this quaternion to represent a rotation of the given radians about the z axis.- Parameters:
angle- the angle in radians to rotate about the z axis- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromUnnormalized
Set this quaternion to be a representation of the rotational component of the given matrix.This method assumes that the first three columns of the upper left 3x3 submatrix are no unit vectors.
- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
setFromNormalized
Set this quaternion to be a representation of the rotational component of the given matrix.- Parameters:
mat- the matrix whose rotational component is used to set this quaternion- Returns:
- this
-
fromAxisAngleRad
Set this quaternion to be a representation of the supplied axis and angle (in radians).- Parameters:
axis- the rotation axisangle- the angle in radians- Returns:
- this
-
fromAxisAngleRad
Set this quaternion to be a representation of the supplied axis and angle (in radians).- Parameters:
axisX- the x component of the rotation axisaxisY- the y component of the rotation axisaxisZ- the z component of the rotation axisangle- the angle in radians- Returns:
- this
-
fromAxisAngleDeg
Set this quaternion to be a representation of the supplied axis and angle (in degrees).- Parameters:
axis- the rotation axisangle- the angle in degrees- Returns:
- this
-
fromAxisAngleDeg
Set this quaternion to be a representation of the supplied axis and angle (in degrees).- Parameters:
axisX- the x component of the rotation axisaxisY- the y component of the rotation axisaxisZ- the z component of the rotation axisangle- the angle in radians- Returns:
- this
-
mul
Multiply this quaternion byq.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = T * QSo, this method uses post-multiplication like the matrix classes, resulting in a vector to be transformed by
Qfirst, and then byT.- Parameters:
q- the quaternion to multiplythisby- Returns:
- this
-
mul
Description copied from interface:QuaternionfcMultiply this quaternion byqand store the result indest.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = T * QSo, this method uses post-multiplication like the matrix classes, resulting in a vector to be transformed by
Qfirst, and then byT.- Specified by:
mulin interfaceQuaternionfc- Parameters:
q- the quaternion to multiplythisbydest- will hold the result- Returns:
- dest
-
mul
Multiply this quaternion by the quaternion represented via(qx, qy, qz, qw).If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = T * QSo, this method uses post-multiplication like the matrix classes, resulting in a vector to be transformed by
Qfirst, and then byT.- Parameters:
qx- the x component of the quaternion to multiplythisbyqy- the y component of the quaternion to multiplythisbyqz- the z component of the quaternion to multiplythisbyqw- the w component of the quaternion to multiplythisby- Returns:
- this
-
mul
Description copied from interface:QuaternionfcMultiply this quaternion by the quaternion represented via(qx, qy, qz, qw)and store the result indest.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = T * QSo, this method uses post-multiplication like the matrix classes, resulting in a vector to be transformed by
Qfirst, and then byT.- Specified by:
mulin interfaceQuaternionfc- Parameters:
qx- the x component of the quaternion to multiplythisbyqy- the y component of the quaternion to multiplythisbyqz- the z component of the quaternion to multiplythisbyqw- the w component of the quaternion to multiplythisbydest- will hold the result- Returns:
- dest
-
mul
Multiply this quaternion by the given scalar.This method multiplies all of the four components by the specified scalar.
- Parameters:
f- the factor to multiply all components by- Returns:
- this
-
mul
Description copied from interface:QuaternionfcMultiply this quaternion by the given scalar and store the result indest.This method multiplies all of the four components by the specified scalar.
- Specified by:
mulin interfaceQuaternionfc- Parameters:
f- the factor to multiply all components bydest- will hold the result- Returns:
- dest
-
premul
Pre-multiply this quaternion byq.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = Q * TSo, this method uses pre-multiplication, resulting in a vector to be transformed by
Tfirst, and then byQ.- Parameters:
q- the quaternion to pre-multiplythisby- Returns:
- this
-
premul
Description copied from interface:QuaternionfcPre-multiply this quaternion byqand store the result indest.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = Q * TSo, this method uses pre-multiplication, resulting in a vector to be transformed by
Tfirst, and then byQ.- Specified by:
premulin interfaceQuaternionfc- Parameters:
q- the quaternion to pre-multiplythisbydest- will hold the result- Returns:
- dest
-
premul
Pre-multiply this quaternion by the quaternion represented via(qx, qy, qz, qw).If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = Q * TSo, this method uses pre-multiplication, resulting in a vector to be transformed by
Tfirst, and then byQ.- Parameters:
qx- the x component of the quaternion to multiplythisbyqy- the y component of the quaternion to multiplythisbyqz- the z component of the quaternion to multiplythisbyqw- the w component of the quaternion to multiplythisby- Returns:
- this
-
premul
Description copied from interface:QuaternionfcPre-multiply this quaternion by the quaternion represented via(qx, qy, qz, qw)and store the result indest.If
TisthisandQis the given quaternion, then the resulting quaternionRis:R = Q * TSo, this method uses pre-multiplication, resulting in a vector to be transformed by
Tfirst, and then byQ.- Specified by:
premulin interfaceQuaternionfc- Parameters:
qx- the x component of the quaternion to multiplythisbyqy- the y component of the quaternion to multiplythisbyqz- the z component of the quaternion to multiplythisbyqw- the w component of the quaternion to multiplythisbydest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this quaternion.- Specified by:
transformPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this quaternion.- Specified by:
transformPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this quaternion.- Specified by:
transformPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this quaternion.- Specified by:
transformPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveX
Description copied from interface:QuaternionfcTransform the vector(1, 0, 0)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveXin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this quaternion.- Specified by:
transformPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveY
Description copied from interface:QuaternionfcTransform the vector(0, 1, 0)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveYin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this quaternion.- Specified by:
transformPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this quaternion.Only the first three components of the given 4D vector are modified.
- Specified by:
transformPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this unit quaternion.Only the first three components of the given 4D vector are modified.
This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transformUnitPositiveZ
Description copied from interface:QuaternionfcTransform the vector(0, 0, 1)by this unit quaternion.This method is only applicable when
thisis a unit quaternion.Reference: https://de.mathworks.com/
- Specified by:
transformUnitPositiveZin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transform
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverse
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
- Specified by:
transformInversein interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and modified.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transform- Returns:
- vec
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
Only the first three components of the given 4D vector are being used and set on the destination.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
vec- the vector to transformdest- will hold the result- Returns:
- dest
-
transformUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
transformInverseUnit
Description copied from interface:QuaternionfcTransform the given vector(x, y, z)by the inverse of this unit quaternion and store the result indest.This will apply the rotation described by this quaternion to the given vector.
This method is only applicable when
thisis a unit quaternion.- Specified by:
transformInverseUnitin interfaceQuaternionfc- Parameters:
x- the x coordinate of the vector to transformy- the y coordinate of the vector to transformz- the z coordinate of the vector to transformdest- will hold the result- Returns:
- dest
-
invert
Description copied from interface:QuaternionfcInvert this quaternion and store thenormalizedresult indest.If this quaternion is already normalized, then
Quaternionfc.conjugate(Quaternionf)should be used instead.- Specified by:
invertin interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
- See Also:
-
invert
Invert this quaternion andnormalizeit.If this quaternion is already normalized, then
conjugate()should be used instead.- Returns:
- this
- See Also:
-
div
Description copied from interface:QuaternionfcDividethisquaternion byband store the result indest.The division expressed using the inverse is performed in the following way:
dest = this * b^-1, whereb^-1is the inverse ofb.- Specified by:
divin interfaceQuaternionfc- Parameters:
b- theQuaternionfcto divide this bydest- will hold the result- Returns:
- dest
-
div
Dividethisquaternion byb.The division expressed using the inverse is performed in the following way:
this = this * b^-1, whereb^-1is the inverse ofb.- Parameters:
b- theQuaternionfto divide this by- Returns:
- this
-
conjugate
Conjugate this quaternion.- Returns:
- this
-
conjugate
Description copied from interface:QuaternionfcConjugate this quaternion and store the result indest.- Specified by:
conjugatein interfaceQuaternionfc- Parameters:
dest- will hold the result- Returns:
- dest
-
identity
Set this quaternion to the identity.- Returns:
- this
-
rotateXYZ
Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles using rotation sequenceXYZ.This method is equivalent to calling:
rotateX(angleX).rotateY(angleY).rotateZ(angleZ)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angleX- the angle in radians to rotate about the x axisangleY- the angle in radians to rotate about the y axisangleZ- the angle in radians to rotate about the z axis- Returns:
- this
-
rotateXYZ
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles using rotation sequenceXYZand store the result indest.This method is equivalent to calling:
rotateX(angleX, dest).rotateY(angleY).rotateZ(angleZ)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateXYZin interfaceQuaternionfc- Parameters:
angleX- the angle in radians to rotate about the x axisangleY- the angle in radians to rotate about the y axisangleZ- the angle in radians to rotate about the z axisdest- will hold the result- Returns:
- dest
-
rotateZYX
Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceZYX.This method is equivalent to calling:
rotateZ(angleZ).rotateY(angleY).rotateX(angleX)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angleZ- the angle in radians to rotate about the z axisangleY- the angle in radians to rotate about the y axisangleX- the angle in radians to rotate about the x axis- Returns:
- this
-
rotateZYX
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceZYXand store the result indest.This method is equivalent to calling:
rotateZ(angleZ, dest).rotateY(angleY).rotateX(angleX)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateZYXin interfaceQuaternionfc- Parameters:
angleZ- the angle in radians to rotate about the z axisangleY- the angle in radians to rotate about the y axisangleX- the angle in radians to rotate about the x axisdest- will hold the result- Returns:
- dest
-
rotateYXZ
Apply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceYXZ.This method is equivalent to calling:
rotateY(angleY).rotateX(angleX).rotateZ(angleZ)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angleY- the angle in radians to rotate about the y axisangleX- the angle in radians to rotate about the x axisangleZ- the angle in radians to rotate about the z axis- Returns:
- this
-
rotateYXZ
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the cartesian base unit axes, called the euler angles, using the rotation sequenceYXZand store the result indest.This method is equivalent to calling:
rotateY(angleY, dest).rotateX(angleX).rotateZ(angleZ)If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateYXZin interfaceQuaternionfc- Parameters:
angleY- the angle in radians to rotate about the y axisangleX- the angle in radians to rotate about the x axisangleZ- the angle in radians to rotate about the z axisdest- will hold the result- Returns:
- dest
-
getEulerAnglesXYZ
Description copied from interface:QuaternionfcGet the euler angles in radians in rotation sequenceXYZof this quaternion and store them in the provided parametereulerAngles.The Euler angles are always returned as the angle around X in the
Vector3f.xfield, the angle around Y in theVector3f.yfield and the angle around Z in theVector3f.zfield of the suppliedVector3finstance.- Specified by:
getEulerAnglesXYZin interfaceQuaternionfc- Parameters:
eulerAngles- will hold the euler angles in radians- Returns:
- the passed in vector
-
getEulerAnglesZYX
Description copied from interface:QuaternionfcGet the euler angles in radians in rotation sequenceZYXof this quaternion and store them in the provided parametereulerAngles.The Euler angles are always returned as the angle around X in the
Vector3f.xfield, the angle around Y in theVector3f.yfield and the angle around Z in theVector3f.zfield of the suppliedVector3finstance.- Specified by:
getEulerAnglesZYXin interfaceQuaternionfc- Parameters:
eulerAngles- will hold the euler angles in radians- Returns:
- the passed in vector
-
getEulerAnglesZXY
Description copied from interface:QuaternionfcGet the euler angles in radians in rotation sequenceZXYof this quaternion and store them in the provided parametereulerAngles.The Euler angles are always returned as the angle around X in the
Vector3f.xfield, the angle around Y in theVector3f.yfield and the angle around Z in theVector3f.zfield of the suppliedVector3finstance.- Specified by:
getEulerAnglesZXYin interfaceQuaternionfc- Parameters:
eulerAngles- will hold the euler angles in radians- Returns:
- the passed in vector
-
getEulerAnglesYXZ
Description copied from interface:QuaternionfcGet the euler angles in radians in rotation sequenceYXZof this quaternion and store them in the provided parametereulerAngles.The Euler angles are always returned as the angle around X in the
Vector3f.xfield, the angle around Y in theVector3f.yfield and the angle around Z in theVector3f.zfield of the suppliedVector3finstance.- Specified by:
getEulerAnglesYXZin interfaceQuaternionfc- Parameters:
eulerAngles- will hold the euler angles in radians- Returns:
- the passed in vector
-
lengthSquared
public float lengthSquared()Description copied from interface:QuaternionfcReturn the square of the length of this quaternion.- Specified by:
lengthSquaredin interfaceQuaternionfc- Returns:
- the length
-
rotationXYZ
Set this quaternion from the supplied euler angles (in radians) with rotation order XYZ.This method is equivalent to calling:
rotationX(angleX).rotateY(angleY).rotateZ(angleZ)Reference: this stackexchange answer
- Parameters:
angleX- the angle in radians to rotate about xangleY- the angle in radians to rotate about yangleZ- the angle in radians to rotate about z- Returns:
- this
-
rotationZYX
Set this quaternion from the supplied euler angles (in radians) with rotation order ZYX.This method is equivalent to calling:
rotationZ(angleZ).rotateY(angleY).rotateX(angleX)Reference: this stackexchange answer
- Parameters:
angleX- the angle in radians to rotate about xangleY- the angle in radians to rotate about yangleZ- the angle in radians to rotate about z- Returns:
- this
-
rotationYXZ
Set this quaternion from the supplied euler angles (in radians) with rotation order YXZ.This method is equivalent to calling:
rotationY(angleY).rotateX(angleX).rotateZ(angleZ)Reference: https://en.wikipedia.org
- Parameters:
angleY- the angle in radians to rotate about yangleX- the angle in radians to rotate about xangleZ- the angle in radians to rotate about z- Returns:
- this
-
slerp
Interpolate betweenthisunitquaternion and the specifiedtargetunitquaternion using spherical linear interpolation using the specified interpolation factoralpha.This method resorts to non-spherical linear interpolation when the absolute dot product of
thisandtargetis below1E-6f.- Parameters:
target- the target of the interpolation, which should be reached withalpha = 1.0alpha- the interpolation factor, within[0..1]- Returns:
- this
-
slerp
Description copied from interface:QuaternionfcInterpolate betweenthisunitquaternion and the specifiedtargetunitquaternion using spherical linear interpolation using the specified interpolation factoralpha, and store the result indest.This method resorts to non-spherical linear interpolation when the absolute dot product of
thisandtargetis below1E-6f.Reference: http://fabiensanglard.net
- Specified by:
slerpin interfaceQuaternionfc- Parameters:
target- the target of the interpolation, which should be reached withalpha = 1.0alpha- the interpolation factor, within[0..1]dest- will hold the result- Returns:
- dest
-
slerp
Interpolate between all of the quaternions given inqsvia spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.This method will interpolate between each two successive quaternions via
slerp(Quaternionfc, float)using their relative interpolation weights.This method resorts to non-spherical linear interpolation when the absolute dot product of any two interpolated quaternions is below
1E-6f.Reference: http://gamedev.stackexchange.com/
- Parameters:
qs- the quaternions to interpolate overweights- the weights of each individual quaternion inqsdest- will hold the result- Returns:
- dest
-
scale
Apply scaling to this quaternion, which results in any vector transformed by this quaternion to change its length by the givenfactor.- Parameters:
factor- the scaling factor- Returns:
- this
-
scale
Description copied from interface:QuaternionfcApply scaling to this quaternion, which results in any vector transformed by the quaternion to change its length by the givenfactor, and store the result indest.- Specified by:
scalein interfaceQuaternionfc- Parameters:
factor- the scaling factordest- will hold the result- Returns:
- dest
-
scaling
Set this quaternion to represent scaling, which results in a transformed vector to change its length by the givenfactor.- Parameters:
factor- the scaling factor- Returns:
- this
-
integrate
Integrate the rotation given by the angular velocity(vx, vy, vz)around the x, y and z axis, respectively, with respect to the given elapsed time deltadtand add the differentiate rotation to the rotation represented by this quaternion.This method pre-multiplies the rotation given by
dtand(vx, vy, vz)bythis, so the angular velocities are always relative to the local coordinate system of the rotation represented bythisquaternion.This method is equivalent to calling:
rotateLocal(dt * vx, dt * vy, dt * vz)Reference: http://physicsforgames.blogspot.de/
- Parameters:
dt- the delta timevx- the angular velocity around the x axisvy- the angular velocity around the y axisvz- the angular velocity around the z axis- Returns:
- this
-
integrate
Description copied from interface:QuaternionfcIntegrate the rotation given by the angular velocity(vx, vy, vz)around the x, y and z axis, respectively, with respect to the given elapsed time deltadtand add the differentiate rotation to the rotation represented by this quaternion and store the result intodest.This method pre-multiplies the rotation given by
dtand(vx, vy, vz)bythis, so the angular velocities are always relative to the local coordinate system of the rotation represented bythisquaternion.This method is equivalent to calling:
rotateLocal(dt * vx, dt * vy, dt * vz, dest)Reference: http://physicsforgames.blogspot.de/
- Specified by:
integratein interfaceQuaternionfc- Parameters:
dt- the delta timevx- the angular velocity around the x axisvy- the angular velocity around the y axisvz- the angular velocity around the z axisdest- will hold the result- Returns:
- dest
-
nlerp
Compute a linear (non-spherical) interpolation ofthisand the given quaternionqand store the result inthis.- Parameters:
q- the other quaternionfactor- the interpolation factor. It is between 0.0 and 1.0- Returns:
- this
-
nlerp
Description copied from interface:QuaternionfcCompute a linear (non-spherical) interpolation ofthisand the given quaternionqand store the result indest.Reference: http://fabiensanglard.net
- Specified by:
nlerpin interfaceQuaternionfc- Parameters:
q- the other quaternionfactor- the interpolation factor. It is between 0.0 and 1.0dest- will hold the result- Returns:
- dest
-
nlerp
Interpolate between all of the quaternions given inqsvia non-spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.This method will interpolate between each two successive quaternions via
nlerp(Quaternionfc, float)using their relative interpolation weights.Reference: http://gamedev.stackexchange.com/
- Parameters:
qs- the quaternions to interpolate overweights- the weights of each individual quaternion inqsdest- will hold the result- Returns:
- dest
-
nlerpIterative
public Quaternionf nlerpIterative(Quaternionfc q, float alpha, float dotThreshold, Quaternionf dest) Description copied from interface:QuaternionfcCompute linear (non-spherical) interpolations ofthisand the given quaternionqiteratively and store the result indest.This method performs a series of small-step nlerp interpolations to avoid doing a costly spherical linear interpolation, like
slerp, by subdividing the rotation arc betweenthisandqvia non-spherical linear interpolations as long as the absolute dot product ofthisandqis greater than the givendotThresholdparameter.Thanks to
@theagentdat http://www.java-gaming.org/ for providing the code.- Specified by:
nlerpIterativein interfaceQuaternionfc- Parameters:
q- the other quaternionalpha- the interpolation factor, between 0.0 and 1.0dotThreshold- the threshold for the dot product ofthisandqabove which this method performs another iteration of a small-step linear interpolationdest- will hold the result- Returns:
- dest
-
nlerpIterative
Compute linear (non-spherical) interpolations ofthisand the given quaternionqiteratively and store the result inthis.This method performs a series of small-step nlerp interpolations to avoid doing a costly spherical linear interpolation, like
slerp, by subdividing the rotation arc betweenthisandqvia non-spherical linear interpolations as long as the absolute dot product ofthisandqis greater than the givendotThresholdparameter.Thanks to
@theagentdat http://www.java-gaming.org/ for providing the code.- Parameters:
q- the other quaternionalpha- the interpolation factor, between 0.0 and 1.0dotThreshold- the threshold for the dot product ofthisandqabove which this method performs another iteration of a small-step linear interpolation- Returns:
- this
-
nlerpIterative
public static Quaternionfc nlerpIterative(Quaternionf[] qs, float[] weights, float dotThreshold, Quaternionf dest) Interpolate between all of the quaternions given inqsvia iterative non-spherical linear interpolation using the specified interpolation factorsweights, and store the result indest.This method will interpolate between each two successive quaternions via
nlerpIterative(Quaternionfc, float, float)using their relative interpolation weights.Reference: http://gamedev.stackexchange.com/
- Parameters:
qs- the quaternions to interpolate overweights- the weights of each individual quaternion inqsdotThreshold- the threshold for the dot product of each two interpolated quaternions above whichnlerpIterative(Quaternionfc, float, float)performs another iteration of a small-step linear interpolationdest- will hold the result- Returns:
- dest
-
lookAlong
Apply a rotation to this quaternion that maps the given direction to the positive Z axis.Because there are multiple possibilities for such a rotation, this method will choose the one that ensures the given up direction to remain parallel to the plane spanned by the
upanddirvectors.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!Reference: http://answers.unity3d.com
- Parameters:
dir- the direction to map to the positive Z axisup- the vector which will be mapped to a vector parallel to the plane spanned by the givendirandup- Returns:
- this
- See Also:
-
lookAlong
Description copied from interface:QuaternionfcApply a rotation to this quaternion that maps the given direction to the positive Z axis, and store the result indest.Because there are multiple possibilities for such a rotation, this method will choose the one that ensures the given up direction to remain parallel to the plane spanned by the
upanddirvectors.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!Reference: http://answers.unity3d.com
- Specified by:
lookAlongin interfaceQuaternionfc- Parameters:
dir- the direction to map to the positive Z axisup- the vector which will be mapped to a vector parallel to the plane spanned by the givendirandupdest- will hold the result- Returns:
- dest
- See Also:
-
lookAlong
Apply a rotation to this quaternion that maps the given direction to the positive Z axis.Because there are multiple possibilities for such a rotation, this method will choose the one that ensures the given up direction to remain parallel to the plane spanned by the
upanddirvectors.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!Reference: http://answers.unity3d.com
- Parameters:
dirX- the x-coordinate of the direction to look alongdirY- the y-coordinate of the direction to look alongdirZ- the z-coordinate of the direction to look alongupX- the x-coordinate of the up vectorupY- the y-coordinate of the up vectorupZ- the z-coordinate of the up vector- Returns:
- this
- See Also:
-
lookAlong
public Quaternionf lookAlong(float dirX, float dirY, float dirZ, float upX, float upY, float upZ, Quaternionf dest) Description copied from interface:QuaternionfcApply a rotation to this quaternion that maps the given direction to the positive Z axis, and store the result indest.Because there are multiple possibilities for such a rotation, this method will choose the one that ensures the given up direction to remain parallel to the plane spanned by the
upanddirvectors.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!Reference: http://answers.unity3d.com
- Specified by:
lookAlongin interfaceQuaternionfc- Parameters:
dirX- the x-coordinate of the direction to look alongdirY- the y-coordinate of the direction to look alongdirZ- the z-coordinate of the direction to look alongupX- the x-coordinate of the up vectorupY- the y-coordinate of the up vectorupZ- the z-coordinate of the up vectordest- will hold the result- Returns:
- dest
-
rotationTo
public Quaternionf rotationTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ) Setthisquaternion to a rotation that rotates thefromDirvector to point alongtoDir.Since there can be multiple possible rotations, this method chooses the one with the shortest arc.
Reference: stackoverflow.com
- Parameters:
fromDirX- the x-coordinate of the direction to rotate into the destination directionfromDirY- the y-coordinate of the direction to rotate into the destination directionfromDirZ- the z-coordinate of the direction to rotate into the destination directiontoDirX- the x-coordinate of the direction to rotate totoDirY- the y-coordinate of the direction to rotate totoDirZ- the z-coordinate of the direction to rotate to- Returns:
- this
-
rotationTo
Setthisquaternion to a rotation that rotates thefromDirvector to point alongtoDir.Because there can be multiple possible rotations, this method chooses the one with the shortest arc.
- Parameters:
fromDir- the starting directiontoDir- the destination direction- Returns:
- this
- See Also:
-
rotateTo
public Quaternionf rotateTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ, Quaternionf dest) Description copied from interface:QuaternionfcApply a rotation tothisthat rotates thefromDirvector to point alongtoDirand store the result indest.Since there can be multiple possible rotations, this method chooses the one with the shortest arc.
If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!Reference: stackoverflow.com
- Specified by:
rotateToin interfaceQuaternionfc- Parameters:
fromDirX- the x-coordinate of the direction to rotate into the destination directionfromDirY- the y-coordinate of the direction to rotate into the destination directionfromDirZ- the z-coordinate of the direction to rotate into the destination directiontoDirX- the x-coordinate of the direction to rotate totoDirY- the y-coordinate of the direction to rotate totoDirZ- the z-coordinate of the direction to rotate todest- will hold the result- Returns:
- dest
-
rotateTo
public Quaternionf rotateTo(float fromDirX, float fromDirY, float fromDirZ, float toDirX, float toDirY, float toDirZ) Apply a rotation tothisthat rotates thefromDirvector to point alongtoDir.Since there can be multiple possible rotations, this method chooses the one with the shortest arc.
If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
fromDirX- the x-coordinate of the direction to rotate into the destination directionfromDirY- the y-coordinate of the direction to rotate into the destination directionfromDirZ- the z-coordinate of the direction to rotate into the destination directiontoDirX- the x-coordinate of the direction to rotate totoDirY- the y-coordinate of the direction to rotate totoDirZ- the z-coordinate of the direction to rotate to- Returns:
- this
- See Also:
-
rotateTo
Description copied from interface:QuaternionfcApply a rotation tothisthat rotates thefromDirvector to point alongtoDirand store the result indest.Because there can be multiple possible rotations, this method chooses the one with the shortest arc.
If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateToin interfaceQuaternionfc- Parameters:
fromDir- the starting directiontoDir- the destination directiondest- will hold the result- Returns:
- dest
- See Also:
-
rotateTo
Apply a rotation tothisthat rotates thefromDirvector to point alongtoDir.Because there can be multiple possible rotations, this method chooses the one with the shortest arc.
If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
fromDir- the starting directiontoDir- the destination direction- Returns:
- this
- See Also:
-
rotateX
Apply a rotation tothisquaternion rotating the given radians about the x axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angle- the angle in radians to rotate about the x axis- Returns:
- this
-
rotateX
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the x axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateXin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the x axisdest- will hold the result- Returns:
- dest
-
rotateY
Apply a rotation tothisquaternion rotating the given radians about the y axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angle- the angle in radians to rotate about the y axis- Returns:
- this
-
rotateY
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the y axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateYin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the y axisdest- will hold the result- Returns:
- dest
-
rotateZ
Apply a rotation tothisquaternion rotating the given radians about the z axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angle- the angle in radians to rotate about the z axis- Returns:
- this
-
rotateZ
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the z axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateZin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the z axisdest- will hold the result- Returns:
- dest
-
rotateLocalX
Apply a rotation tothisquaternion rotating the given radians about the local x axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Parameters:
angle- the angle in radians to rotate about the local x axis- Returns:
- this
-
rotateLocalX
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the local x axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Specified by:
rotateLocalXin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the local x axisdest- will hold the result- Returns:
- dest
-
rotateLocalY
Apply a rotation tothisquaternion rotating the given radians about the local y axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Parameters:
angle- the angle in radians to rotate about the local y axis- Returns:
- this
-
rotateLocalY
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the local y axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Specified by:
rotateLocalYin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the local y axisdest- will hold the result- Returns:
- dest
-
rotateLocalZ
Apply a rotation tothisquaternion rotating the given radians about the local z axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Parameters:
angle- the angle in radians to rotate about the local z axis- Returns:
- this
-
rotateLocalZ
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the local z axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beR * Q. So when transforming a vectorvwith the new quaternion by usingR * Q * v, the rotation represented bythiswill be applied first!- Specified by:
rotateLocalZin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the local z axisdest- will hold the result- Returns:
- dest
-
rotateAxis
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the specified axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateAxisin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the specified axisaxisX- the x coordinate of the rotation axisaxisY- the y coordinate of the rotation axisaxisZ- the z coordinate of the rotation axisdest- will hold the result- Returns:
- dest
-
rotateAxis
Description copied from interface:QuaternionfcApply a rotation tothisquaternion rotating the given radians about the specified axis and store the result indest.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Specified by:
rotateAxisin interfaceQuaternionfc- Parameters:
angle- the angle in radians to rotate about the specified axisaxis- the rotation axisdest- will hold the result- Returns:
- dest
- See Also:
-
rotateAxis
Apply a rotation tothisquaternion rotating the given radians about the specified axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angle- the angle in radians to rotate about the specified axisaxis- the rotation axis- Returns:
- this
- See Also:
-
rotateAxis
Apply a rotation tothisquaternion rotating the given radians about the specified axis.If
Qisthisquaternion andRthe quaternion representing the specified rotation, then the new quaternion will beQ * R. So when transforming a vectorvwith the new quaternion by usingQ * R * v, the rotation added by this method will be applied first!- Parameters:
angle- the angle in radians to rotate about the specified axisaxisX- the x coordinate of the rotation axisaxisY- the y coordinate of the rotation axisaxisZ- the z coordinate of the rotation axis- Returns:
- this
- See Also:
-
toString
Return a string representation of this quaternion.This method creates a new
DecimalFormaton every invocation with the format string "0.000E0;-". -
toString
Return a string representation of this quaternion by formatting the components with the givenNumberFormat.- Parameters:
formatter- theNumberFormatused to format the quaternion components with- Returns:
- the string representation
-
writeExternal
- Specified by:
writeExternalin interfaceExternalizable- Throws:
IOException
-
readExternal
- Specified by:
readExternalin interfaceExternalizable- Throws:
IOExceptionClassNotFoundException
-
hashCode
public int hashCode() -
equals
-
difference
Compute the difference betweenthisand theotherquaternion and store the result inthis.The difference is the rotation that has to be applied to get from
thisrotation toother. IfTisthis,QisotherandDis the computed difference, then the following equation holds:T * D = QIt is defined as:
D = T^-1 * Q, whereT^-1denotes theinverseofT.- Parameters:
other- the other quaternion- Returns:
- this
-
difference
Description copied from interface:QuaternionfcCompute the difference betweenthisand theotherquaternion and store the result indest.The difference is the rotation that has to be applied to get from
thisrotation toother. IfTisthis,QisotherandDis the computed difference, then the following equation holds:T * D = QIt is defined as:
D = T^-1 * Q, whereT^-1denotes theinverseofT.- Specified by:
differencein interfaceQuaternionfc- Parameters:
other- the other quaterniondest- will hold the result- Returns:
- dest
-
positiveX
Description copied from interface:QuaternionfcObtain the direction of+Xbefore the rotation transformation represented bythisquaternion is applied.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).invert(); inv.transform(dir.set(1, 0, 0));
- Specified by:
positiveXin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+X- Returns:
- dir
-
normalizedPositiveX
Description copied from interface:QuaternionfcObtain the direction of+Xbefore the rotation transformation represented bythisnormalized quaternion is applied. The quaternion must benormalizedfor this method to work.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).conjugate(); inv.transform(dir.set(1, 0, 0));
- Specified by:
normalizedPositiveXin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+X- Returns:
- dir
-
positiveY
Description copied from interface:QuaternionfcObtain the direction of+Ybefore the rotation transformation represented bythisquaternion is applied.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).invert(); inv.transform(dir.set(0, 1, 0));
- Specified by:
positiveYin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+Y- Returns:
- dir
-
normalizedPositiveY
Description copied from interface:QuaternionfcObtain the direction of+Ybefore the rotation transformation represented bythisnormalized quaternion is applied. The quaternion must benormalizedfor this method to work.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).conjugate(); inv.transform(dir.set(0, 1, 0));
- Specified by:
normalizedPositiveYin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+Y- Returns:
- dir
-
positiveZ
Description copied from interface:QuaternionfcObtain the direction of+Zbefore the rotation transformation represented bythisquaternion is applied.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).invert(); inv.transform(dir.set(0, 0, 1));
- Specified by:
positiveZin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+Z- Returns:
- dir
-
normalizedPositiveZ
Description copied from interface:QuaternionfcObtain the direction of+Zbefore the rotation transformation represented bythisnormalized quaternion is applied. The quaternion must benormalizedfor this method to work.This method is equivalent to the following code:
Quaternionf inv = new Quaternionf(this).conjugate(); inv.transform(dir.set(0, 0, 1));
- Specified by:
normalizedPositiveZin interfaceQuaternionfc- Parameters:
dir- will hold the direction of+Z- Returns:
- dir
-
conjugateBy
Conjugatethisby the given quaternionqby computingq * this * q^-1.- Parameters:
q- theQuaternionfcto conjugatethisby- Returns:
- this
-
conjugateBy
Conjugatethisby the given quaternionqby computingq * this * q^-1and store the result intodest.- Specified by:
conjugateByin interfaceQuaternionfc- Parameters:
q- theQuaternionfcto conjugatethisbydest- will hold the result- Returns:
- dest
-
isFinite
public boolean isFinite()Description copied from interface:QuaternionfcDetermine whether all components are finite floating-point values, that is, they are notNaNand notinfinity.- Specified by:
isFinitein interfaceQuaternionfc- Returns:
trueif all components are finite floating-point values;falseotherwise
-
equals
Description copied from interface:QuaternionfcCompare the quaternion components ofthisquaternion with the given quaternion using the givendeltaand return whether all of them are equal within a maximum difference ofdelta.Please note that this method is not used by any data structure such as
ArrayListHashSetorHashMapand their operations, such asArrayList.contains(Object)orHashSet.remove(Object), since those data structures only use theObject.equals(Object)andObject.hashCode()methods.- Specified by:
equalsin interfaceQuaternionfc- Parameters:
q- the other quaterniondelta- the allowed maximum difference- Returns:
truewhether all of the quaternion components are equal;falseotherwise
-
equals
public boolean equals(float x, float y, float z, float w) - Specified by:
equalsin interfaceQuaternionfc- Parameters:
x- the x component to compare toy- the y component to compare toz- the z component to compare tow- the w component to compare to- Returns:
trueif all the quaternion components are equal
-
clone
- Overrides:
clonein classObject- Throws:
CloneNotSupportedException
-