1 ///////////////////////////////////////////////////////////////////////////////////
2 /// OpenGL Mathematics (glm.g-truc.net)
3 ///
4 /// Copyright (c) 2005 - 2014 G-Truc Creation (www.g-truc.net)
5 /// Permission is hereby granted, free of charge, to any person obtaining a copy
6 /// of this software and associated documentation files (the "Software"), to deal
7 /// in the Software without restriction, including without limitation the rights
8 /// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9 /// copies of the Software, and to permit persons to whom the Software is
10 /// furnished to do so, subject to the following conditions:
11 ///
12 /// The above copyright notice and this permission notice shall be included in
13 /// all copies or substantial portions of the Software.
14 ///
15 /// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 /// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 /// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 /// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 /// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 /// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21 /// THE SOFTWARE.
22 ///
23 /// @ref gtx_matrix_interpolation
24 /// @file glm/gtx/matrix_interpolation.hpp
25 /// @date 2011-03-05 / 2011-06-07
26 /// @author Ghenadii Ursachi (the.asteroth@gmail.com)
27 ///
28 /// @see core (dependence)
29 ///
30 /// @defgroup gtx_matrix_interpolation GLM_GTX_matrix_interpolation
31 /// @ingroup gtx
32 ///
33 /// @brief Allows to directly interpolate two exiciting matrices.
34 ///
35 /// <glm/gtx/matrix_interpolation.hpp> need to be included to use these functionalities.
36 ///////////////////////////////////////////////////////////////////////////////////
37 
38 #ifndef GLM_GTX_matrix_interpolation
39 #define GLM_GTX_matrix_interpolation
40 
41 // Dependency:
42 #include "../glm.hpp"
43 
44 #if(defined(GLM_MESSAGES) && !defined(GLM_EXT_INCLUDED))
45 #	pragma message("GLM: GLM_GTX_matrix_interpolation extension included")
46 #endif
47 
48 namespace glm
49 {
50 	/// @addtogroup gtx_matrix_interpolation
51 	/// @{
52 
53 	/// Get the axis and angle of the rotation from a matrix.
54 	/// From GLM_GTX_matrix_interpolation extension.
55 	template <typename T, precision P>
56 	GLM_FUNC_DECL void axisAngle(
57 		detail::tmat4x4<T, P> const & mat,
58 		detail::tvec3<T, P> & axis,
59 		T & angle);
60 
61 	/// Build a matrix from axis and angle.
62 	/// From GLM_GTX_matrix_interpolation extension.
63 	template <typename T, precision P>
64 	GLM_FUNC_DECL detail::tmat4x4<T, P> axisAngleMatrix(
65 		detail::tvec3<T, P> const & axis,
66 		T const angle);
67 
68 	/// Extracts the rotation part of a matrix.
69 	/// From GLM_GTX_matrix_interpolation extension.
70 	template <typename T, precision P>
71 	GLM_FUNC_DECL detail::tmat4x4<T, P> extractMatrixRotation(
72 		detail::tmat4x4<T, P> const & mat);
73 
74 	/// Build a interpolation of 4 * 4 matrixes.
75 	/// From GLM_GTX_matrix_interpolation extension.
76 	/// Warning! works only with rotation and/or translation matrixes, scale will generate unexpected results.
77 	template <typename T, precision P>
78 	GLM_FUNC_DECL detail::tmat4x4<T, P> interpolate(
79 		detail::tmat4x4<T, P> const & m1,
80 		detail::tmat4x4<T, P> const & m2,
81 		T const delta);
82 
83 	/// @}
84 }//namespace glm
85 
86 #include "matrix_interpolation.inl"
87 
88 #endif//GLM_GTX_matrix_interpolation
89