/////////////////////////////////////////////////////////////////////////////////// /// OpenGL Mathematics (glm.g-truc.net) /// /// Copyright (c) 2005 - 2014 G-Truc Creation (www.g-truc.net) /// Permission is hereby granted, free of charge, to any person obtaining a copy /// of this software and associated documentation files (the "Software"), to deal /// in the Software without restriction, including without limitation the rights /// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell /// copies of the Software, and to permit persons to whom the Software is /// furnished to do so, subject to the following conditions: /// /// The above copyright notice and this permission notice shall be included in /// all copies or substantial portions of the Software. /// /// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR /// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, /// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE /// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER /// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, /// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN /// THE SOFTWARE. /// /// @ref gtx_dual_quaternion /// @file glm/gtx/dual_quaternion.inl /// @date 2013-02-10 / 2013-02-13 /// @author Maksim Vorobiev (msomeone@gmail.com) /////////////////////////////////////////////////////////////////////////////////// #include "../geometric.hpp" #include namespace glm{ namespace detail { template GLM_FUNC_QUALIFIER GLM_CONSTEXPR int tdualquat::length() const { return 8; } template GLM_FUNC_QUALIFIER tdualquat::tdualquat() : real(tquat()), dual(tquat(T(0), T(0), T(0), T(0))) {} template GLM_FUNC_QUALIFIER tdualquat::tdualquat ( tquat const & r ) : real(r), dual(tquat(T(0), T(0), T(0), T(0))) {} template GLM_FUNC_QUALIFIER tdualquat::tdualquat ( tquat const & r, tquat const & d ) : real(r), dual(d) {} template GLM_FUNC_QUALIFIER tdualquat::tdualquat ( tquat const & q, tvec3 const& p ) : real(q), dual( T(-0.5) * ( p.x*q.x + p.y*q.y + p.z*q.z), T(+0.5) * ( p.x*q.w + p.y*q.z - p.z*q.y), T(+0.5) * (-p.x*q.z + p.y*q.w + p.z*q.x), T(+0.5) * ( p.x*q.y - p.y*q.x + p.z*q.w)) {} ////////////////////////////////////////////////////////////// // tdualquat conversions template GLM_FUNC_QUALIFIER tdualquat::tdualquat ( tmat2x4 const & m ) { *this = dualquat_cast(m); } template GLM_FUNC_QUALIFIER tdualquat::tdualquat ( tmat3x4 const & m ) { *this = dualquat_cast(m); } ////////////////////////////////////////////////////////////// // tdualquat accesses template GLM_FUNC_QUALIFIER typename tdualquat::part_type & tdualquat::operator [] (int i) { assert(i >= 0 && i < this->length()); return (&real)[i]; } template GLM_FUNC_QUALIFIER typename tdualquat::part_type const & tdualquat::operator [] (int i) const { assert(i >= 0 && i < this->length()); return (&real)[i]; } ////////////////////////////////////////////////////////////// // tdualquat operators template GLM_FUNC_QUALIFIER tdualquat & tdualquat::operator *= ( T const & s ) { this->real *= s; this->dual *= s; return *this; } template GLM_FUNC_QUALIFIER tdualquat & tdualquat::operator /= ( T const & s ) { this->real /= s; this->dual /= s; return *this; } ////////////////////////////////////////////////////////////// // tquat external operators template GLM_FUNC_QUALIFIER detail::tdualquat operator- ( detail::tdualquat const & q ) { return detail::tdualquat(-q.real,-q.dual); } template GLM_FUNC_QUALIFIER detail::tdualquat operator+ ( detail::tdualquat const & q, detail::tdualquat const & p ) { return detail::tdualquat(q.real + p.real,q.dual + p.dual); } template GLM_FUNC_QUALIFIER detail::tdualquat operator* ( detail::tdualquat const & p, detail::tdualquat const & o ) { return detail::tdualquat(p.real * o.real,p.real * o.dual + p.dual * o.real); } // Transformation template GLM_FUNC_QUALIFIER detail::tvec3 operator* ( detail::tdualquat const & q, detail::tvec3 const & v ) { detail::tvec3 const real_v3(q.real.x,q.real.y,q.real.z); detail::tvec3 const dual_v3(q.dual.x,q.dual.y,q.dual.z); return (cross(real_v3, cross(real_v3,v) + v * q.real.w + dual_v3) + dual_v3 * q.real.w - real_v3 * q.dual.w) * T(2) + v; } template GLM_FUNC_QUALIFIER detail::tvec3 operator* ( detail::tvec3 const & v, detail::tdualquat const & q ) { return glm::inverse(q) * v; } template GLM_FUNC_QUALIFIER detail::tvec4 operator* ( detail::tdualquat const & q, detail::tvec4 const & v ) { return detail::tvec4(q * detail::tvec3(v), v.w); } template GLM_FUNC_QUALIFIER detail::tvec4 operator* ( detail::tvec4 const & v, detail::tdualquat const & q ) { return glm::inverse(q) * v; } template GLM_FUNC_QUALIFIER detail::tdualquat operator* ( detail::tdualquat const & q, T const & s ) { return detail::tdualquat(q.real * s, q.dual * s); } template GLM_FUNC_QUALIFIER detail::tdualquat operator* ( T const & s, detail::tdualquat const & q ) { return q * s; } template GLM_FUNC_QUALIFIER detail::tdualquat operator/ ( detail::tdualquat const & q, T const & s ) { return detail::tdualquat(q.real / s, q.dual / s); } ////////////////////////////////////// // Boolean operators template GLM_FUNC_QUALIFIER bool operator== ( detail::tdualquat const & q1, detail::tdualquat const & q2 ) { return (q1.real == q2.real) && (q1.dual == q2.dual); } template GLM_FUNC_QUALIFIER bool operator!= ( detail::tdualquat const & q1, detail::tdualquat const & q2 ) { return (q1.real != q2.dual) || (q1.real != q2.dual); } }//namespace detail //////////////////////////////////////////////////////// template GLM_FUNC_QUALIFIER detail::tdualquat normalize ( detail::tdualquat const & q ) { return q / length(q.real); } template GLM_FUNC_QUALIFIER detail::tdualquat lerp ( detail::tdualquat const & x, detail::tdualquat const & y, T const & a ) { // Dual Quaternion Linear blend aka DLB: // Lerp is only defined in [0, 1] assert(a >= static_cast(0)); assert(a <= static_cast(1)); T const k = dot(x.real,y.real) < static_cast(0) ? -a : a; T const one(1); return detail::tdualquat(x * (one - a) + y * k); } template GLM_FUNC_QUALIFIER detail::tdualquat inverse ( detail::tdualquat const & q ) { const glm::detail::tquat real = conjugate(q.real); const glm::detail::tquat dual = conjugate(q.dual); return detail::tdualquat(real, dual + (real * (-2.0f * dot(real,dual)))); } template GLM_FUNC_QUALIFIER detail::tmat2x4 mat2x4_cast ( detail::tdualquat const & x ) { return detail::tmat2x4( x[0].x, x[0].y, x[0].z, x[0].w, x[1].x, x[1].y, x[1].z, x[1].w ); } template GLM_FUNC_QUALIFIER detail::tmat3x4 mat3x4_cast ( detail::tdualquat const & x ) { detail::tquat r = x.real / length2(x.real); detail::tquat const rr(r.w * x.real.w, r.x * x.real.x, r.y * x.real.y, r.z * x.real.z); r *= static_cast(2); T const xy = r.x * x.real.y; T const xz = r.x * x.real.z; T const yz = r.y * x.real.z; T const wx = r.w * x.real.x; T const wy = r.w * x.real.y; T const wz = r.w * x.real.z; detail::tvec4 const a( rr.w + rr.x - rr.y - rr.z, xy - wz, xz + wy, -(x.dual.w * r.x - x.dual.x * r.w + x.dual.y * r.z - x.dual.z * r.y)); detail::tvec4 const b( xy + wz, rr.w + rr.y - rr.x - rr.z, yz - wx, -(x.dual.w * r.y - x.dual.x * r.z - x.dual.y * r.w + x.dual.z * r.x)); detail::tvec4 const c( xz - wy, yz + wx, rr.w + rr.z - rr.x - rr.y, -(x.dual.w * r.z + x.dual.x * r.y - x.dual.y * r.x - x.dual.z * r.w)); return detail::tmat3x4(a, b, c); } template GLM_FUNC_QUALIFIER detail::tdualquat dualquat_cast ( detail::tmat2x4 const & x ) { return detail::tdualquat( detail::tquat( x[0].w, x[0].x, x[0].y, x[0].z ), detail::tquat( x[1].w, x[1].x, x[1].y, x[1].z )); } template GLM_FUNC_QUALIFIER detail::tdualquat dualquat_cast ( detail::tmat3x4 const & x ) { detail::tquat real; T const trace = x[0].x + x[1].y + x[2].z; if(trace > T(0)) { T const r = sqrt(T(1) + trace); T const invr = static_cast(0.5) / r; real.w = static_cast(0.5) * r; real.x = (x[2].y - x[1].z) * invr; real.y = (x[0].z - x[2].x) * invr; real.z = (x[1].x - x[0].y) * invr; } else if(x[0].x > x[1].y && x[0].x > x[2].z) { T const r = sqrt(T(1) + x[0].x - x[1].y - x[2].z); T const invr = static_cast(0.5) / r; real.x = static_cast(0.5)*r; real.y = (x[1].x + x[0].y) * invr; real.z = (x[0].z + x[2].x) * invr; real.w = (x[2].y - x[1].z) * invr; } else if(x[1].y > x[2].z) { T const r = sqrt(T(1) + x[1].y - x[0].x - x[2].z); T const invr = static_cast(0.5) / r; real.x = (x[1].x + x[0].y) * invr; real.y = static_cast(0.5) * r; real.z = (x[2].y + x[1].z) * invr; real.w = (x[0].z - x[2].x) * invr; } else { T const r = sqrt(T(1) + x[2].z - x[0].x - x[1].y); T const invr = static_cast(0.5) / r; real.x = (x[0].z + x[2].x) * invr; real.y = (x[2].y + x[1].z) * invr; real.z = static_cast(0.5) * r; real.w = (x[1].x - x[0].y) * invr; } detail::tquat dual; dual.x = T(0.5) * ( x[0].w * real.w + x[1].w * real.z - x[2].w * real.y); dual.y = T(0.5) * (-x[0].w * real.z + x[1].w * real.w + x[2].w * real.x); dual.z = T(0.5) * ( x[0].w * real.y - x[1].w * real.x + x[2].w * real.w); dual.w = -T(0.5) * ( x[0].w * real.x + x[1].w * real.y + x[2].w * real.z); return detail::tdualquat(real, dual); } }//namespace glm