Vector3.hpp

Go to the documentation of this file.

/*
   Copyright (C) 1997,1998,1999
   Kenji Hiranabe, Eiwa System Management, Inc.

   This program is free software.
   Implemented by Kenji Hiranabe(hiranabe@esm.co.jp),
   conforming to the Java(TM) 3D API specification by Sun Microsystems.

   Permission to use, copy, modify, distribute and sell this software
   and its documentation for any purpose is hereby granted without fee,
   provided that the above copyright notice appear in all copies and
   that both that copyright notice and this permission notice appear
   in supporting documentation. Kenji Hiranabe and Eiwa System Management,Inc.
   makes no representations about the suitability of this software for any
   purpose.  It is provided "AS IS" with NO WARRANTY.

   Copyright (C) 2004
   Rune Myrland, Skalden Studio AS
   SagaEngine adaptions, involving conversion from floating point values to fixed point values.
   Kenji Hiranabe's license apply.
*/
#ifndef base_vecmath_Vector3_hpp
#define base_vecmath_Vector3_hpp

#include "util_vecmath.hpp"
#include "Tuple3.hpp"

namespace se_core {
    class _SeCoreExport Vector3 : public Tuple3 {
    public:
        Vector3(coor_t x, coor_t y, coor_t z): Tuple3(x, y, z) { }

        Vector3(const coor_t v[]): Tuple3(v) {  }

        Vector3(const Tuple3& t1): Tuple3(t1) { }

        Vector3(): Tuple3() { }

        void cross(const Vector3& v1, const Vector3& v2) {
            // store on stack once for aliasing-safty
            // i.e. safe when a.cross(a, b)
            set(
                CoorT::fromd(static_cast<coor_double_t>(v1.y_)*v2.z_ - static_cast<coor_double_t>(v1.z_)*v2.y_),
                CoorT::fromd(static_cast<coor_double_t>(v1.z_)*v2.x_ - static_cast<coor_double_t>(v1.x_)*v2.z_),
                CoorT::fromd(static_cast<coor_double_t>(v1.x_)*v2.y_ - static_cast<coor_double_t>(v1.y_)*v2.x_)
                );
        }

        void normalize(const Vector3& v1) {
            set(v1);
            normalize();
        }

        void normalize() {
            coor_t d = length();

            // zero-div may occur.
            x_ = CoorT::fromd(static_cast<coor_double_t>(x_)) / d;
            y_ = CoorT::fromd(static_cast<coor_double_t>(y_)) / d;
            z_ = CoorT::fromd(static_cast<coor_double_t>(z_)) / d;
        }

        coor_t dot(const Vector3& v1) const {
            return
                CoorT::fromd((static_cast<coor_double_t>(x_)*v1.x_)
                + (static_cast<coor_double_t>(y_)*v1.y_)
                + (static_cast<coor_double_t>(z_)*v1.z_));
        }

        coor_double_t lengthSquared() const {
            return
                (static_cast<coor_double_t>(x_)*x_)
                + (static_cast<coor_double_t>(y_)*y_)
                + (static_cast<coor_double_t>(z_)*z_);
        }

        coor_double_t xzLengthSquared() const {
            return
                (static_cast<coor_double_t>(x_)*x_)
                + (static_cast<coor_double_t>(z_)*z_);
        }


        coor_t xzLength() const;

        coor_t length() const;


        bray_t angle(const Vector3& v1) const;

        bray_t yaw() const;

        void rotate(const Quat4& q);
        void rotate(const Vector3& v, const Quat4& q);
        void rotateInverse(const Quat4& q);

        void rotate(const Euler3& a);
        void rotate(const Vector3& v, const Euler3& a);
        void rotateInverse(const Euler3& a);

        void setForward(const coor_t len, const bray_t yaw);
        void setForward(const coor_t len, const bray_t yaw, const bray_t pitch);
        void setForward(const coor_t len, const Euler3& a1);


        // copy constructor and operator = is made by complier

        Vector3& operator=(const Tuple3& t) {
            Tuple3::operator=(t);
            return *this;
        }

        static const Vector3 ZERO;
        static const Vector3 UNIT_FORWARD;

    };

} // Namespace


inline
se_core::Vector3 operator*(scale_t s, const se_core::Vector3& t1) {
    return operator*(s, (const se_core::Tuple3&)t1);
}

#endif /* VECTOR3_H */

---

Home Page | SagaEngine trunk (updated nightly) reference generated Sun Dec 2 20:06:13 2007 by Doxygen version 1.3.9.1.