Home | History | Annotate | Download | only in gtx
      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 (at) 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