0.9.9 API documenation
gtx/quaternion.hpp
Go to the documentation of this file.
1 
14 #pragma once
15 
16 // Dependency:
17 #include "../glm.hpp"
18 #include "../gtc/constants.hpp"
19 #include "../gtc/quaternion.hpp"
20 #include "../gtx/norm.hpp"
21 
22 #ifndef GLM_ENABLE_EXPERIMENTAL
23 # error "GLM: GLM_GTX_quaternion is an experimental extension and may change in the future. Use #define GLM_ENABLE_EXPERIMENTAL before including it, if you really want to use it."
24 #endif
25 
26 #if GLM_MESSAGES == GLM_MESSAGES_ENABLED && !defined(GLM_EXT_INCLUDED)
27 # pragma message("GLM: GLM_GTX_quaternion extension included")
28 #endif
29 
30 namespace glm
31 {
34 
38  template<typename T, qualifier P>
39  GLM_FUNC_DECL tquat<T, P> quat_identity();
40 
44  template<typename T, qualifier P>
45  GLM_FUNC_DECL vec<3, T, P> cross(
46  tquat<T, P> const & q,
47  vec<3, T, P> const & v);
48 
52  template<typename T, qualifier P>
53  GLM_FUNC_DECL vec<3, T, P> cross(
54  vec<3, T, P> const & v,
55  tquat<T, P> const & q);
56 
61  template<typename T, qualifier P>
62  GLM_FUNC_DECL tquat<T, P> squad(
63  tquat<T, P> const& q1,
64  tquat<T, P> const& q2,
65  tquat<T, P> const& s1,
66  tquat<T, P> const& s2,
67  T const& h);
68 
72  template<typename T, qualifier P>
73  GLM_FUNC_DECL tquat<T, P> intermediate(
74  tquat<T, P> const& prev,
75  tquat<T, P> const& curr,
76  tquat<T, P> const& next);
77 
81  template<typename T, qualifier P>
82  GLM_FUNC_DECL tquat<T, P> exp(
83  tquat<T, P> const& q);
84 
88  template<typename T, qualifier P>
89  GLM_FUNC_DECL tquat<T, P> log(
90  tquat<T, P> const& q);
91 
95  template<typename T, qualifier P>
96  GLM_FUNC_DECL tquat<T, P> pow(
97  tquat<T, P> const& x,
98  T const& y);
99 
103  //template<typename T, qualifier P>
104  //tquat<T, P> sqrt(
105  // tquat<T, P> const & q);
106 
110  template<typename T, qualifier P>
111  GLM_FUNC_DECL vec<3, T, P> rotate(
112  tquat<T, P> const& q,
113  vec<3, T, P> const& v);
114 
118  template<typename T, qualifier P>
119  GLM_FUNC_DECL vec<4, T, P> rotate(
120  tquat<T, P> const& q,
121  vec<4, T, P> const& v);
122 
126  template<typename T, qualifier P>
127  GLM_FUNC_DECL T extractRealComponent(
128  tquat<T, P> const& q);
129 
133  template<typename T, qualifier P>
134  GLM_FUNC_DECL mat<3, 3, T, P> toMat3(
135  tquat<T, P> const& x){return mat3_cast(x);}
136 
140  template<typename T, qualifier P>
141  GLM_FUNC_DECL mat<4, 4, T, P> toMat4(
142  tquat<T, P> const& x){return mat4_cast(x);}
143 
147  template<typename T, qualifier P>
148  GLM_FUNC_DECL tquat<T, P> toQuat(
149  mat<3, 3, T, P> const& x){return quat_cast(x);}
150 
154  template<typename T, qualifier P>
155  GLM_FUNC_DECL tquat<T, P> toQuat(
156  mat<4, 4, T, P> const& x){return quat_cast(x);}
157 
161  template<typename T, qualifier P>
162  GLM_FUNC_DECL tquat<T, P> shortMix(
163  tquat<T, P> const& x,
164  tquat<T, P> const& y,
165  T const& a);
166 
170  template<typename T, qualifier P>
171  GLM_FUNC_DECL tquat<T, P> fastMix(
172  tquat<T, P> const& x,
173  tquat<T, P> const& y,
174  T const& a);
175 
181  template<typename T, qualifier P>
182  GLM_FUNC_DECL tquat<T, P> rotation(
183  vec<3, T, P> const& orig,
184  vec<3, T, P> const& dest);
185 
190  template<typename T, qualifier P>
191  GLM_FUNC_DECL tquat<T, P> quatLookAt(
192  vec<3, T, P> const& direction,
193  vec<3, T, P> const& up);
194 
199  template<typename T, qualifier P>
200  GLM_FUNC_DECL tquat<T, P> quatLookAtRH(
201  vec<3, T, P> const& direction,
202  vec<3, T, P> const& up);
203 
208  template<typename T, qualifier P>
209  GLM_FUNC_DECL tquat<T, P> quatLookAtLH(
210  vec<3, T, P> const& direction,
211  vec<3, T, P> const& up);
212 
216  template<typename T, qualifier P>
217  GLM_FUNC_DECL T length2(tquat<T, P> const & q);
218 
220 }//namespace glm
221 
222 #include "quaternion.inl"
GLM_FUNC_DECL tquat< T, P > quatLookAtLH(vec< 3, T, P > const &direction, vec< 3, T, P > const &up)
Build a left-handed look at quaternion.
GLM_FUNC_DECL vec< 3, T, P > cross(vec< 3, T, P > const &v, tquat< T, P > const &q)
Compute a cross product between a vector and a quaternion.
GLM_FUNC_DECL tquat< T, P > pow(tquat< T, P > const &x, T const &y)
Returns x raised to the y power.
GLM_FUNC_DECL tquat< T, P > shortMix(tquat< T, P > const &x, tquat< T, P > const &y, T const &a)
Quaternion interpolation using the rotation short path.
Definition: _noise.hpp:11
GLM_FUNC_DECL mat< 3, 3, T, P > mat3_cast(tquat< T, P > const &x)
Converts a quaternion to a 3 * 3 matrix.
GLM_FUNC_DECL mat< 4, 4, T, P > toMat4(tquat< T, P > const &x)
Converts a quaternion to a 4 * 4 matrix.
GLM_FUNC_DECL tquat< T, P > rotation(vec< 3, T, P > const &orig, vec< 3, T, P > const &dest)
Compute the rotation between two vectors.
GLM_FUNC_DECL tquat< T, P > toQuat(mat< 4, 4, T, P > const &x)
Converts a 4 * 4 matrix to a quaternion.
GLM_FUNC_DECL tquat< T, P > intermediate(tquat< T, P > const &prev, tquat< T, P > const &curr, tquat< T, P > const &next)
Returns an intermediate control point for squad interpolation.
GLM_FUNC_DECL T length2(tquat< T, P > const &q)
Returns the squared length of x.
GLM_FUNC_DECL mat< 3, 3, T, P > toMat3(tquat< T, P > const &x)
Converts a quaternion to a 3 * 3 matrix.
GLM_FUNC_DECL vec< 4, T, P > rotate(tquat< T, P > const &q, vec< 4, T, P > const &v)
Rotates a 4 components vector by a quaternion.
GLM_FUNC_DECL T extractRealComponent(tquat< T, P > const &q)
Extract the real component of a quaternion.
GLM_FUNC_DECL tquat< T, P > fastMix(tquat< T, P > const &x, tquat< T, P > const &y, T const &a)
Quaternion normalized linear interpolation.
GLM_FUNC_DECL mat< 4, 4, T, P > mat4_cast(tquat< T, P > const &x)
Converts a quaternion to a 4 * 4 matrix.
GLM_FUNC_DECL tquat< T, P > quatLookAtRH(vec< 3, T, P > const &direction, vec< 3, T, P > const &up)
Build a right-handed look at quaternion.
GLM_FUNC_DECL tquat< T, P > squad(tquat< T, P > const &q1, tquat< T, P > const &q2, tquat< T, P > const &s1, tquat< T, P > const &s2, T const &h)
Compute a point on a path according squad equation.
GLM_FUNC_DECL tquat< T, P > exp(tquat< T, P > const &q)
Returns a exp of a quaternion.
GLM_FUNC_DECL tquat< T, P > quat_identity()
Create an identity quaternion.
GLM_FUNC_DECL tquat< T, P > quat_cast(mat< 3, 3, T, P > const &x)
Converts a 3 * 3 matrix to a quaternion.
GLM_FUNC_DECL tquat< T, P > log(tquat< T, P > const &q)
Returns a log of a quaternion.
GLM_FUNC_DECL tquat< T, P > quatLookAt(vec< 3, T, P > const &direction, vec< 3, T, P > const &up)
Build a look at quaternion based on the default handedness.