Changelog

• Text::AbstractFont::layout() and the Text::AbstractLayouter class is deprecated in favor of Text::AbstractFont::createShaper() and the Text::AbstractShaper class, which allows for reusing allocated resources, is independent on a glyph cache and has a batch-oriented interface for retrieving shaped glyph data
• Text::GlyphCacheFeature::ImageDownload is deprecated in favor of Text::GlyphCacheFeature::ProcessedImageDownload, as there's now a possibility to get the image directly for glyph caches that don't have Text::GlyphCacheFeature::ImageProcessing
• The Text::AbstractGlyphCache::AbstractGlyphCache(const Vector2i&, const Vector2i&) constructor is deprecated in favor of Text::AbstractGlyphCache::AbstractGlyphCache(PixelFormat, const Vector2i&, const Vector2i&) that specifies a concrete format for the cache image.
• The Text::AbstractGlyphCache::reserve() function is deprecated in favor of operating directly on a TextureTools::AtlasLandfill instance through Text::AbstractGlyphCache::atlas(). It also forced the caller to use a std::vector, which wasn't nice at all. The old API can only be called on 2D glyph caches now, and only when there's no font added yet.
• Text::AbstractGlyphCache::insert() function is deprecated in favor of Text::AbstractGlyphCache::addFont() and addGlyph() that better expose multi-font and 2D array support. The old API can only be called on 2D glyph caches now.
• Text::AbstractGlyphCache::textureSize() is deprecated in favor of Text::AbstractGlyphCache::size() which returns a 3D size in order to support texture arrays as well. The old API can only be called on 2D glyph caches now.
• Text::AbstractGlyphCache::setImage() is deprecated, copy glyph data to slices of Text::AbstractGlyphCache::image() instead and call flushImage() instead. The old API can only be called on 2D glyph caches now.

• Audio::PlayableGroup::setClean(), use Audio::Listener::update() instead
• GL::*Texture::setSRGBDecode(), GL::Renderer::Feature::FramebufferSRGB, Platform::*Application::GLConfiguration::setSRGBCapable() and Platform::*Application::GLConfiguration::isSRGBCapable(), use GL::*Texture::setSrgbDecode(), GL::Renderer::Feature::FramebufferSrgb, Platform::*Application::GLConfiguration::setSrgbCapable() and Platform::*Application::GLConfiguration::isSrgbCapable() instead
• Math::Geometry, Math::Geometry::Distance and Math::Geometry::Intersection namespaces, use Math::Distance and Math::Intersection instead
• Math::Intersection::planeLine() taking a separate plane normal and position, use Math::planeEquation() instead
• MeshTools::compile() taking a GL::BufferUsage and returning a tuple, use the simpler versions instead (note that the Trade::MeshData2D / Trade::MeshData3D overloads are still present for backwards compatibility)
• Platform::*ApplicationviewportEvent(const Vector2i&), override the viewportEvent(ViewportEvent&) function instead.
• Platform::Sdl2Application::Configuration::WindowFlags::AllowHighDpi, had no effect anymore
• Shaders::GenericGL::Color and Shaders::VertexColorGL::Color, use Shaders::VertexColorGL::Color3 or Shaders::VertexColorGL::Color4 instead
• Trade::CameraData constructor not taking an explicit type enum, use Trade::CameraData::CameraData(CameraType, Rad, Float, Float, Float, const void*) instead
• Trade::AbstractMaterialData constructor taking just two parameters and Trade::PhongMaterialData constructor taking three parameters, use either the (also deprecated) Trade::AbstractMaterialData::AbstractMaterialData(MaterialType, Flags, MaterialAlphaMode, Float, const void*) and Trade::PhongMaterialData::PhongMaterialData(Flags, MaterialAlphaMode, Float, Float, const void*) constructors or directly the new Trade::MaterialData class

• Math::Color3::Hsv and Math::Color4::Hsv std::tuple typedefs and Math::Color3::fromHsv() / Math::Color4::fromHsv() overloads taking separate hue, saturation and value arguments. Use the Math::ColorHsv struct instead.
• Math::swizzle(), use Math::gather() instead
• Text::FontFeature::MultiFile, Text::AbstractFont::openData() taking a vector of pairs, and openSingleData(), use Text::AbstractFont::openData() and setFileCallback() for opening multi-file fonts instead

• DebugTools::FrameProfiler::measurementName() and DebugTools::FrameProfiler::statistics() now return a Containers::StringView / Containers::String instead of a std::string
• GL::AbstractShaderProgram::validate() now returns a Containers::Pair with a Containers::String instead of a std::pair with a std::string; GL::Shader::sources() now returns a Containers::StringIterable instead of a std::vector of a std::string See also mosra/magnum#499 and mosra/magnum#608.
• GL::Context::vendorString(), rendererString(), versionString(), shadingLanguageVersionString(), shadingLanguageVersionStrings() and extensionStrings() now return Containers::StringView or a Containers::Array / Containers::ArrayView of them, instead of a std::string and a std::vector.
• All label() and setLabel() APIs now work with a Containers::StringView / Containers::String instead of a std::string
• GL::version(Version) now returns a Containers::Pair instead of a std::pair
• MeshTools::compressIndices(), MeshTools::removeDuplicates() and related APIs now return a Containers::Pair instead of a std::pair
• Vk::DescriptorPoolCreateInfo and Vk::AttachmentDescription APIs now take a Containers::Pair instead of a std::pair
• All Math APIs that took or returned std::pair now use Containers::Pair instead
• Text::AbstractFont public APIs now take Containers::StringView instead of std::string and return Containers::Pair instead of std::pair. Additionally, the internal implementation relies on Containers::ArrayView<const char32_t> instead of std::u32string and Containers::Triple instead of std::tuple, but that shouldn't affect end-user code in any way. To handle most backwards compatibility, Corrade/Containers/StringStl.h and/or Corrade/Containers/PairStl.h is included in affected headers for implicit conversions from/to a std::string and/or std::pair, but in some cases you may be forced to change the code that uses those APIs.

• The Text::AbstractFont::doLayout() and Text::AbstractLayouter::doRenderGlyph() virtual interfaces no longer exist, plugins are expected to implement Text::AbstractFont::doCreateShaper() and a Text::AbstractShaper subclass instead. Only public APIs of the old interface are preserved for backward compatibility with existing application code.
• The Text::AbstractGlyphCache::begin() / end() access via std::unordered_map iterators is removed. Use Text::AbstractGlyphCache::glyph() for accessing properties of a particular glyph, for accessing all glyph data then glyphIdsInto(), glyphOffsets() const and glyphRectangles() const.
• The Text::AbstractGlyphCache::image() query now returns a MutableImageView3D instead of an Image2D in order to support incremental population and texture arrays

• Shaders::Generic::Color3 / Shaders::Generic::Color4 location changed from 3 to 2
• Shaders::Generic::Normal location changed from 2 to 5
• Shaders::Generic::Tangent location changed from 4 to 3

• Audio::Buffer::Format, use Audio::BufferFormat instead
• Shaders::*Vector::setVectorTexture(), Shaders::Flat::setTexture(), Shaders::Phong::setAmbientTexture(), Shaders::Phong::setDiffuseTexture(), Shaders::Phong::setSpecularTexture() and Shaders::Phong::setTextures(), use Shaders::*Vector::bindVectorTexture(), Shaders::Flat::bindTexture(), Shaders::Phong::bindAmbientTexture(), Shaders::Phong::bindDiffuseTexture(), Shaders::Phong::bindSpecularTexture() and Shaders::Phong::bindTextures() instead

Fixed the Magnum::Application, Magnum::WindowlessApplication and Magnum::GLContext aliases in FindMagnum.cmake to propagate the values from the target they alias also across directories, instead of failing with e.g.

Error evaluating generator expression:

$<TARGET_PROPERTY:Magnum::Sdl2Application,INTERFACE_INCLUDE_DIRECTORIES>

Target "Magnum::Sdl2Application" not found.

• GL::Mesh::IndexType and GL::Mesh::indexSize(), use GL::MeshIndexType and GL::Mesh::indexTypeSize() instead

• update your HTML markup to use <canvas id="canvas"> instead of <canvas id="module">
• in case you have a copy or a fork of the JS driver file, it needs to define Module.canvas as document.getElementById('canvas') (instead of 'module')
• and for CSS files, all references to #module need to be #canvas now