---

---

AI_Quaternion.h

Go to the documentation of this file.

#ifndef AI_QUATERNION_H
#define AI_QUATERNION_H
//-------------------------------------------------------------------
#include <stdlib.h>
#include <stdio.h>
#include <math.h>
#include "AI_Vector.h"

class AI_Quaternion {
public:
    float x,y,z,w;

    //-- constructors -----------------------------------------------
    AI_Quaternion()
        : x(0.0f), y(0.0f), z(0.0f), w(1.0f)
    {};
    AI_Quaternion(float _x, float _y, float _z, float _w)
        : x(_x), y(_y), z(_z), w(_w)
    {};
    AI_Quaternion(const AI_Quaternion& q)
        : x(q.x), y(q.y), z(q.z), w(q.w)
    {};

    //-- setting elements -------------------------------------------
    void set(float _x, float _y, float _z, float _w) {
        x = _x;
        y = _y;
        z = _z;
        w = _w;
    };
    void set(const AI_Quaternion& q) {
        x = q.x;
        y = q.y;
        z = q.z;
        w = q.w;
    };

    //-- misc operations --------------------------------------------
    void ident(void) {
        x = 0.0f;
        y = 0.0f;
        z = 0.0f;
        w = 1.0f;
    };

    void conjugate(void) {
        x = -x;
        y = -y;
        z = -z;
    };

    void scale(float s) {
        x *= s;
        y *= s;
        z *= s;
        w *= s;
    };

    float norm(void) {
        return x*x + y*y + z*z + w*w;
    };

    float magnitude(void) {
        float n = norm();
        if (n > 0.0f) return ai_sqrt(n);
        else          return 0.0f;
    };

    void invert(void) {
        float n = norm();
        if (n > 0.0f) scale(1.0f / norm());
        conjugate();
    };

    void normalize(void) {
        float l = magnitude();
        if (l > 0.0f) scale(1.0f / l);
        else          set(0.0f,0.0f,0.0f,1.0f);
    };

    //-- operators --------------------------------------------------
    bool operator==(const AI_Quaternion& q) {
        return ((x==q.x) && (y==q.y) && (z==q.z) && (w==q.w)) ? true : false;
    };

    bool operator!=(const AI_Quaternion& q) {
        return ((x!=q.x) || (y!=q.y) || (z!=q.z) || (w!=q.w)) ? true : false;
    };

    const AI_Quaternion& operator+=(const AI_Quaternion& q) {
        x += q.x;
        y += q.y;
        z += q.z;
        w += q.w;
        return *this;
    };

    const AI_Quaternion& operator-=(const AI_Quaternion& q) {
        x -= q.x;
        y -= q.y;
        z -= q.z;
        w -= q.w;
        return *this;
    };

    const AI_Quaternion& operator*=(const AI_Quaternion& q) {
        float qx = w*q.x + x*q.w + y*q.z - z*q.y;
        float qy = w*q.y + y*q.w + z*q.x - x*q.z;
        float qz = w*q.z + z*q.w + x*q.y - y*q.x;
        float qw = w*q.w - x*q.x - y*q.y - z*q.z;
        x = qx;
        y = qy;
        z = qz;
        w = qw;
        return *this;
    };

    AI_Vector3 rotate(const AI_Vector3& v) {
        AI_Quaternion q(v.x * w + v.z * y - v.y * z,
                     v.y * w + v.x * z - v.z * x,
                     v.z * w + v.y * x - v.x * y,
                     v.x * x + v.y * y + v.z * z);

        return AI_Vector3(w * q.x + x * q.w + y * q.z - z * q.y,
                       w * q.y + y * q.w + z * q.x - x * q.z,
                       w * q.z + z * q.w + x * q.y - y * q.x);
    };

    void set_from_axes( const AI_Vector3& from, const AI_Vector3& to )
    {
        AI_Vector3 c(from * to);
        set(c.x, c.y, c.z, from % to);
        w += 1.0f;      // reducing angle to halfangle
        if( w <= AI_TINY ) // angle close to PI
        {
            if ((from.z * from.z) > (from.x * from.x))
                set(0, from.z, -from.y, w);
                //from*AI_Vector3(1,0,0) 
            else 
                set(from.y, -from.x, 0, w);
                //from*AI_Vector3(0,0,1) 
        }
        normalize(); 
    }

    void set_from_axes2( const AI_Vector3& from, const AI_Vector3& to )
    {
        AI_Vector3 c(from * to);
        set(c.x, c.y, c.z, from % to);
        normalize();    // if "from" or "to" not unit, normalize quat
        w += 1.0f;      // reducing angle to halfangle
        if( w <= AI_TINY ) // angle close to PI
        {
            if ((from.z * from.z) > (from.x * from.x))
                set(0, from.z, -from.y, w);
                //from*AI_Vector3(1,0,0) 
            else 
                set(from.y, -from.x, 0, w);
                //from*AI_Vector3(0,0,1) 
        }
        normalize(); 
    }

    //-- convert from euler angles ----------------------------------
    void set_rotate_axis_angle(const AI_Vector3& v, float a) {
        float sin_a = ai_sin(a * 0.5f);
        float cos_a = ai_cos(a * 0.5f);
        x = v.x * sin_a;
        y = v.y * sin_a;
        z = v.z * sin_a;
        w = cos_a;
    };

    void set_rotate_x(float a) {
        float sin_a = ai_sin(a * 0.5f);
        float cos_a = ai_cos(a * 0.5f);
        x = sin_a;
        y = 0.0f;
        z = 0.0f;
        w = cos_a;
    };

    void set_rotate_y(float a) {
        float sin_a = ai_sin(a * 0.5f);
        float cos_a = ai_cos(a * 0.5f);
        x = 0.0f;
        y = sin_a;
        z = 0.0f;
        w = cos_a;
    };

    void set_rotate_z(float a) {
        float sin_a = ai_sin(a * 0.5f);
        float cos_a = ai_cos(a * 0.5f);
        x = 0.0f;
        y = 0.0f;
        z = sin_a;
        w = cos_a;
    };

    void set_rotate_xyz(float ax, float ay, float az) {
        AI_Quaternion qx, qy, qz;
        qx.set_rotate_x(ax);
        qy.set_rotate_y(ay);
        qz.set_rotate_z(az);
        *this = qx;
        *this *= qy;
        *this *= qz;
    };

    //--- fuzzy compare operators -----------------------------------
    bool isequal(const AI_Quaternion& v, float tol) const
    {
        if (fabs(v.x-x) > tol)      return false;
        else if (fabs(v.y-y) > tol) return false;
        else if (fabs(v.z-z) > tol) return false;
        else if (fabs(v.w-w) > tol) return false;
        return true;
    };

    //-- rotation interpolation, set this matrix to the -------------    
    //-- interpolated result of q0->q1 with l as interpolator -------
    void slerp(const AI_Quaternion& q0, const AI_Quaternion& q1, float l) 
    {
        float fScale1;
        float fScale2;
        AI_Quaternion A = q0;
        AI_Quaternion B = q1;

        // compute dot product, aka cos(theta):
        float fCosTheta = A.x*B.x + A.y*B.y + A.z*B.z + A.w*B.w;

        if (fCosTheta < 0.0f) 
        {
            // flip start AI_Quaternion
           A.x = -A.x; A.y = -A.y; A.z = -A.z; A.w = -A.w;
           fCosTheta = -fCosTheta;
        }

        if ((fCosTheta + 1.0f) > 0.05f) 
        {
            // If the quaternions are close, use linear interploation
            if ((1.0f - fCosTheta) < 0.05f) 
            {
                fScale1 = 1.0f - l;
                fScale2 = l;
            }
            else 
            { 
                // Otherwise, do spherical interpolation
                float fTheta    = ai_acos(fCosTheta);
                float fSinTheta = ai_sin(fTheta);
                fScale1 = ai_sin( fTheta * (1.0f-l) ) / fSinTheta;
                fScale2 = ai_sin( fTheta * l ) / fSinTheta;
            }
        }
        else 
        {
            B.x = -A.y;
            B.y =  A.x;
            B.z = -A.w;
            B.w =  A.z;
            fScale1 = ai_sin( PI * (0.5f - l) );
            fScale2 = ai_sin( PI * l );
        }

        x = fScale1 * A.x + fScale2 * B.x;
        y = fScale1 * A.y + fScale2 * B.y;
        z = fScale1 * A.z + fScale2 * B.z;
        w = fScale1 * A.w + fScale2 * B.w;
    };
    
    void lerp(const AI_Quaternion& q0, const AI_Quaternion& q1, float l)
    {
        slerp(q0, q1, l);
    };
};

//--- global operators ----------------------------------------------
static inline AI_Quaternion operator+(const AI_Quaternion& q0, const AI_Quaternion& q1) {
    return AI_Quaternion(q0.x+q1.x, q0.y+q1.y, q0.z+q1.z, q0.w+q1.w);
};

static inline AI_Quaternion operator-(const AI_Quaternion& q0, const AI_Quaternion& q1) {
    return AI_Quaternion(q0.x-q1.x, q0.y-q1.y, q0.z-q1.z, q0.w-q1.w);
};

static inline AI_Quaternion operator*(const AI_Quaternion& q0, const AI_Quaternion& q1) {
    return AI_Quaternion(q0.w*q1.x + q0.x*q1.w + q0.y*q1.z - q0.z*q1.y,
                      q0.w*q1.y + q0.y*q1.w + q0.z*q1.x - q0.x*q1.z,
                      q0.w*q1.z + q0.z*q1.w + q0.x*q1.y - q0.y*q1.x,
                      q0.w*q1.w - q0.x*q1.x - q0.y*q1.y - q0.z*q1.z);
};




//------------------------------------------------------------------------------
template<>
static inline
void
ai_lerp<AI_Quaternion>(AI_Quaternion & result, const AI_Quaternion & val0, const AI_Quaternion & val1, float lerpVal)
{
    result.lerp(val0, val1, lerpVal);
}


//-------------------------------------------------------------------
#endif

---

InExIn pages are hosted by
InExIn documentation generated by doxygen at Tue Dec 18 12:55:27 2007