#ifndef Magnum_SceneGraph_MatrixTransformation3D_h #define Magnum_SceneGraph_MatrixTransformation3D_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::SceneGraph::MatrixTransformation3D */ #include "Math/Matrix4.h" #include "AbstractTranslationRotationScaling3D.h" #include "Object.h" namespace Magnum { namespace SceneGraph { /** @brief Three-dimensional transformation implemented using matrices Uses Math::Matrix4 as underlying type. @see @ref scenegraph, MatrixTransformation2D */ #ifndef DOXYGEN_GENERATING_OUTPUT template #else template #endif class MatrixTransformation3D: public AbstractTranslationRotationScaling3D { public: /** @brief Transformation matrix type */ typedef typename DimensionTraits<3, T>::MatrixType DataType; #ifndef DOXYGEN_GENERATING_OUTPUT inline constexpr static Math::Matrix4 fromMatrix(const Math::Matrix4& matrix) { return matrix; } inline constexpr static Math::Matrix4 toMatrix(const Math::Matrix4& transformation) { return transformation; } inline static Math::Matrix4 compose(const Math::Matrix4& parent, const Math::Matrix4& child) { return parent*child; } inline static Math::Matrix4 inverted(const Math::Matrix4& transformation) { return transformation.inverted(); } inline Math::Matrix4 transformation() const { return _transformation; } #endif /** * @brief Set transformation * @return Pointer to self (for method chaining) */ MatrixTransformation3D* setTransformation(const Math::Matrix4& transformation) { /* Setting transformation is forbidden for the scene */ /** @todo Assert for this? */ /** @todo Do this in some common code so we don't need to include Object? */ if(!static_cast>*>(this)->isScene()) { _transformation = transformation; static_cast>*>(this)->setDirty(); } return this; } /** * @brief Multiply transformation * @param transformation Transformation * @param type Transformation type * @return Pointer to self (for method chaining) */ inline MatrixTransformation3D* transform(const Math::Matrix4& transformation, TransformationType type = TransformationType::Global) { setTransformation(type == TransformationType::Global ? transformation*_transformation : _transformation*transformation); return this; } /** * @copydoc AbstractTranslationRotationScaling3D::translate() * Same as calling transform() with Matrix4::translation(). */ inline MatrixTransformation3D* translate(const Math::Vector3& vector, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::translation(vector), type); return this; } /** * @copydoc AbstractTranslationRotationScaling3D::rotate() * Same as calling transform() with Matrix4::rotation(). */ inline MatrixTransformation3D* rotate(T angle, const Math::Vector3& normalizedAxis, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::rotation(angle, normalizedAxis), type); return this; } /** * @brief Rotate object around X axis * @param angle Angle in radians, counterclockwise * @param type Transformation type * @return Pointer to self (for method chaining) * * Same as calling transform() with Matrix4::rotationX(). * @see deg(), rad() */ inline MatrixTransformation3D* rotateX(T angle, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::rotationX(angle), type); return this; } /** * @brief Rotate object around Y axis * @param angle Angle in radians, counterclockwise * @param type Transformation type * @return Pointer to self (for method chaining) * * Same as calling transform() with Matrix4::rotationY(). * @see deg(), rad() */ inline MatrixTransformation3D* rotateY(T angle, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::rotationY(angle), type); return this; } /** * @brief Rotate object around Z axis * @param angle Angle in radians, counterclockwise * @param type Transformation type * @return Pointer to self (for method chaining) * * Same as calling transform() with Matrix4::rotationZ(). * @see deg(), rad() */ inline MatrixTransformation3D* rotateZ(T angle, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::rotationZ(angle), type); return this; } /** * @copydoc AbstractTranslationRotationScaling3D::scale() * Same as calling transform() with Matrix4::scaling(). */ inline MatrixTransformation3D* scale(const Math::Vector3& vector, TransformationType type = TransformationType::Global) override { transform(Math::Matrix4::scaling(vector), type); return this; } protected: /* Allow construction only from Object */ inline explicit MatrixTransformation3D() = default; private: Math::Matrix4 _transformation; }; }} #endif