#ifndef Magnum_Math_Vector3_h #define Magnum_Math_Vector3_h /* Copyright © 2010, 2011, 2012 Vladimír Vondruš This file is part of Magnum. Magnum is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License version 3 only, as published by the Free Software Foundation. Magnum is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License version 3 for more details. */ /** @file * @brief Class Magnum::Math::Vector3 */ #include "Vector.h" namespace Magnum { namespace Math { /** @brief Three-component vector */ template class Vector3: public Vector { public: /** @copydoc Vector::from(T*) */ inline constexpr static Vector3& from(T* data) { return *reinterpret_cast*>(data); } /** @copydoc Vector::from(const T*) */ inline constexpr static const Vector3& from(const T* data) { return *reinterpret_cast*>(data); } /** @brief %Vector in direction of X axis */ inline constexpr static Vector3 xAxis(T length = T(1)) { return Vector3(length, T(), T()); } /** @brief %Vector in direction of Y axis */ inline constexpr static Vector3 yAxis(T length = T(1)) { return Vector3(T(), length, T()); } /** @brief %Vector in direction of Z axis */ inline constexpr static Vector3 zAxis(T length = T(1)) { return Vector3(T(), T(), length); } /** * @brief Cross product * * @f[ * \begin{pmatrix} c_1 \\ c_2 \\ c_3 \end{pmatrix} = * \begin{pmatrix}a_2b_3 - a_3b_2 \\ a_3b_1 - a_1b_3 \\ a_1b_2 - a_2b_1 \end{pmatrix} * @f] */ constexpr static Vector3 cross(const Vector3& a, const Vector3& b) { return Vector3(a[1]*b[2]-a[2]*b[1], a[2]*b[0]-a[0]*b[2], a[0]*b[1]-a[1]*b[0]); } /** @copydoc Vector::Vector(T) */ /** @todo Use original constructor when it is constexpr */ inline constexpr explicit Vector3(T value = T()): Vector(value, value, value) {} /** @copydoc Vector::Vector(const Vector&) */ inline constexpr Vector3(const Vector& other): Vector(other) {} /** * @brief Constructor * @param x X / R value * @param y Y / G value * @param z Z / B value */ inline constexpr Vector3(T x, T y, T z): Vector(x, y, z) {} /** * @brief Constructor * @param other Two component vector * @param z Z / B value */ inline constexpr Vector3(const Vector& other, T z = T(0)): Vector(other[0], other[1], z) {} inline constexpr T x() const { return (*this)[0]; } /**< @brief X component */ inline constexpr T y() const { return (*this)[1]; } /**< @brief Y component */ inline constexpr T z() const { return (*this)[2]; } /**< @brief Z component */ inline void setX(T value) { (*this)[0] = value; } /**< @brief Set X component */ inline void setY(T value) { (*this)[1] = value; } /**< @brief Set Y component */ inline void setZ(T value) { (*this)[2] = value; } /**< @brief Set Z component */ inline constexpr T r() const { return x(); } /**< @brief R component */ inline constexpr T g() const { return x(); } /**< @brief G component */ inline constexpr T b() const { return z(); } /**< @brief B component */ inline void setR(T value) { setX(value); } /**< @brief Set R component */ inline void setG(T value) { setY(value); } /**< @brief Set G component */ inline void setB(T value) { setZ(value); } /**< @brief Set B component */ /** @copydoc Vector::operator=() */ inline Vector3& operator=(const Vector3& other) { Vector::operator=(other); return *this; } /** @copydoc Vector::operator*(T) const */ inline Vector3 operator*(T number) const { return Vector::operator*(number); } /** @copydoc Vector::operator*=() */ inline Vector3& operator*=(T number) { Vector::operator*=(number); return *this; } /** @copydoc Vector::operator/() */ inline Vector3 operator/(T number) const { return Vector::operator/(number); } /** @copydoc Vector::operator/=() */ inline Vector3& operator/=(T number) { Vector::operator/=(number); return *this; } /** @copydoc Vector::operator+() */ inline Vector3 operator+(const Vector& other) const { return Vector::operator+(other); } /** @copydoc Vector::operator+=() */ inline Vector3& operator+=(const Vector& other) { Vector::operator+=(other); return *this; } /** @copydoc Vector::operator-(const Vector&) const */ inline Vector3 operator-(const Vector& other) const { return Vector::operator-(other); } /** @copydoc Vector::operator-=() */ inline Vector3& operator-=(const Vector& other) { Vector::operator-=(other); return *this; } /** @copydoc Vector::operator-() */ inline Vector3 operator-() const { return Vector::operator-(); } /** @copydoc Vector::normalized() */ inline Vector3 normalized() const { return Vector::normalized(); } }; #ifndef DOXYGEN_GENERATING_OUTPUT template Corrade::Utility::Debug operator<<(Corrade::Utility::Debug debug, const Magnum::Math::Vector3& value) { return debug << static_cast&>(value); } #endif }} #endif