#ifndef Magnum_Magnum_h #define Magnum_Magnum_h /* This file is part of Magnum. Copyright © 2010, 2011, 2012, 2013 Vladimír Vondruš 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. */ /** @file * @brief Forward declarations for Magnum namespace */ #include #include "Math/Math.h" #include "Types.h" #include "magnumConfigure.h" #ifndef DOXYGEN_GENERATING_OUTPUT typedef unsigned int GLenum; /* Needed for *Format and *Type enums */ #endif namespace Magnum { namespace Math { template struct Constants; /** @todoc Remove `ifndef` when Doxygen is able to handle operator"" */ #ifndef DOXYGEN_GENERATING_OUTPUT #ifndef CORRADE_GCC46_COMPATIBILITY #ifndef MAGNUM_TARGET_GLES constexpr Rad operator "" _rad(long double); constexpr Deg operator "" _deg(long double); #endif constexpr Rad operator "" _radf(long double); constexpr Deg operator "" _degf(long double); #endif #endif } /* Bring whole Corrade namespace */ using namespace Corrade; /* Bring debugging facility from Corrade::Utility namespace */ using Corrade::Utility::Debug; using Corrade::Utility::Warning; using Corrade::Utility::Error; #ifdef DOXYGEN_GENERATING_OUTPUT /** @brief Build with deprecated API included Defined if the library contains deprecated API (which will be removed in the future). To preserve backward compatibility, %Magnum is by default built with deprecated API included. @see @ref building */ #define MAGNUM_BUILD_DEPRECATED /* (enabled by default) */ /** @brief Static library build Defined if built as static libraries. Default are shared libraries. @see @ref building */ #define MAGNUM_BUILD_STATIC #undef MAGNUM_BUILD_STATIC /** @brief OpenGL ES target Defined if the engine is built for OpenGL ES 3.0 or OpenGL ES 2.0. @see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_GLES3, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building */ #define MAGNUM_TARGET_GLES #undef MAGNUM_TARGET_GLES /** @brief OpenGL ES 2.0 target. Defined if the engine is built for OpenGL ES 2.0. Implies also @ref MAGNUM_TARGET_GLES. @see @ref MAGNUM_TARGET_GLES3, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building */ #define MAGNUM_TARGET_GLES2 #undef MAGNUM_TARGET_GLES2 /** @brief OpenGL ES 3.0 target. Defined if the engine is built for OpenGL ES 3.0. Implies also @ref MAGNUM_TARGET_GLES. @see @ref MAGNUM_TARGET_GLES2, @ref MAGNUM_TARGET_DESKTOP_GLES, @ref building */ #define MAGNUM_TARGET_GLES3 #undef MAGNUM_TARGET_GLES3 /** @brief Desktop emulation of OpenGL ES target Defined if the engine is built for OpenGL ES 3.0 or OpenGL ES 2.0 emulated within standard desktop OpenGL. Implies also @ref MAGNUM_TARGET_GLES. @see @ref MAGNUM_TARGET_GLES2, @ref building */ #define MAGNUM_TARGET_DESKTOP_GLES #undef MAGNUM_TARGET_DESKTOP_GLES #endif /** @{ @name Basic type definitions See @ref types for more information. */ /** @brief Unsigned byte (8bit) */ typedef std::uint8_t UnsignedByte; /** @brief Signed byte (8bit) */ typedef std::int8_t Byte; /** @brief Unsigned short (16bit) */ typedef std::uint16_t UnsignedShort; /** @brief Signed short (16bit) */ typedef std::int16_t Short; /** @brief Unsigned int (32bit) */ typedef std::uint32_t UnsignedInt; /** @brief Signed int (32bit) */ typedef std::int32_t Int; /** @brief Unsigned long (64bit) */ typedef std::uint64_t UnsignedLong; /** @brief Signed long (64bit) */ typedef std::int64_t Long; /** @brief Float (32bit) */ typedef float Float; /** @brief Two-component float vector */ typedef Math::Vector2 Vector2; /** @brief Three-component float vector */ typedef Math::Vector3 Vector3; /** @brief Four-component float vector */ typedef Math::Vector4 Vector4; /** @brief Two-component unsigned integer vector */ typedef Math::Vector2 Vector2ui; /** @brief Three-component unsigned integer vector */ typedef Math::Vector3 Vector3ui; /** @brief Four-component unsigned integer vector */ typedef Math::Vector4 Vector4ui; /** @brief Two-component signed integer vector */ typedef Math::Vector2 Vector2i; /** @brief Three-component signed integer vector */ typedef Math::Vector3 Vector3i; /** @brief Four-component signed integer vector */ typedef Math::Vector4 Vector4i; /** @brief 3x3 float transformation matrix @see @ref Matrix3x3 */ typedef Math::Matrix3 Matrix3; /** @brief 4x4 float transformation matrix @see @ref Matrix4x4 */ typedef Math::Matrix4 Matrix4; /** @brief 2x2 float matrix */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x2 Matrix2x2; #else typedef Math::Matrix<2, Float> Matrix2x2; #endif #ifdef MAGNUM_BUILD_DEPRECATED /** @copybrief Matrix2x2 @deprecated Use @ref Magnum::Matrix2x2 "Matrix2x2" instead. */ typedef Math::Matrix<2, Float> Matrix2; #endif /** @brief 3x3 float matrix Note that this is different from @ref Matrix3, which contains additional functions for transformations in 2D. */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x3 Matrix3x3; #else typedef Math::Matrix<3, Float> Matrix3x3; #endif /** @brief 4x4 float matrix Note that this is different from @ref Matrix4, which contains additional functions for transformations in 3D. */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x4 Matrix4x4; #else typedef Math::Matrix<4, Float> Matrix4x4; #endif /** @brief Float matrix with 2 columns and 3 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x3 Matrix2x3; #else typedef Math::RectangularMatrix<2, 3, Float> Matrix2x3; #endif /** @brief Float matrix with 3 columns and 2 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x2 Matrix3x2; #else typedef Math::RectangularMatrix<3, 2, Float> Matrix3x2; #endif /** @brief Float matrix with 2 columns and 4 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x4 Matrix2x4; #else typedef Math::RectangularMatrix<2, 4, Float> Matrix2x4; #endif /** @brief Float matrix with 4 columns and 2 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x2 Matrix4x2; #else typedef Math::RectangularMatrix<4, 2, Float> Matrix4x2; #endif /** @brief Float matrix with 3 columns and 4 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x4 Matrix3x4; #else typedef Math::RectangularMatrix<3, 4, Float> Matrix3x4; #endif /** @brief Float matrix with 4 columns and 3 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x3 Matrix4x3; #else typedef Math::RectangularMatrix<4, 3, Float> Matrix4x3; #endif /** @brief Float complex number */ typedef Math::Complex Complex; /** @brief Float dual complex number */ typedef Math::DualComplex DualComplex; /** @brief Float quaternion */ typedef Math::Quaternion Quaternion; /** @brief Float dual quaternion */ typedef Math::DualQuaternion DualQuaternion; /** @brief Float constants */ typedef Math::Constants Constants; /** @brief Angle in float degrees */ typedef Math::Deg Deg; /** @brief Angle in float radians */ typedef Math::Rad Rad; /** @brief Float 1D range */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Range1D Range1D; #else typedef Math::Range<1, Float> Range1D; #endif /** @brief Float 2D range */ typedef Math::Range2D Range2D; /** @brief Float 3D range */ typedef Math::Range3D Range3D; /** @brief Signed integer 1D range */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Range1D Range1Di; #else typedef Math::Range<1, Int> Range1Di; #endif /** @brief Signed integer 2D range */ typedef Math::Range2D Range2Di; /** @brief Signed integer 3D range */ typedef Math::Range3D Range3Di; #ifdef MAGNUM_BUILD_DEPRECATED /** @copybrief Range2D @deprecated Use @ref Magnum::Range2D instead. */ typedef Math::Geometry::Rectangle Rectangle; /** @copybrief Range2Di @deprecated Use @ref Magnum::Range2Di instead. */ typedef Math::Geometry::Rectangle Rectanglei; #endif /*@}*/ #ifndef MAGNUM_TARGET_GLES /** @{ @name Double-precision types See @ref types for more information. @requires_gl Only single-precision types are available in OpenGL ES. */ /** @brief Double (64bit) */ typedef double Double; /** @brief Two-component double vector */ typedef Math::Vector2 Vector2d; /** @brief Three-component double vector */ typedef Math::Vector3 Vector3d; /** @brief Four-component double vector */ typedef Math::Vector4 Vector4d; /** @brief 3x3 double transformation matrix @see @ref Matrix3x3d */ typedef Math::Matrix3 Matrix3d; /** @brief 4x4 double transformation matrix @see @ref Matrix4x4d */ typedef Math::Matrix4 Matrix4d; /** @brief 2x2 double matrix */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x2 Matrix2x2d; #else typedef Math::Matrix<2, Double> Matrix2x2d; #endif #ifdef MAGNUM_BUILD_DEPRECATED /** @copybrief Matrix2x2d @deprecated Use @ref Magnum::Matrix2x2d "Matrix2x2d" instead. */ typedef Math::Matrix<2, Double> Matrix2d; #endif /** @brief 3x3 double matrix Note that this is different from @ref Matrix3d, which contains additional functions for transformations in 2D. */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x3 Matrix3x3d; #else typedef Math::Matrix<3, Double> Matrix3x3d; #endif /** @brief 4x4 double matrix Note that this is different from @ref Matrix4d, which contains additional functions for transformations in 3D. */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x4 Matrix4x4d; #else typedef Math::Matrix<4, Double> Matrix4x4d; #endif /** @brief Double matrix with 2 columns and 3 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x3 Matrix2x3d; #else typedef Math::RectangularMatrix<2, 3, Double> Matrix2x3d; #endif /** @brief Double matrix with 3 columns and 2 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x2 Matrix3x2d; #else typedef Math::RectangularMatrix<3, 2, Double> Matrix3x2d; #endif /** @brief Double matrix with 2 columns and 4 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix2x4 Matrix2x4d; #else typedef Math::RectangularMatrix<2, 4, Double> Matrix2x4d; #endif /** @brief Double matrix with 4 columns and 2 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x2 Matrix4x2d; #else typedef Math::RectangularMatrix<4, 2, Double> Matrix4x2d; #endif /** @brief Double matrix with 3 columns and 4 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix3x4 Matrix3x4d; #else typedef Math::RectangularMatrix<3, 4, Double> Matrix3x4d; #endif /** @brief Double matrix with 4 columns and 3 rows */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Matrix4x3 Matrix4x3d; #else typedef Math::RectangularMatrix<4, 3, Double> Matrix4x3d; #endif /** @brief Double complex number */ typedef Math::Complex Complexd; /** @brief Double dual complex number */ typedef Math::DualComplex DualComplexd; /** @brief Double quaternion */ typedef Math::Quaternion Quaterniond; /** @brief Double dual quaternion */ typedef Math::DualQuaternion DualQuaterniond; /** @brief Double constants */ typedef Math::Constants Constantsd; /** @brief Angle in double degrees */ typedef Math::Deg Degd; /** @brief Angle in double radians */ typedef Math::Rad Radd; /** @brief Double 1D range */ #ifndef CORRADE_GCC46_COMPATIBILITY typedef Math::Range1D Range1Dd; #else typedef Math::Range<1, Double> Range1Dd; #endif /** @brief Double 2D range */ typedef Math::Range2D Range2Dd; /** @brief Double 3D range */ typedef Math::Range3D Range3Dd; #ifdef MAGNUM_BUILD_DEPRECATED /** @copybrief Range2Dd @deprecated Use @ref Magnum::Range2Dd instead. */ typedef Math::Geometry::Rectangle Rectangled; #endif /*@}*/ #endif #ifndef CORRADE_GCC46_COMPATIBILITY /* Using angle literals from Math namespace */ #ifndef MAGNUM_TARGET_GLES using Math::operator "" _deg; using Math::operator "" _rad; #endif using Math::operator "" _degf; using Math::operator "" _radf; #endif /* Forward declarations for all types in root namespace */ /* FramebufferClear[Mask], FramebufferBlit[Mask], FramebufferBlitFilter, FramebufferTarget enums used only directly with framebuffer instance */ class AbstractFramebuffer; class AbstractImage; class AbstractShaderProgram; class AbstractTexture; template class Array; template class Array1D; template class Array2D; template class Array3D; enum class BufferUsage: GLenum; class Buffer; #ifndef MAGNUM_TARGET_GLES2 template class BufferImage; typedef BufferImage<1> BufferImage1D; typedef BufferImage<2> BufferImage2D; typedef BufferImage<3> BufferImage3D; #endif #ifndef MAGNUM_TARGET_GLES class BufferTexture; enum class BufferTextureFormat: GLenum; #endif template class BasicColor3; template class BasicColor4; typedef BasicColor3 Color3; typedef BasicColor4 Color4; enum class ColorFormat: GLenum; enum class ColorType: GLenum; /** @todo Remove this when dropping backward compatibility */ typedef ColorFormat ImageFormat; typedef ColorType ColorType; enum class Version: Int; class Context; class CubeMapTexture; #ifndef MAGNUM_TARGET_GLES class CubeMapTextureArray; #endif /* DebugMarker forward declaration is not needed */ /* DefaultFramebuffer is available only through global instance */ /* DimensionTraits forward declaration is not needed */ class Extension; class Framebuffer; template class Image; typedef Image<1> Image1D; typedef Image<2> Image2D; typedef Image<3> Image3D; template class ImageReference; typedef ImageReference<1> ImageReference1D; typedef ImageReference<2> ImageReference2D; typedef ImageReference<3> ImageReference3D; class Mesh; class MeshView; /* AbstractQuery is not used directly */ class PrimitiveQuery; class SampleQuery; class TimeQuery; class Renderbuffer; enum class RenderbufferFormat: GLenum; enum class ResourceState: UnsignedByte; enum class ResourceDataState: UnsignedByte; enum class ResourcePolicy: UnsignedByte; template class Resource; class ResourceKey; template class ResourceManager; class Sampler; class Shader; template class Texture; #ifndef MAGNUM_TARGET_GLES typedef Texture<1> Texture1D; #endif typedef Texture<2> Texture2D; typedef Texture<3> Texture3D; enum class TextureFormat: GLenum; class Timeline; } #endif