/* This file is part of Magnum. Copyright © 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 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. */ namespace Magnum { /** @page changelog-old Archived changelogs @tableofcontents See also: - @subpage changelog-plugins-old "Archived plugin changelogs" - @subpage changelog-integration-old "Archived integration changelogs" - @subpage changelog-examples-old "Archived example changelogs" @section changelog-2015-05 2015.05 Released 2015-05-09, tagged as [v2015.05](https://github.com/mosra/magnum/releases/tag/v2015.05). See the [release announcement](https://blog.magnum.graphics/announcements/may-2015-updates/) for a high-level overview. @subsection changelog-2015-05-new New features - Proper extension loading for OpenGL ES 2.0, 3.0 and 3.1 using flextGL. - Enabled already implemented functionality on OpenGL ES 3.1. - Support for new OpenGL functionality: - Support for @gl_extension{ARB,direct_state_acccess} (OpenGL 4.5) everywhere except in Mesh. - Support for @gl_extension{ARB,conditional_render_inverted} (OpenGL 4.5) in @cpp SampleQuery @ce. - Support for @gl_extension{ARB,get_texture_sub_image} (OpenGL 4.5) in @cpp *Texture::subImage() @ce. - Support for @gl_extension{EXT,transform_feedback}, @gl_extension{ARB,transform_feedback2} (OpenGL 3.0, 4.0, OpenGL ES 3.0) in new @cpp TransformFeedback @ce class, added @cpp Renderer::Feature::RasterizerDiscard @ce. - Support for @gl_extension{ARB,robustness_isolation} in @cpp Renderer::graphicsResetStatus() @ce. - Support for @gl_extension{ARB,framebuffer_sRGB} (OpenGL 3.0) in @cpp Renderer::Feature::FramebufferSRGB @ce - Support for @gl_extension{OES,texture_npot} ES extension. - Support for debug groups from @gl_extension{KHR,debug} (OpenGL 4.5) and @gl_extension{EXT,debug_marker} extensions in @cpp DebugGroup @ce class. - Added @cpp CubeMapTexture::*image() @ce that returns all six faces together. - Added @cpp Primitives::Cube::solidStrip() @ce. - Added @cpp AbstractShaderProgram::attachShaders() @ce as a list-based complement to @cpp Shader::compile() @ce and @cpp AbstractShaderProgram::link() @ce. - Separated @cpp Renderer::setFeature() @ce into shorter @cpp Renderer::enable() @ce and @cpp Renderer::disable() @ce. - Added @cpp tau() @ce, @cpp piHalf() @ce, @cpp e() @ce, @cpp nan() @ce and @cpp inf() @ce to @ref Math::Constants. - Added @ref Math::Matrix4::shearingXY() "Math::Matrix[34]::shearing*()". - Added @ref Math::Matrix4::lookAt() (see [mosra/magnum#88](https://github.com/mosra/magnum/issues/88)). - Added @ref Math::Vector::pad(). - Added @ref Math::div(). - Using range-based-for to traverse object children and features in @ref SceneGraph and screens in @ref Platform::BasicScreenedApplication "Platform::ScreenedApplication". - Convenience overload for @cpp *Framebuffer::read() @ce and @cpp *Texture::image() @ce that returns the queried image by value instead of as parameter. - Added @cpp Buffer::uniformOffsetAlignment() @ce and @cpp Mesh::maxElementIndex() @ce limit queries. - Added @cpp AbstractTexture::unbind() @ce for unbinding range of texture units. - Added @ref SceneGraph::AbstractObject::addFeature() and @ref SceneGraph::Object::addChild() functions (see [mosra/magnum#86](https://github.com/mosra/magnum/issues/86)). - VSync support in @ref Platform::Sdl2Application. - Added `Platform::*Context` libraries for users which want to use custom windowing toolkits instead of the ones provided. - Improved documentation about @ref Shaders namespace, added sample image for each. @subsection changelog-2015-05-changes Changes - Using [flextGL](https://github.com/ginkgo/flextgl) instead of `glLoadGen` for OpenGL extension loading - @ref Platform::Sdl2Application now tries to create core context on all platforms, not just OSX (see [mosra/magnum#80](https://github.com/mosra/magnum/issues/80)). - @cpp Buffer::bind() @ce, @cpp Buffer::unbind() @ce and @cpp Buffer::Target @ce is now used for indexed buffer binding only. - Moved static binary operations from @ref Math classes into free functions for more convenient usage (see [mosra/magnum#74](https://github.com/mosra/magnum/issues/74)). - Better algorithm for comparing floating-point values. - Ensuring that all OpenGL objects are properly created before using them. - Using @cpp const char @ce instead of @cpp const unsigned char @ce for raw binary data. - Removed annoying restriction when adding reference-counted resources to @ref ResourceManager. - Extension querying cleanup: - Removed @gl_extension{APPLE,flush_buffer_range} extension. - Replaced @gl_extension{APPLE,vertex_array_object} with @gl_extension{ARB,vertex_array_object}. - Replaced @gl_extension{NV,half_float} with @gl_extension{ARB,half_float_vertex}. - Replaced @gl_extension{EXT,framebuffer_sRGB} with @gl_extension{ARB,framebuffer_sRGB}. - Documentation cleanup, fixes and improvements. @subsection changelog-2015-05-buildsystem Build system - CMake now always installs `FindMagnum.cmake` to library-specific location, making it usable without providing own copy of the file in depending projects. The `WITH_FIND_MODULE` option is no longer needed. - CMake now handles inter-library dependencies automatically without manually specifying each and every one (see [mosra/magnum#73](https://github.com/mosra/magnum/issues/73)). - Ability to control static build of plugins separately using `BUILD_PLUGINS_STATIC`. - Displaying all header files, plugin metadata files and resource files in project view to make use of some IDEs less painful (such as QtCreator). - Gentoo ebuild (see [mosra/magnum#69](https://github.com/mosra/magnum/issues/69), [mosra/magnum#83](https://github.com/mosra/magnum/issues/83)). @subsection changelog-2015-05-bugfixes Bug fixes - Fixed @cpp TextureTools::distanceField() @ce to work in GLSL < 4.20 (see [mosra/magnum#62](https://github.com/mosra/magnum/issues/62)). - Fixed @ref Shaders::MeshVisualizer to work in GLSL ES. - Fixed @ref Shaders::Vector "Shaders::*Vector" on Intel GPUs. - Fixed assertion on contexts without default framebuffer (see [mosra/magnum#93](https://github.com/mosra/magnum/issues/93)). - Fixed cases where shader would use extension that is not advertised by the driver. - Properly handle case where @fn_gl_extension{VertexArrayVertexAttribDivisor,EXT,direct_state_access} is not available in the driver (see [mosra/magnum#77](https://github.com/mosra/magnum/issues/77)). - Removed superfluous level argument from @cpp Framebuffer::attachTexture*() @ce overloads for texture types that don't support mipmapping. - Proper no-op fallback for @cpp *Framebuffer::invalidate() @ce on platforms where the extensions is not supported (see [mosra/magnum#63](https://github.com/mosra/magnum/issues/63)). - Fixed garbage characters in shader compilation output (see [mosra/magnum#87](https://github.com/mosra/magnum/issues/87)). - Fixed memory corruption on MSVC 2013 (see [mosra/magnum#70](https://github.com/mosra/magnum/issues/70)). - Fixed potential memory corruption errors with static build (see [mosra/magnum#79](https://github.com/mosra/magnum/issues/79)). - Fixed aspect-ratio-corrected projection with inverted Y in @ref SceneGraph::Camera3D "SceneGraph::Camera*D". - Fixed wheel direction in @ref Platform::Sdl2Application (see [mosra/magnum#68](https://github.com/mosra/magnum/issues/68)). - Fixed bogus version check in @ref Platform::WindowlessCglApplication (see [mosra/magnum#92](https://github.com/mosra/magnum/issues/92)) - Fixed matrix to quaternion conversion algorithm. - Two different headers in @ref Primitives had the same include guard by accident (see [mosra/magnum#72](https://github.com/mosra/magnum/issues/53)) - Various compilation fixes on various platforms (see [mosra/magnum#71](https://github.com/mosra/magnum/pull/71)) @subsection changelog-2015-05-deprecated Deprecated APIs - The `Magnum/Query.h` header is deprecated, use one of `Magnum/PrimitiveQuery.h`, `Magnum/SampleQuery.h` or `Magnum/TimeQuery.h` instead. - Using @cpp Buffer::Target @ce as constructor or @cpp Buffer::setTargetHint() @ce parameter is deprecated, use @cpp Buffer::TargetHint @ce instead. - The @cpp SceneGraph::TransformationType @ce enum is depracted, use separate `()` and `Local()` variants instead. - @cpp SceneGraph::AbstractObject::hasFeatures() @ce, @cpp firstFeature() @ce, @cpp lastFeature() @ce, @cpp SceneGraph::Object::hasChildren() @ce, @cpp firstChild() @ce and @cpp lastChild() @ce are deprecated, use methods on linked list returned by @ref SceneGraph::AbstractObject::features() and @ref SceneGraph::Object::children() instead. - @cpp Platform::ScreenedApplication::frontScreen() @ce and @cpp Platform::ScreenedApplication::backScreen() @ce are deprecated, use methods on linked list returned by @ref Platform::BasicScreenedApplication::screens() "Platform::ScreenedApplication::screens()" instead. - @cpp *Framebuffer::read() @ce functions taking two vectors are deprecated, use overload taking @ref Range2Di instead. - The @cpp Mesh::maxVertexAttributes() @ce function is deprecated, use @cpp AbstractShaderProgram::maxVertexAttributes() @ce instead. - @cpp Math::Vector::dot() @ce, @cpp Math::Complex::dot() @ce, @cpp Math::Quaternion::dot() @ce, @cpp Math::Vector::angle() @ce, @cpp Math::Complex::angle() @ce, @cpp Math::Quaternion::angle() @ce, @cpp Math::Quaternion::lerp() @ce, @cpp Math::Quaternion::slerp() @ce, @cpp Math::Vector2::cross() @ce and @cpp Math::Vector3::cross() @ce are deprecated, use @ref Math::dot(), @ref Math::angle(), @ref Math::lerp(), @ref Math::slerp() and @ref Math::cross() instead (see [mosra/magnum#74](https://github.com/mosra/magnum/issues/74)) - The @cpp *Framebuffer::bind(FramebufferTarget) @ce function is deprecated, use parameter-less @cpp *Framebuffer::bind() @ce instead. - The @cpp FramebufferTarget::ReadDraw @ce enum value is deprecated, use separate @cpp FramebufferTarget::Read @ce and @cpp FramebufferTarget::Draw @ce values instead. - @cpp CubeMapTexture::imageSize() @ce with explicit face parameter is deprecated, use overload that returns one value for all faces instead. - The `Magnum/DebugMessage.h` header is deprecated, use `Magnum/DebugOutput.h` instead (see [mosra/magnum#89](https://github.com/mosra/magnum/pull/89)) - The @cpp DebugMessage::Severity @ce enum is deprecated, use @cpp DebugOutput::Severity @ce instead. - The @cpp DebugMessage::Callback @ce typedef, @cpp DebugMessage::setCallback() @ce and @cpp DebugMessage::setDefaultCallback() @ce function is deprecated, use @cpp DebugOutput::Callback @ce, @cpp DebugOutput::setCallback() @ce and @cpp DebugOutput::setDefaultCallback() @ce instead. - The @cpp DebugMessage::maxLoggedMessages() @ce and @cpp DebugMessage::maxMessageLength() @ce functions are deprecated, use @cpp DebugOutput::maxLoggedMessages() @ce and @cpp DebugOutput::maxMessageLength() @ce instead. - The @cpp DebugMessage::setEnabled() @ce function and related values from @cpp DebugMessage::Source @ce enum are deprecated, use @cpp DebugOutput::setEnabled() @ce along with @cpp DebugOutput::Source @ce, @cpp DebugOutput::Type @ce and @cpp DebugOutput::Severity @ce instead. - Parameter-less @cpp *Query @ce constructor and parametrized @cpp *Query::begin() @ce function are deprecated, use constructor with parameter and parameter-less @cpp *Query::begin() @ce instead. @subsection changelog-2015-05-compatibility Potential compatibility breakages, removed APIs - All functionality @ref changelog-2014-01-deprecated "deprecated in 2014.01" has been removed, namely: - Removed deprecated ability to use relative includes (e.g. @cpp #include @ce), use absolute paths (@cpp #include @ce) instead. - Removed deprecated @cpp Mesh::Primitive @ce enum, use @cpp MeshPrimitive @ce instead. - Removed deprecated @cpp Sampler::maxAnisotropy() @ce function, use @cpp Sampler::maxMaxAnisotropy() @ce instead. - Removed deprecated @cpp Math::Geometry::Rectangle @ce class, use @ref Math::Range instead. - Removed deprecated @cpp SceneGraph::Animable::group() @ce function, use @ref SceneGraph::Animable::animables() instead. - Removed deprecated `Shaders/magnumShadersResourceImport.hpp` file, use `Shaders/resourceImport.hpp` instead. - Removed deprecated @cpp Text::TextRenderer @ce alias, use @ref Text::Renderer instead. - Removed long-deprecated @cpp BufferImage::setData() @ce overload, use the other one instead. @subsection changelog-2015-05-performance Performance improvements - Faster vector multiplication in @ref Math::Quaternion. - Saved one swizzle in @ref Math::cross(). - Allocation-free overloads of functions that took @cpp std::string @ce just to pass its contents to OpenGL. @section changelog-2014-06 2014.06 Released 2014-06-30, tagged as [v2014.06](https://github.com/mosra/magnum/releases/tag/v2014.06). See the [release announcement](https://blog.magnum.graphics/announcements/june-2014-updates/) for a high-level overview. @subsection changelog-2014-06-dependencies Dependency changes - Minimal required GCC version is now 4.7. Support for GCC 4.6 has been moved to `compatibility` branch (see [mosra/magnum#18](https://github.com/mosra/magnum/issues/18)) @subsection changelog-2014-06-new New features - Experimental Android support, see @ref building-cross-android "building documentation" for more information - Initial implementation of @ref Platform::AndroidApplication class - @ref Platform::WindowlessWglApplication and @ref Platform::WindowlessCglApplication, which enable @ref magnum-gl-info "magnum-info", @ref magnum-distancefieldconverter and @ref magnum-fontconverter utilities on OS X and Windows. See [mosra/magnum#40](https://github.com/mosra/magnum/issues/40) and [mosra/magnum#59](https://github.com/mosra/magnum/pull/59). - @ref Trade::ObjImporter "ObjImporter" plugin, mesh import only (no materials yet) - Completed support of @gl_extension{EXT,texture_integer}, @gl_extension{ARB,stencil_texturing}, @gl_extension{ARB,texture_rectangle}, @gl_extension{ARB,texture_buffer_object}, @gl_extension{ARB,texture_swizzle}, @gl_extension{EXT,texture_sRGB_decode} extensions (and related ES extensions) and other missing parameters in @cpp *Texture @ce classes - Basic support for @gl_extension{ARB,texture_multisample} and @gl_extension{ARB,texture_storage_multisample} in new @cpp MultisampleTexture @ce class - Instanced rendering, base vertex and base instance specification in @cpp Mesh @ce and @cpp MeshView @ce classes; @cpp Mesh::addVertexBufferInstanced() @ce function for adding buffers with per-instance data (see [mosra/magnum#47](https://github.com/mosra/magnum/issues/47)) - Mesh multi-draw using @cpp MeshView::draw() @ce - Initial @gl_extension{ARB,multi_bind} support with @cpp AbstractTexture::bind() @ce - Support for @gl_extension{ARB,vertex_type_10f_11f_11f_rev} in @cpp AbstractShaderProgram::Attribute::DataType @ce - New variants of @cpp Shader::compile() @ce and @cpp AbstractShaderProgram::link() @ce, allowing the driver to perform paralell compilation in multiple threads. - Added @cpp *Texture::maxSize() @ce queries - @ref MeshTools::compile() for automagic creation of 2D and 3D meshes from imported data - @ref MeshTools::interleaveInto() for interleaving data into existing buffer - `Shapes::Shape::collision()` function as complement to `Shapes::Shape::collides()` - `Platform::GlutApplication::KeyEvent` finally has more complete key support - @ref Math::Range::data() function, useful when querying range values from GL - Support for specifying context flags using @cpp Platform::*Application::Configuration::setFlags() @ce, they are now also shown in @ref magnum-gl-info "magnum-info" - More robust support for driver detection and driver bug workarounds. Driver can be detected using @cpp Context::detectedDriver() @ce, problematic extension disabled, which is then shown in @ref magnum-gl-info "magnum-info" and can be also queried using @cpp Context::isExtensionDisabled() @ce - @cpp Context::extensionStrings() @ce for getting list of all extension strings exposed by the driver - @cpp Context::resetState() @ce for resetting internal state tracker, allowing to use Magnum along with third-party OpenGL code (see [mosra/magnum#48](https://github.com/mosra/magnum/issues/48)) - @ref MAGNUM_TARGET_WEBGL CMake and preprocessor variable @subsection changelog-2014-06-changes Changes - Libraries and plugins in debug build configuration are installed to different locations, making it possible to have debug and release libraries installed alongside each other (see [mosra/magnum#20](https://github.com/mosra/magnum/issues/20), [mosra/magnum#45](https://github.com/mosra/magnum/issues/18)) - @ref Platform::Sdl2Application is now used everywhere (documentation, tutorials, examples) by default, replacing `Platform::GlutApplication`. The GLUT application is still available, though. See [mosra/magnum#39](https://github.com/mosra/magnum/issues/39). - The need for compiler compatibility mode is now automatically detected by CMake to avoid strange compilation errors later - Split out @cpp Texture @ce functionality into dedicated @cpp TextureArray @ce, @cpp MultisampleTexture @ce and @cpp RectangleTexture @ce classes to make their usage less error-prone - @cpp Buffer::invalidateData() @ce, @cpp Buffer::invalidateSubData() @ce and @cpp Renderer::resetNotificationStrategy() @ce functions are enabled on OpenGL ES as a no-op - Added @ref std::vector overload of @cpp MeshTools::combineIndexArrays() @ce for greater runtime-usage flexibility - @ref Platform::Sdl2Application now defaults to non-resizable window, you can change the behavior using @ref Platform::Sdl2Application::Configuration::setWindowFlags() - It's now possible to import objects without materials - More robust OpenGL version checks when creating context - Thorough documentation review, fixes and improvements @subsection changelog-2014-06-buildsystem Build system - Avoiding unnecessary linking of the OpenGL library (see [mosra/magnum#60](https://github.com/mosra/magnum/pull/60)) @subsection changelog-2014-06-bugfixes Bug fixes - Fixed usage with OpenGL ES 3.1 contexts (it complained about invalid version) - Fixed compilation of Shaders::MeshVisualizer under WebGL and with ANGLE, see [mosra/magnum#56](https://github.com/mosra/magnum/issues/56) - Fixed various build issues on Mac OS X, see [mosra/magnum#51](https://github.com/mosra/magnum/issues/51) and [mosra/magnum#54](https://github.com/mosra/magnum/issues/54) @subsection changelog-2014-06-deprecated Deprecated APIs - @cpp Mesh::setVertexCount() @ce and @cpp Mesh::setIndexCount() @ce had nonintuitive behavior in some corner cases and are deprecated, use general @cpp Mesh::setCount() @ce function instead - @cpp MeshView::setVertexRange() @ce and four-/two-argument @cpp MeshView::setIndexRange() @ce are deprecated for similar reason as above, use @cpp MeshView::setCount() @ce, @cpp MeshView::setBaseVertex() @ce and three-/one-argument @cpp MeshView::setIndexRange() @ce instead - @cpp Texture::Target @ce enum is deprecated as the API was too error-prone, use dedicated @cpp TextureArray @ce, @cpp MultisampleTexture @ce and @cpp RectangleTexture @ce classes instead - @cpp Framebuffer::attachTexture*D() @ce is deprecated, use more generic @cpp Framebuffer::attachTexture() @ce and @cpp Framebuffer::attachTextureLayer() @ce instead - @cpp FramebufferBlit::*Buffer @ce enum values are deprecated, use shorter @cpp FramebufferBlit::Color @ce and similar instead - @ref Audio::Source::play(), @ref SceneGraph::AbstractObject::setClean(), @ref SceneGraph::AbstractObject::transformationMatrices() and similar taking @ref std::initializer_list of pointers are deprecated, use versions taking list of references instead - @ref MeshTools::compressIndices() and @ref MeshTools::interleave() which filled @cpp Mesh @ce and @cpp Buffer @ce directly are deprecated as they had undesired side-effects in some cases, use the data-returning versions instead and then configure mesh and buffer manually - @cpp MeshTools::combineIndexedArrays() @ce taking @ref std::tuple is deprecated, use version taking @ref std::pair instead - @cpp MeshTools::removeDuplicates() @ce taking also list of indices is deprecated, use the function in conjunction with @ref MeshTools::duplicate(). See function documentation for more information. - Parameter-less @cpp Mesh::draw() @ce and @cpp MeshView::draw() @ce are deprecated, use versions with explicit shader parameter instead - Deprecated implicit conversion of @ref Resource "Resource" to @cpp U& @ce, as it is not safe. Use explicit dereference operator instead. - Texture binding using @cpp *Texture::bind() @ce is deprecated, use setup functions of particular shaders instead (e.g. @cpp Shaders::Phong::setDiffuseTexture() @ce) - @cpp Context::Flag::Robustness @ce is deprecated, use @cpp Context::Flag::RobustAccess @ce which reflects OpenGL naming better instead - @cpp Texture::maxLayers() @ce has misleading naming and is deprecated, use @cpp Shader::maxCombinedTextureImageUnits() @ce instead @subsection changelog-2014-06-compatibility Potential compatibility breakages, removed APIs - All functionality @ref changelog-2013-10-deprecated "deprecated in 2013.10" has been removed, namely: - Removed deprecated raw-pointer versions of @cpp Buffer::setData() @ce and @cpp Buffer::setSubData() @ce, use overloads taking @cpp Containers::ArrayReference @ce instead - Removed deprecated `Magnum/ImageFormat.h` header and @cpp ImageFormat @ce/@cpp ImageType @ce enums, use `Magnum/ColorFormat.h` header and @cpp ColorFormat @ce/@cpp ColorType @ce enums instead - Removed deprecated @cpp Matrix2 @ce and @cpp Matrix2d @ce typedefs, use @ref Matrix2x2 and @ref Matrix2x2d instead - Removed deprecated `Magnum/Swizzle.h` header and @cpp Magnum::swizzle() @ce function, use @ref Magnum/Math/Swizzle.h and @cpp Math::swizzle() @ce instead - Removed deprecated @cpp *::maxSupported*() @ce limit queries, use the less verbose @cpp *::max*() @ce versions instead - Removed deprecated @cpp Platform::*Application::InputEvent::Modifier::*Button @ce enum values, use @ref Platform::Sdl2Application::MouseMoveEvent::buttons() "Platform::*Application::*Event::buttons()" function and @ref Platform::Sdl2Application::MouseMoveEvent::Button "Platform::*Application::*Event::Button" enum instead - @cpp Platform::Sdl2Application::Configuration::Flag @ce enum and related functions were replaced with WindowFlag, as the name would now conflict with context flags @subsection changelog-2014-06-internal Internal changes - Removed last remaining bits of global state, everything is now stored per-context. @section changelog-2014-01 2014.01 Released 2014-01-21, tagged as [v2014.01](https://github.com/mosra/magnum/releases/tag/v2014.01). See the [release announcement](https://blog.magnum.graphics/announcements/january-2014-updates/) for a high-level overview. @subsection changelog-2014-01-dependencies Dependency changes No dependency changes in this release. @subsection changelog-2014-01-new New features - MSVC 2013 support in `compatibility` branch - Dependency-less plugins from Magnum Plugins repository are now part of Magnum to make their usage easier, in particular the @ref Text::MagnumFont "MagnumFont", @ref Text::MagnumFontConverter "MagnumFontConverter", @ref Trade::TgaImporter "TgaImporter", @ref Trade::TgaImageConverter "TgaImageConverter" and @ref Audio::WavImporter "WavAudioImporter" plugins. - Documented @ref opengl-support "state of OpenGL support", @ref opengl-mapping "mapping between OpenGL and Magnum API", @ref plugins "general plugin usage" and added @ref troubleshooting "troubleshooting page" for most common building and rendering issues - Support for horizontal and vertical text alignment and multi-line text in @ref Text::Renderer (line wrapping is still left up to the user) - New @ref magnum-fontconverter utility for converting between font formats (e.g. creating distance-field raster font from TTF font). Enable it with `WITH_FONTCONVERTER` CMake option (currently Linux only), see `magnum-fontconverter --help` for more information. - Support for OpenGL object labels, debug message insertion and retrieval (@gl_extension{KHR,debug}, @gl_extension{EXT,debug_label} and @gl_extension{EXT,debug_marker} extensions) (see [mosra/magnum#42](https://github.com/mosra/magnum/issues/42)) - @ref Platform::BasicScreenedApplication "Platform::ScreenedApplication" class allowing the users to easily use multiple independent screens in the application. - New 1D, 2D and 3D @ref Math::Range class - Added @cpp red() @ce, @cpp green() @ce, @cpp blue() @ce, @cpp cyan() @ce, @cpp magenta() @ce and @cpp yellow() @ce convenience functions to @ref Color3 and @ref Color4 classes - Convenience @ref Color3ub and @ref Color4ub typedefs - New @cpp version() @ce utility functions for converting @cpp Version @ce enum value to major/minor version number and back - Added @cpp release() @ce function to @ref Image and @ref Trade::ImageData for releasing ownership of the data, similar to @ref std::unique_ptr::release() (see [mosra/magnum#29](https://github.com/mosra/magnum/issues/29)) - @cpp *Image::dataSize() @ce function for computing size of buffer required to store image of given size - Disallowing conversion of rvalue @ref Image and @ref Trade::ImageData to ImageReference as it would result in access to deleted memory (GCC 4.8.1/Clang only) - No-op fallback for @cpp *Texture::setMaxAnisotropy() @ce in case @gl_extension{EXT,texture_filter_anisotropic extension} is not supported - Added @cpp round() @ce, @cpp floor() @ce and @cpp ceil() @ce scalar/vector functions to @ref Math namespace - @ref Math::minmax() and @ref Math::Vector2::minmax() functions - Modulo operations for integral @ref Math::Vector classes - Ability to request context version in all windowed @ref Platform::Sdl2Application "Platform::*Application" classes - Mouse wheel support in @cpp Platform::NaClApplication::MouseEvent @ce - No-op `Platform::GlutApplication::keyReleaseEvent()` and @cpp Platform::NaClApplication::Configuration::setTitle() @ce functions to preserve source compatibility with other application classes. - @ref SceneGraph::Drawable::drawables() function as a non-ambiguous alternative to @cpp group() @ce - Ability to specify background color color in @ref Shaders::Vector, allowing it to use without blending enabled (fully transparent black was used previously) - New @ref Shaders::Generic class with common definitions, so you can configure mesh for the generic shader and render it with any other compatible shader - Convenience @cpp hasNormals() @ce, @cpp hasTextureCoords2D() @ce functions in @cpp Trade::MeshData2D @ce and @cpp Trade::MeshData3D @ce - OpenGL ES 3.0 build now shares list of vendor extensions with OpenGL ES 2.0 build (i.e. only those extensions that aren't part of ES 3.0 are present in @cpp Extensions @ce) - All classes in documentation are now shown with corresponding @cpp #include @ce path @subsection changelog-2014-01-changes Changes - Preferring absolute includes instead of relative (see [mosra/magnum#36](https://github.com/mosra/magnum/issues/36)) - The `magnum-distancefield` utility is now named @ref magnum-distancefieldconverter for consistency with other command-line utilities - @cpp ImageReference @ce class now stores const data pointer instead of mutable one, modifying the data through the class interface isn't valid use case anyway - Added default template parameter to @cpp Buffer::data() @ce and made @ref Image::data() "*Image::data()" templated to have them consistent. Note that this is source-compatible change. - @cpp Query::result() @ce returns @cpp true @ce if value is nonzero (was returning @cpp true @ce only for value of 1 previously) - All functions in @ref MeshTools namespace are now returning either @ref Corrade::Containers::Array or @ref std::unique_ptr instead of naked pointers to avoid accidental out-of-bounds access and memory leaks - All functions in @ref Text namespace are now returning @ref std::unique_ptr instead of naked pointers to avoid accidental memory leaks - Implementation of @ref Platform::Sdl2Application::viewportEvent() "Platform::*Application::viewportEvent()" is not required anymore, because in many cases the application doesn't need to react to window resize events at all - Textured @ref Shaders::Flat now multiplies texture with the specified color instead of ignoring it. See also [mosra/magnum#34](https://github.com/mosra/magnum/issues/34) - All deprecated functions and types are now emitting compiler warnings to encourage updating the code - Various documentation and example updates and improvements @subsection changelog-2014-01-bugfixes Bug fixes - Fixed @cpp CubeMapTextureArray::image() @ce function (more precisely it wasn't working at all). See also [mosra/magnum#31](https://github.com/mosra/magnum/issues/31). - Fixed wrong assertion in @cpp Texture::setWrapping() @ce for rectangle textures - Fixed wrong assertion in @cpp AbstractImage::pixelSize() @ce when computing size of separate depth and stencil formats - @cpp Mesh::addVertexBuffer() @ce now properly computes offsets for matrix attributes - Taking index buffer offset into account in @cpp MeshView @ce class - Fixed various issues with textured @ref Shaders::Flat shader (actually the textured version was not working at all) - Various OS X-related fixes in @ref Shaders library. See also [mosra/magnum#27](https://github.com/mosra/magnum/issues/27). - Fixed building issues when both SDL1 and SDL2 is installed on OS X. See also [mosra/magnum#25](https://github.com/mosra/magnum/issues/25), [mosra/magnum#38](https://github.com/mosra/magnum/pull/38). - Fixed building issues with CMake-generated XCode project on OS X. See also [mosra/magnum#37](https://github.com/mosra/magnum/issues/37). - Proper and failsafe OpenGL 3 context creation on OS X (3.0 is implemented only as core context, thus requesting 2.1 won't expose newer features). See also [mosra/magnum#26](https://github.com/mosra/magnum/issues/26), [mosra/magnum#35](https://github.com/mosra/magnum/issues/35) and [mosra/magnum#43](https://github.com/mosra/magnum/pull/43). - Fixed compilation issues with Clang and libc++ - Fixed various compilation issues under MSVC (and worked around an insane amount of compiler bugs) @subsection changelog-2014-01-deprecated Deprecated APIs - @cpp Buffer::Usage @ce enum is deprecated to reduce header dependencies, use global @cpp BufferUsage @ce enum instead - @cpp Mesh::Primitive @ce enum is deprecated to reduce header dependencies, use global @cpp MeshPrimitive @ce enum instead - @cpp Sampler::maxAnisotropy() @ce is deprecated to avoid naming conflict with @cpp *Texture::setMaxAnisotropy() @ce, use @cpp Sampler::maxMaxAnisotropy() @ce instead - @cpp Magnum::Geometry::Rectangle @ce class (and @cpp Rectangle* @ce typedefs) is deprecated, use more generic and feature-rich @ref Math::Range instead. - @cpp Platform::Sdl2Application::Configuration::setFlags() @ce function and related enum is deprecated to avoid naming conflict in the future, use @ref Platform::Sdl2Application::Configuration::setWindowFlags() instead - @cpp SceneGraph::Animable::group() @ce is deprecated, use non-ambiguous @ref SceneGraph::Animable::animables() instead - `Magnum/Shaders/magnumShadersResourceImport.hpp` header is deprecated in favor of less verbose `Magnum/Shaders/resourceImport.hpp` - @cpp Text::TextRenderer @ce class (and @cpp Text::TextRenderer2D @ce, @cpp Text::TextRenderer3D @ce typedefs) is deprecated, use less redundant name @ref Text::Renderer instead @subsection changelog-2014-01-compatibility Potential compatibility breakages, removed APIs - Removed @cpp SceneGraph::*Transformation::move() @ce from 2D transformation classes. It was originally meant for modifying draw order, but as the draw order is managed by @ref SceneGraph::DrawableGroup class and not by parent object, this function is essentially useless. @subsection changelog-2014-01-documentation Documentation - Various documentation updates and fixes (see [mosra/magnum#28](https://github.com/mosra/magnum/issues/28)) @subsection changelog-2014-01-internal Internal changes - Added thorough tests for all core OpenGL functionality to make refactoring easier - Various internal optimizations and cleanup to make maintenance easier - Using Jenkins Continuous Integration to maintain compilable and bug-free state of the project more easily. Currently GCC 4.8, 4.7, 4.6, 4.5, 4.4, Clang 3.3, Clang 3.3 with libc++, Emscripten, x86-32/x86-64 Native Client and MinGW32 compilers are tested with both shared and static libraries. Separately testing builds with deprecated features enabled and disabled. Also explicitly testing desktop OpenGL, OpenGL ES 2.0, desktop OpenGL ES 2.0 emulation, OpenGL ES 3.0 and desktop OpenGL ES 3.0 emulation. - All files from `src/` directory were moved to `src/Magnum`, `external/` directory was moved to `src/MagnumExternal` (required to make inter-project includes absolute, as mentioned above) @section changelog-2013-10 2013.10 Released 2013-10-30, tagged as [v2013.10](https://github.com/mosra/magnum/releases/tag/v2013.10). See the [release announcement](https://blog.magnum.graphics/announcements/october-2013-updates/) for a high-level overview. @subsection changelog-2013-10-dependencies Dependency changes - Removed GLEW dependency in favor of built-in `glLoadGen`, resulting in greatly reduced compilation time and less compatibility issues. The base library thus now depends only on Corrade and OpenGL libraries. See [mosra/magnum#11](https://github.com/mosra/magnum/issues/11), [mosra/magnum#16](https://github.com/mosra/magnum/issues/16), [mosra/magnum#21](https://github.com/mosra/magnum/issues/21), [mosra/magnum#22](https://github.com/mosra/magnum/issues/22), [mosra/magnum#23](https://github.com/mosra/magnum/pull/23), [mosra/magnum-bootstrap#2](https://github.com/mosra/magnum-bootstrap/issues/2). @subsection changelog-2013-10-new New features - Initial Emscripten (HTML5/WebGL) port. See @ref Platform::Sdl2Application for detailed porting information. The @ref example-index "examples page" has now links to online Emscripten demos, see also [base-emscripten](https://github.com/mosra/magnum-bootstrap/tree/base-emscripten) branch in Magnum Bootstrap. - Mac OS X port (thanks to Miguel Martin) - @ref Math::Vector::isZero() and @ref Math::Vector2::aspectRatio() convenience functions - Bitwise AND, OR, XOR, bit inversion and bit shift in integral @ref Math::Vector classes - @ref Math::Matrix4x3 "Math::MatrixMxN" and @ref Math::Matrix3x3 "Math::MatrixNxN" template aliases for non-square and non-transforming square matrices in @ref Math namespace, @ref Matrix3x2 "MatrixNxN" and @ref Matrix2x2d "MatrixNxNd" typedefs for @cpp float @ce and @cpp double @ce non-transforming square matrices in root Magnum namespace. Note that template aliases are not present in GCC 4.6 builds. - Limit queries for all OpenGL objects, the information is now printed also by @ref magnum-gl-info "magnum-info" utility. - @cpp Context::isExtensionSupported() @ce is now able to query extension availability on particular GLSL version - Using @ref std::unique_ptr and C++1y @ref std::optional for resources returned from @ref Trade::AbstractImporter for better usability and to avoid accidental memory leaks - New translation-only transformation in @ref SceneGraph supporting also purely integral coordinates, useful e.g. for UI or 2D platformers. - Detailed collision queries and new `InvertedSphere` shape in Shapes library - Texture support in @ref Shaders::Flat - Mouse button queries in @ref Platform::Sdl2Application::MouseMoveEvent "Platform::*Application::MouseMoveEvent" @subsection changelog-2013-10-changes Changes - @cpp Buffer::setData() @ce and @cpp Buffer::setSubData() @ce are now accepting @cpp Containers::ArrayReference @ce for more convenient usage - @ref Platform::Sdl2Application::viewportEvent() "Platform::*Application::viewportEvent()" is not called at all if window size doesn't change, allowing for less cumbersome ofscreen rendering setups - Removed redundant operators from @ref Math::RectangularMatrix "Math::*Matrix", use vectors for component-wise multiplication and division instead - Documentation updates and improvements to make the library more accessible for newcomers - Various build system updates for better compile times and easier installation @subsection changelog-2013-10-bugfixes Bug fixes - Fixed compilation with Clang and libc++ (see [mosra/magnum#12](https://github.com/mosra/magnum/issues/12)) - Fixes compilation of the Audio library on macOS (see [mosra/magnum#19](https://github.com/mosra/magnum/issues/19)) - Fixed compatibility of builtin shaders with GLSL 1.20 and GLSL ES 1.00, added shader compilation tests to prevent this issue from reappearing (see [mosra/magnum#17](https://github.com/mosra/magnum/issues/17)) - Extension support queries depend on selected GLSL version (see [mosra/magnum-examples#3](https://github.com/mosra/magnum-examples/issues/3)) - Properly exporting `SceneGraph::AbstractCamera` symbols (see [mosra/magnum-bootstrap#3](https://github.com/mosra/magnum-bootstrap/issues/3)) @subsection changelog-2013-10-deprecated Deprecated APIs - @cpp Matrix2 @ce and @cpp Matrix2d @ce is deprecated, use @ref Matrix2x2 and @ref Matrix2x2d instead - @cpp swizzle() @ce is deprecated, all of its functionality has been moved into @cpp Math::swizzle() @ce - @cpp Buffer::setData() @ce and @cpp Buffer::setSubData() @ce overloads taking pair of data pointer and size are deprecated, use @cpp Containers::ArrayReference @ce-based @cpp Buffer::setData() @ce and @cpp Buffer::setSubData() @ce - `ImageFormat.h` header, @cpp ImageFormat @ce and @cpp ImageType @ce enums are deprecated, use `ColorFormat.h` header, `ColorFormat` and `ColorType` enums which reflect OpenGL naming better instead - @cpp Platform::*Application::InputEvent::Modifier::*Button @ce enum values are deprecated, use @ref Platform::Sdl2Application::MouseMoveEvent::buttons() "Platform::*Application::*Event::buttons()" and @ref Platform::Sdl2Application::MouseMoveEvent::Button "Platform::*Application::*Event::Button" enum instead - @cpp AbstractShaderProgram::maxSupportedVertexAttributeCount() @ce, @cpp AbstractTexture::maxSupportedLayerCount() @ce and @cpp Sampler::maxSupportedAnisotropy() @ce are deprecated in favor of less verbose @cpp AbstractShaderProgram::maxVertexAttributes() @ce, @cpp AbstractTexture::maxLayers() @ce and @cpp Sampler::maxAnisotropy() @ce @subsection changelog-2013-10-documentation Documentation - Fixed @ref SceneGraph bootstrap branch name (see [mosra/magnum-bootstrap#1](https://github.com/mosra/magnum-bootstrap/issues/1)) @subsection changelog-2013-10-compatibility Potential compatibility breakages, removed APIs No deprecated API was removed in this release. @section changelog-2013-08 2013.08 Released 2013-08-30, tagged as [v2013.08](https://github.com/mosra/magnum/releases/tag/v2013.08). See the [project announcement](https://blog.magnum.graphics/announcements/introducing-magnum/) for a high-level overview. */ }