QQuaternion Class Reference

The QQuaternion class represents a quaternion consisting of a vector and scalar. More...

#include <qquaternion.h>

Public Functions
QQuaternion	conjugate () const
	Returns the conjugate of this quaternion, which is (-x, -y, -z, scalar). More...
bool	isIdentity () const
	Returns true if the x, y, and z components of this quaternion are set to 0. More...
bool	isNull () const
	Returns true if the x, y, z, and scalar components of this quaternion are set to 0. More...
qreal	length () const
	Returns the length of the quaternion. More...
qreal	lengthSquared () const
	Returns the squared length of the quaternion. More...
void	normalize ()
	Normalizes the currect quaternion in place. More...
QQuaternion	normalized () const
	Returns the normalized unit form of this quaternion. More...
	operator QVariant () const
	Returns the quaternion as a QVariant. More...
QQuaternion &	operator*= (qreal factor)
	Multiplies this quaternion's components by the given factor, and returns a reference to this quaternion. More...
QQuaternion &	operator*= (const QQuaternion &quaternion)
	Multiplies this quaternion by quaternion and returns a reference to this quaternion. More...
QQuaternion &	operator+= (const QQuaternion &quaternion)
	Adds the given quaternion to this quaternion and returns a reference to this quaternion. More...
QQuaternion &	operator-= (const QQuaternion &quaternion)
	Subtracts the given quaternion from this quaternion and returns a reference to this quaternion. More...
QQuaternion &	operator/= (qreal divisor)
	Divides this quaternion's components by the given divisor, and returns a reference to this quaternion. More...
	QQuaternion ()
	Constructs an identity quaternion, i. More...
	QQuaternion (qreal scalar, qreal xpos, qreal ypos, qreal zpos)
	Constructs a quaternion with the vector (xpos, ypos, zpos) and scalar. More...
	QQuaternion (qreal scalar, const QVector3D &vector)
	Constructs a quaternion vector from the specified vector and scalar. More...
	QQuaternion (const QVector4D &vector)
	Constructs a quaternion from the components of vector. More...
QVector3D	rotatedVector (const QVector3D &vector) const
	Rotates vector with this quaternion to produce a new vector in 3D space. More...
qreal	scalar () const
	Returns the scalar component of this quaternion. More...
void	setScalar (qreal scalar)
	Sets the scalar component of this quaternion to scalar. More...
void	setVector (const QVector3D &vector)
	Sets the vector component of this quaternion to vector. More...
void	setVector (qreal x, qreal y, qreal z)
	Sets the vector component of this quaternion to (x, y, z). More...
void	setX (qreal x)
	Sets the x coordinate of this quaternion's vector to the given x coordinate. More...
void	setY (qreal y)
	Sets the y coordinate of this quaternion's vector to the given y coordinate. More...
void	setZ (qreal z)
	Sets the z coordinate of this quaternion's vector to the given z coordinate. More...
QVector4D	toVector4D () const
	Returns this quaternion as a 4D vector. More...
QVector3D	vector () const
	Returns the vector component of this quaternion. More...
qreal	x () const
	Returns the x coordinate of this quaternion's vector. More...
qreal	y () const
	Returns the y coordinate of this quaternion's vector. More...
qreal	z () const
	Returns the z coordinate of this quaternion's vector. More...

Static Public Functions
static QQuaternion	fromAxisAndAngle (const QVector3D &axis, qreal angle)
	Creates a normalized quaternion that corresponds to rotating through angle degrees about the specified 3D axis. More...
static QQuaternion	fromAxisAndAngle (qreal x, qreal y, qreal z, qreal angle)
	Creates a normalized quaternion that corresponds to rotating through angle degrees about the 3D axis (x, y, z). More...
static QQuaternion	nlerp (const QQuaternion &q1, const QQuaternion &q2, qreal t)
	Interpolates along the shortest linear path between the rotational positions q1 and q2. More...
static QQuaternion	slerp (const QQuaternion &q1, const QQuaternion &q2, qreal t)
	Interpolates along the shortest spherical path between the rotational positions q1 and q2. More...

Properties
qreal	wp
qreal	xp
qreal	yp
qreal	zp

Friends
bool	operator!= (const QQuaternion &q1, const QQuaternion &q2)
	Returns true if q1 is not equal to q2; otherwise returns false. More...
const QQuaternion	operator* (qreal factor, const QQuaternion &quaternion)
const QQuaternion	operator* (const QQuaternion &quaternion, qreal factor)
const QQuaternion	operator* (const QQuaternion &q1, const QQuaternion &q2)
const QQuaternion	operator+ (const QQuaternion &q1, const QQuaternion &q2)
	Returns a QQuaternion object that is the sum of the given quaternions, q1 and q2; each component is added separately. More...
const QQuaternion	operator- (const QQuaternion &q1, const QQuaternion &q2)
	Returns a QQuaternion object that is formed by subtracting q2 from q1; each component is subtracted separately. More...
const QQuaternion	operator- (const QQuaternion &quaternion)
	Returns a QQuaternion object that is formed by changing the sign of all three components of the given quaternion. More...
const QQuaternion	operator/ (const QQuaternion &quaternion, qreal divisor)
	Returns the QQuaternion object formed by dividing all components of the given quaternion by the given divisor. More...
bool	operator== (const QQuaternion &q1, const QQuaternion &q2)
	Returns true if q1 is equal to q2; otherwise returns false. More...
bool	qFuzzyCompare (const QQuaternion &q1, const QQuaternion &q2)
	Returns true if q1 and q2 are equal, allowing for a small fuzziness factor for floating-point comparisons; false otherwise. More...

Related Functions
(Note that these are not member functions.)
QDataStream &	operator<< (QDataStream &stream, const QQuaternion &quaternion)
	Writes the given quaternion to the given stream and returns a reference to the stream. More...
QDataStream &	operator>> (QDataStream &stream, QQuaternion &quaternion)
	Reads a quaternion from the given stream into the given quaternion and returns a reference to the stream. More...
QDataStream &	operator>> (QDataStream &stream, QEasingCurve &easing)
	Reads an easing curve from the given stream into the given easing curve and returns a reference to the stream. More...

Detailed Description

The QQuaternion class represents a quaternion consisting of a vector and scalar.

Since

4.6

Quaternions are used to represent rotations in 3D space, and consist of a 3D rotation axis specified by the x, y, and z coordinates, and a scalar representing the rotation angle.

Definition at line 59 of file qquaternion.h.

Constructors and Destructors

QQuaternion() [1/4]

QQuaternion::QQuaternion ( )

inline

Constructs an identity quaternion, i.

e. with coordinates (1, 0, 0, 0).

Definition at line 141 of file qquaternion.h.

Referenced by conjugate(), fromAxisAndAngle(), normalized(), operator*(), operator+(), operator-(), operator/(), and rotatedVector().

: wp(1.0f), xp(0.0f), yp(0.0f), zp(0.0f) {}

QQuaternion() [2/4]

QQuaternion::QQuaternion ( qreal  scalar, qreal  xpos, qreal  ypos, qreal  zpos  )

inline

Constructs a quaternion with the vector (xpos, ypos, zpos) and scalar.

Definition at line 143 of file qquaternion.h.

: wp(aScalar), xp(xpos), yp(ypos), zp(zpos) {}

QQuaternion() [3/4]

QQuaternion::QQuaternion ( qreal  scalar, const QVector3D &  vector  )

inline

Constructs a quaternion vector from the specified vector and scalar.

See also

vector(), scalar()

Definition at line 279 of file qquaternion.h.

    : wp(aScalar), xp(aVector.x()), yp(aVector.y()), zp(aVector.z()) {}

QQuaternion() [4/4]

QQuaternion::QQuaternion ( const QVector4D &  vector )

inlineexplicit

Constructs a quaternion from the components of vector.

Definition at line 305 of file qquaternion.h.

    : wp(aVector.w()), xp(aVector.x()), yp(aVector.y()), zp(aVector.z()) {}

Functions

conjugate()

QQuaternion QQuaternion::conjugate ( ) const

inline

Returns the conjugate of this quaternion, which is (-x, -y, -z, scalar).

Definition at line 166 of file qquaternion.h.

Referenced by rotatedVector().

{
    return QQuaternion(wp, -xp, -yp, -zp);
}

fromAxisAndAngle() [1/2]

QQuaternion QQuaternion::fromAxisAndAngle ( const QVector3D &  axis, qreal  angle  )

static

Creates a normalized quaternion that corresponds to rotating through angle degrees about the specified 3D axis.

Definition at line 420 of file qquaternion.cpp.

{
    // Algorithm from:
    // http://www.j3d.org/matrix_faq/matrfaq_latest.html#Q56
    // We normalize the result just in case the values are close
    // to zero, as suggested in the above FAQ.
    qreal a = (angle / 2.0f) * M_PI / 180.0f;
    qreal s = qSin(a);
    qreal c = qCos(a);
    QVector3D ax = axis.normalized();
    return QQuaternion(c, ax.x() * s, ax.y() * s, ax.z() * s).normalized();
}

fromAxisAndAngle() [2/2]

QQuaternion QQuaternion::fromAxisAndAngle ( qreal  x, qreal  y, qreal  z, qreal  angle  )

static

Creates a normalized quaternion that corresponds to rotating through angle degrees about the 3D axis (x, y, z).

Definition at line 440 of file qquaternion.cpp.

{
    qreal length = qSqrt(x * x + y * y + z * z);
    if (!qFuzzyIsNull(length - 1.0f) && !qFuzzyIsNull(length)) {
        x /= length;
        y /= length;
        z /= length;
    }
    qreal a = (angle / 2.0f) * M_PI / 180.0f;
    qreal s = qSin(a);
    qreal c = qCos(a);
    return QQuaternion(c, x * s, y * s, z * s).normalized();
}

isIdentity()

bool QQuaternion::isIdentity ( ) const

inline

Returns true if the x, y, and z components of this quaternion are set to 0.

0, and the scalar component is set to 1.0; otherwise returns false.

Definition at line 151 of file qquaternion.h.

{
    return qIsNull(xp) && qIsNull(yp) && qIsNull(zp) && wp == 1.0f;
}

isNull()

bool QQuaternion::isNull ( ) const

inline

Returns true if the x, y, z, and scalar components of this quaternion are set to 0.

0; otherwise returns false.

Definition at line 146 of file qquaternion.h.

{
    return qIsNull(xp) && qIsNull(yp) && qIsNull(zp) && qIsNull(wp);
}

length()

qreal QQuaternion::length

(

)

const

Returns the length of the quaternion.

This is also called the "norm".

See also

lengthSquared(), normalized()

Definition at line 272 of file qquaternion.cpp.

Referenced by fromAxisAndAngle().

{
    return qSqrt(xp * xp + yp * yp + zp * zp + wp * wp);
}

lengthSquared()

qreal QQuaternion::lengthSquared

(

)

const

Returns the squared length of the quaternion.

See also

length()

Definition at line 282 of file qquaternion.cpp.

{
    return xp * xp + yp * yp + zp * zp + wp * wp;
}

nlerp()

QQuaternion QQuaternion::nlerp ( const QQuaternion &  q1, const QQuaternion &  q2, qreal  t  )

static

Interpolates along the shortest linear path between the rotational positions q1 and q2.

The value t should be between 0 and 1, indicating the distance to travel between q1 and q2. The result will be normalized().

If t is less than or equal to 0, then q1 will be returned. If t is greater than or equal to 1, then q2 will be returned.

The nlerp() function is typically faster than slerp() and will give approximate results to spherical interpolation that are good enough for some applications.

See also

slerp()

Definition at line 635 of file qquaternion.cpp.

Referenced by slerp().

{
    // Handle the easy cases first.
    if (t <= 0.0f)
        return q1;
    else if (t >= 1.0f)
        return q2;

    // Determine the angle between the two quaternions.
    QQuaternion q2b;
    qreal dot;
    dot = q1.xp * q2.xp + q1.yp * q2.yp + q1.zp * q2.zp + q1.wp * q2.wp;
    if (dot >= 0.0f)
        q2b = q2;
    else
        q2b = -q2;

    // Perform the linear interpolation.
    return (q1 * (1.0f - t) + q2b * t).normalized();
}

normalize()

void QQuaternion::normalize

(

)

Normalizes the currect quaternion in place.

Nothing happens if this is a null quaternion or the length of the quaternion is very close to 1.

See also

length(), normalized()

Definition at line 318 of file qquaternion.cpp.

{
    // Need some extra precision if the length is very small.
    double len = double(xp) * double(xp) +
                 double(yp) * double(yp) +
                 double(zp) * double(zp) +
                 double(wp) * double(wp);
    if (qFuzzyIsNull(len - 1.0f) || qFuzzyIsNull(len))
        return;

    len = qSqrt(len);

    xp /= len;
    yp /= len;
    zp /= len;
    wp /= len;
}

normalized()

QQuaternion QQuaternion::normalized

(

)

const

Returns the normalized unit form of this quaternion.

If this quaternion is null, then a null quaternion is returned. If the length of the quaternion is very close to 1, then the quaternion will be returned as-is. Otherwise the normalized form of the quaternion of length 1 will be returned.

See also

length(), normalize()

Definition at line 297 of file qquaternion.cpp.

Referenced by fromAxisAndAngle(), and nlerp().

{
    // Need some extra precision if the length is very small.
    double len = double(xp) * double(xp) +
                 double(yp) * double(yp) +
                 double(zp) * double(zp) +
                 double(wp) * double(wp);
    if (qFuzzyIsNull(len - 1.0f))
        return *this;
    else if (!qFuzzyIsNull(len))
        return *this / qSqrt(len);
    else
        return QQuaternion(0.0f, 0.0f, 0.0f, 0.0f);
}

operator QVariant()

QQuaternion::operator QVariant

(

)

const

Returns the quaternion as a QVariant.

Definition at line 659 of file qquaternion.cpp.

{
    return QVariant(QVariant::Quaternion, this);
}

operator*=() [1/2]

QQuaternion & QQuaternion::operator*= ( qreal  factor )

inline

Multiplies this quaternion's components by the given factor, and returns a reference to this quaternion.

See also

operator/=()

Definition at line 189 of file qquaternion.h.

{
    xp *= factor;
    yp *= factor;
    zp *= factor;
    wp *= factor;
    return *this;
}

operator*=() [2/2]

QQuaternion & QQuaternion::operator*= ( const QQuaternion &  quaternion )

inline

Multiplies this quaternion by quaternion and returns a reference to this quaternion.

Definition at line 214 of file qquaternion.h.

{
    *this = *this * quaternion;
    return *this;
}

operator+=()

QQuaternion & QQuaternion::operator+= ( const QQuaternion &  quaternion )

inline

Adds the given quaternion to this quaternion and returns a reference to this quaternion.

See also

operator-=()

Definition at line 171 of file qquaternion.h.

{
    xp += quaternion.xp;
    yp += quaternion.yp;
    zp += quaternion.zp;
    wp += quaternion.wp;
    return *this;
}

operator-=()

QQuaternion & QQuaternion::operator-= ( const QQuaternion &  quaternion )

inline

Subtracts the given quaternion from this quaternion and returns a reference to this quaternion.

See also

operator+=()

Definition at line 180 of file qquaternion.h.

{
    xp -= quaternion.xp;
    yp -= quaternion.yp;
    zp -= quaternion.zp;
    wp -= quaternion.wp;
    return *this;
}

operator/=()

QQuaternion & QQuaternion::operator/= ( qreal  divisor )

inline

Divides this quaternion's components by the given divisor, and returns a reference to this quaternion.

See also

operator*=()

Definition at line 220 of file qquaternion.h.

{
    xp /= divisor;
    yp /= divisor;
    zp /= divisor;
    wp /= divisor;
    return *this;
}

rotatedVector()

QVector3D QQuaternion::rotatedVector

(

const QVector3D &

vector

)

const

Rotates vector with this quaternion to produce a new vector in 3D space.

The following code:

QVector3D result = q.rotatedVector(vector);

is equivalent to the following:

QVector3D result = (q * QQuaternion(0, vector) * q.conjugate()).vector();

Definition at line 360 of file qquaternion.cpp.

{
    return (*this * QQuaternion(0, vector) * conjugate()).vector();
}

scalar()

qreal QQuaternion::scalar ( ) const

inline

Returns the scalar component of this quaternion.

See also

setScalar(), x(), y(), z()

Definition at line 159 of file qquaternion.h.

Referenced by operator<<(), operator>>(), QMatrix4x4::rotate(), and QDeclarativeQuaternionValueType::setValue().

{ return qreal(wp); }

setScalar()

void QQuaternion::setScalar ( qreal  scalar )

inline

Sets the scalar component of this quaternion to scalar.

See also

scalar(), setX(), setY(), setZ()

Definition at line 164 of file qquaternion.h.

Referenced by operator>>(), and QDeclarativeQuaternionValueType::setScalar().

{ wp = aScalar; }

setVector() [1/2]

void QQuaternion::setVector ( const QVector3D &  vector )

inline

Sets the vector component of this quaternion to vector.

See also

vector(), setScalar()

Definition at line 282 of file qquaternion.h.

{
    xp = aVector.x();
    yp = aVector.y();
    zp = aVector.z();
}

setVector() [2/2]

void QQuaternion::setVector ( qreal  x, qreal  y, qreal  z  )

inline

Sets the vector component of this quaternion to (x, y, z).

See also

vector(), setScalar()

Definition at line 296 of file qquaternion.h.

{
    xp = aX;
    yp = aY;
    zp = aZ;
}

setX()

void QQuaternion::setX ( qreal  x )

inline

Sets the x coordinate of this quaternion's vector to the given x coordinate.

See also

x(), setY(), setZ(), setScalar()

Definition at line 161 of file qquaternion.h.

Referenced by operator>>(), and QDeclarativeQuaternionValueType::setX().

{ xp = aX; }

setY()

void QQuaternion::setY ( qreal  y )

inline

Sets the y coordinate of this quaternion's vector to the given y coordinate.

See also

y(), setX(), setZ(), setScalar()

Definition at line 162 of file qquaternion.h.

Referenced by operator>>(), and QDeclarativeQuaternionValueType::setY().

{ yp = aY; }

setZ()

void QQuaternion::setZ ( qreal  z )

inline

Sets the z coordinate of this quaternion's vector to the given z coordinate.

See also

z(), setX(), setY(), setScalar()

Definition at line 163 of file qquaternion.h.

Referenced by operator>>(), and QDeclarativeQuaternionValueType::setZ().

{ zp = aZ; }

slerp()

QQuaternion QQuaternion::slerp ( const QQuaternion &  q1, const QQuaternion &  q2, qreal  t  )

static

Interpolates along the shortest spherical path between the rotational positions q1 and q2.

The value t should be between 0 and 1, indicating the spherical distance to travel between q1 and q2.

If t is less than or equal to 0, then q1 will be returned. If t is greater than or equal to 1, then q2 will be returned.

See also

nlerp()

Definition at line 583 of file qquaternion.cpp.

Referenced by _q_interpolate(), and fromAxisAndAngle().

{
    // Handle the easy cases first.
    if (t <= 0.0f)
        return q1;
    else if (t >= 1.0f)
        return q2;

    // Determine the angle between the two quaternions.
    QQuaternion q2b;
    qreal dot;
    dot = q1.xp * q2.xp + q1.yp * q2.yp + q1.zp * q2.zp + q1.wp * q2.wp;
    if (dot >= 0.0f) {
        q2b = q2;
    } else {
        q2b = -q2;
        dot = -dot;
    }

    // Get the scale factors.  If they are too small,
    // then revert to simple linear interpolation.
    qreal factor1 = 1.0f - t;
    qreal factor2 = t;
    if ((1.0f - dot) > 0.0000001) {
        qreal angle = qreal(qAcos(dot));
        qreal sinOfAngle = qreal(qSin(angle));
        if (sinOfAngle > 0.0000001) {
            factor1 = qreal(qSin((1.0f - t) * angle)) / sinOfAngle;
            factor2 = qreal(qSin(t * angle)) / sinOfAngle;
        }
    }

    // Construct the result quaternion.
    return q1 * factor1 + q2b * factor2;
}

toVector4D()

QVector4D QQuaternion::toVector4D ( ) const

inline

Returns this quaternion as a 4D vector.

Definition at line 308 of file qquaternion.h.

{
    return QVector4D(xp, yp, zp, wp);
}

vector()

QVector3D QQuaternion::vector ( ) const

inline

Returns the vector component of this quaternion.

See also

setVector(), scalar()

Definition at line 289 of file qquaternion.h.

{
    return QVector3D(xp, yp, zp);
}

x()

qreal QQuaternion::x ( ) const

inline

Returns the x coordinate of this quaternion's vector.

See also

setX(), y(), z(), scalar()

Definition at line 156 of file qquaternion.h.

Referenced by operator*(), operator<<(), operator>>(), QMatrix4x4::rotate(), and QDeclarativeQuaternionValueType::setValue().

{ return qreal(xp); }

y()

qreal QQuaternion::y ( ) const

inline

Returns the y coordinate of this quaternion's vector.

See also

setY(), x(), z(), scalar()

Definition at line 157 of file qquaternion.h.

Referenced by operator*(), operator<<(), operator>>(), QMatrix4x4::rotate(), and QDeclarativeQuaternionValueType::setValue().

{ return qreal(yp); }

z()

qreal QQuaternion::z ( ) const

inline

Returns the z coordinate of this quaternion's vector.

See also

setZ(), x(), y(), scalar()

Definition at line 158 of file qquaternion.h.

Referenced by operator*(), operator<<(), operator>>(), QMatrix4x4::rotate(), and QDeclarativeQuaternionValueType::setValue().

{ return qreal(zp); }

Friends and Related Functions

operator!=

bool operator!= ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Returns true if q1 is not equal to q2; otherwise returns false.

This operator uses an exact floating-point comparison.

Definition at line 234 of file qquaternion.h.

{
    return q1.xp != q2.xp || q1.yp != q2.yp || q1.zp != q2.zp || q1.wp != q2.wp;
}

operator* [1/3]

const QQuaternion operator* ( qreal  factor, const QQuaternion &  quaternion  )

friend

Returns a copy of the given quaternion, multiplied by the given factor.

See also

QQuaternion::operator*=()

Definition at line 249 of file qquaternion.h.

{
    return QQuaternion(quaternion.wp * factor, quaternion.xp * factor, quaternion.yp * factor, quaternion.zp * factor);
}

operator* [2/3]

const QQuaternion operator* ( const QQuaternion &  quaternion, qreal  factor  )

friend

Returns a copy of the given quaternion, multiplied by the given factor.

See also

QQuaternion::operator*=()

Definition at line 254 of file qquaternion.h.

{
    return QQuaternion(quaternion.wp * factor, quaternion.xp * factor, quaternion.yp * factor, quaternion.zp * factor);
}

operator* [3/3]

const QQuaternion operator* ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Multiplies q1 and q2 using quaternion multiplication. The result corresponds to applying both of the rotations specified by q1 and q2.

See also

QQuaternion::operator*=()

Definition at line 198 of file qquaternion.h.

{
    qreal ww = (q1.zp + q1.xp) * (q2.xp + q2.yp);
    qreal yy = (q1.wp - q1.yp) * (q2.wp + q2.zp);
    qreal zz = (q1.wp + q1.yp) * (q2.wp - q2.zp);
    qreal xx = ww + yy + zz;
    qreal qq = 0.5 * (xx + (q1.zp - q1.xp) * (q2.xp - q2.yp));

    qreal w = qq - ww + (q1.zp - q1.yp) * (q2.yp - q2.zp);
    qreal x = qq - xx + (q1.xp + q1.wp) * (q2.xp + q2.wp);
    qreal y = qq - yy + (q1.wp - q1.xp) * (q2.yp + q2.zp);
    qreal z = qq - zz + (q1.zp + q1.yp) * (q2.wp - q2.xp);

    return QQuaternion(w, x, y, z);
}

operator+

const QQuaternion operator+ ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Returns a QQuaternion object that is the sum of the given quaternions, q1 and q2; each component is added separately.

See also

QQuaternion::operator+=()

Definition at line 239 of file qquaternion.h.

{
    return QQuaternion(q1.wp + q2.wp, q1.xp + q2.xp, q1.yp + q2.yp, q1.zp + q2.zp);
}

operator- [1/2]

const QQuaternion operator- ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Returns a QQuaternion object that is formed by subtracting q2 from q1; each component is subtracted separately.

See also

QQuaternion::operator-=()

Definition at line 244 of file qquaternion.h.

{
    return QQuaternion(q1.wp - q2.wp, q1.xp - q2.xp, q1.yp - q2.yp, q1.zp - q2.zp);
}

operator- [2/2]

const QQuaternion operator- ( const QQuaternion &  quaternion )

friend

Returns a QQuaternion object that is formed by changing the sign of all three components of the given quaternion.

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Equivalent to {QQuaternion(0,0,0,0) - quaternion}.

Definition at line 259 of file qquaternion.h.

{
    return QQuaternion(-quaternion.wp, -quaternion.xp, -quaternion.yp, -quaternion.zp);
}

operator/

const QQuaternion operator/ ( const QQuaternion &  quaternion, qreal  divisor  )

friend

Returns the QQuaternion object formed by dividing all components of the given quaternion by the given divisor.

See also

QQuaternion::operator/=()

Definition at line 264 of file qquaternion.h.

{
    return QQuaternion(quaternion.wp / divisor, quaternion.xp / divisor, quaternion.yp / divisor, quaternion.zp / divisor);
}

operator<<()

QDataStream & operator<< ( QDataStream &  stream, const QQuaternion &  quaternion  )

related

Writes the given quaternion to the given stream and returns a reference to the stream.

See also

{Serializing Qt Data Types}

Definition at line 691 of file qquaternion.cpp.

Referenced by toVector4D().

{
    stream << double(quaternion.scalar()) << double(quaternion.x())
           << double(quaternion.y()) << double(quaternion.z());
    return stream;
}

operator==

bool operator== ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Returns true if q1 is equal to q2; otherwise returns false.

This operator uses an exact floating-point comparison.

Definition at line 229 of file qquaternion.h.

{
    return q1.xp == q2.xp && q1.yp == q2.yp && q1.zp == q2.zp && q1.wp == q2.wp;
}

operator>>() [1/2]

QDataStream & operator>> ( QDataStream &  stream, QQuaternion &  quaternion  )

related

Reads a quaternion from the given stream into the given quaternion and returns a reference to the stream.

See also

{Serializing Qt Data Types}

Definition at line 711 of file qquaternion.cpp.

{
    double scalar, x, y, z;
    stream >> scalar;
    stream >> x;
    stream >> y;
    stream >> z;
    quaternion.setScalar(qreal(scalar));
    quaternion.setX(qreal(x));
    quaternion.setY(qreal(y));
    quaternion.setZ(qreal(z));
    return stream;
}

operator>>() [2/2]

QDataStream & operator>> ( QDataStream &  stream, QEasingCurve &  easing  )

related

Reads an easing curve from the given stream into the given easing curve and returns a reference to the stream.

See also

{Serializing Qt Data Types}

Definition at line 925 of file qeasingcurve.cpp.

Referenced by toVector4D().

{
    QEasingCurve::Type type;
    quint8 int_type;
    stream >> int_type;
    type = static_cast<QEasingCurve::Type>(int_type);
    easing.setType(type);

    quint64 ptr_func;
    stream >> ptr_func;
    easing.d_ptr->func = QEasingCurve::EasingFunction(quintptr(ptr_func));

    bool hasConfig;
    stream >> hasConfig;
    if (hasConfig) {
        QEasingCurveFunction *config = curveToFunctionObject(type);
        stream >> config->_p;
        stream >> config->_a;
        stream >> config->_o;
        easing.d_ptr->config = config;
    }
    return stream;
}

qFuzzyCompare

bool qFuzzyCompare ( const QQuaternion &  q1, const QQuaternion &  q2  )

friend

Returns true if q1 and q2 are equal, allowing for a small fuzziness factor for floating-point comparisons; false otherwise.

Definition at line 269 of file qquaternion.h.

Referenced by qFuzzyCompare().

{
    return qFuzzyCompare(q1.xp, q2.xp) &&
           qFuzzyCompare(q1.yp, q2.yp) &&
           qFuzzyCompare(q1.zp, q2.zp) &&
           qFuzzyCompare(q1.wp, q2.wp);
}

Properties

wp

qreal QQuaternion::wp

private

Definition at line 136 of file qquaternion.h.

Referenced by conjugate(), isIdentity(), isNull(), length(), lengthSquared(), nlerp(), normalize(), normalized(), operator!=(), operator*(), operator*=(), operator+(), operator+=(), operator-(), operator-=(), operator/(), operator/=(), operator==(), qFuzzyCompare(), scalar(), setScalar(), slerp(), and toVector4D().

xp

qreal QQuaternion::xp

private

Definition at line 136 of file qquaternion.h.

Referenced by conjugate(), isIdentity(), isNull(), length(), lengthSquared(), nlerp(), normalize(), normalized(), operator!=(), operator*(), operator*=(), operator+(), operator+=(), operator-(), operator-=(), operator/(), operator/=(), operator==(), qFuzzyCompare(), setVector(), setX(), slerp(), toVector4D(), vector(), and x().

yp

qreal QQuaternion::yp

private

Definition at line 136 of file qquaternion.h.

Referenced by conjugate(), isIdentity(), isNull(), length(), lengthSquared(), nlerp(), normalize(), normalized(), operator!=(), operator*(), operator*=(), operator+(), operator+=(), operator-(), operator-=(), operator/(), operator/=(), operator==(), qFuzzyCompare(), setVector(), setY(), slerp(), toVector4D(), vector(), and y().

zp

qreal QQuaternion::zp

private

Definition at line 136 of file qquaternion.h.

Referenced by conjugate(), isIdentity(), isNull(), length(), lengthSquared(), nlerp(), normalize(), normalized(), operator!=(), operator*(), operator*=(), operator+(), operator+=(), operator-(), operator-=(), operator/(), operator/=(), operator==(), qFuzzyCompare(), setVector(), setZ(), slerp(), toVector4D(), vector(), and z().

---

The documentation for this class was generated from the following files:

• /src/gui/math3d/qquaternion.h
• /src/corelib/tools/qeasingcurve.cpp
• /src/gui/math3d/qquaternion.cpp