diff --git a/doc/changelog.dox b/doc/changelog.dox index 966356a7b..b487ac05d 100644 --- a/doc/changelog.dox +++ b/doc/changelog.dox @@ -191,6 +191,8 @@ See also: @subsection changelog-latest-docs Documentation - Fixed various broken links (see [mosra/magnum#291](https://github.com/mosra/magnum/issues/291)) +- A dedicated @ref types-thirdparty-integration section listing all + provided integrations with 3rd party math APIs @subsection changelog-latest-deprecated Deprecated APIs diff --git a/doc/types.dox b/doc/types.dox index ea2702a6d..cecdff0e1 100644 --- a/doc/types.dox +++ b/doc/types.dox @@ -24,14 +24,15 @@ */ namespace Magnum { -/** @page types Type system -@brief Type aliases, naming and compatibility with OpenGL and GLSL types. +/** @page types Math type system +@brief Type aliases, naming and compatibility with OpenGL, Vulkan and GLSL types. @tableofcontents @m_footernavigation +@m_keyword{Type system,,} -The root @ref Magnum namespace defines a few aliases for essential types. See -its documentation for more information about usage with CMake. +The root @ref Magnum namespace defines a few aliases for essential math types. +See its documentation for more information about usage. @section types-builtin Builtin types @@ -205,5 +206,26 @@ explicit: Example: @snippet MagnumMath.cpp types-literals-init + +@section types-thirdparty-integration Integration with types from 3rd party APIs + +To simplify the workflow when interacting with 3rd party APIs, all Magnum math +types can be made explicitly convertible to and from types coming from external +libraries. Currently, various Magnum libraries provide these conversion, see +documentation of each `Integration.h` header for details: + +- Math-related Vulkan structures --- @ref Magnum/Vk/Integration.h, part of + the @ref Vk library +- All GLM types --- @ref Magnum/GlmIntegration/Integration.h, + @ref Magnum/GlmIntegration/GtcIntegration.h and + @ref Magnum/GlmIntegration/GtxIntegration.h, part of the + @ref GlmIntegration library +- Bullet Physics math types --- @ref Magnum/BulletIntegration/Integration.h, + part of the @ref BulletIntegration library +- Oculus VR SDK math types -- @ref Magnum/OvrIntegration/Integration.h, part + of the @ref OvrIntegration library +- ImGui math types --- @ref Magnum/ImGuiIntegration/Integration.h, part of + the @ref ImGuiIntegration library + */ }