Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mosra/magnum

Lightweight and modular C++11 graphics middleware for games and data visualization
https://github.com/mosra/magnum

3d android c-plus-plus c-plus-plus-11 cmake emscripten game game-engine gamedev glfw graphics graphics-engine ios magnum opengl sdl spir-v vulkan webassembly webgl

Last synced: 2 days ago
JSON representation

Lightweight and modular C++11 graphics middleware for games and data visualization

Awesome Lists containing this project

README 

        
Magnum — *Lightweight and modular C++11/C++14 graphics middleware for games and data visualization*



Looking for an open-source library that gives you graphics abstraction and

platform independence on major desktop, mobile and web platforms? Do you want

it to have all the convenience utilities around yet stay small, powerful and

not give up on flexibility? *Here it is.* And it's free to use, even for

commercial purposes.



[![Join the chat at https://gitter.im/mosra/magnum](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mosra/magnum?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![Build Status](https://circleci.com/gh/mosra/magnum.svg?style=shield)](https://circleci.com/gh/mosra/magnum)

[![Build Status](https://ci.appveyor.com/api/projects/status/5b477m034cfaskse/branch/master?svg=true)](https://ci.appveyor.com/project/mosra/magnum/branch/master)

[![Coverage Status](https://codecov.io/gh/mosra/magnum/branch/master/graph/badge.svg)](https://codecov.io/gh/mosra/magnum)

[![Hunter Package](https://img.shields.io/badge/hunter-magnum-lightgrey.svg)](https://hunter.readthedocs.io/en/latest/packages/pkg/magnum.html)

[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT)



-   Project homepage — https://magnum.graphics/

-   Documentation — https://doc.magnum.graphics/

-   GitHub project page — https://github.com/mosra/magnum



Beauty of simplicity

====================



Among Magnum essentials is a UTF-8-aware OS, filesystem and console

abstraction, a feature-packed vector math library and a slim C++11 wrapper of

OpenGL / WebGL family of APIs. Build on top of that or opt-in for more.



[See all core features](https://magnum.graphics/features/)



With batteries included

=======================



Shaders and primitives for fast prototyping, algorithms, debugging and

automatic testing, asset management, integration with popular windowing

toolkits and a UI library. Everything fits together but you still have a

choice.



[List the extra features](https://magnum.graphics/features/extras/)



Screws are not glued in

=======================



There's always more than one way to do things. Enjoy the freedom of choice and

integrate your own asset loader, texture compressor, font format or math

library, if you feel the need. Or use any of the various plugins.



[View extension points](https://magnum.graphics/features/extensions/)



-------



*Wondering if Magnum is a good fit for your project?* We prepared

[a few case studies](https://magnum.graphics/is-magnum-what-i-am-looking-for/)

to help you decide.



SUPPORTED PLATFORMS

===================



-   **Linux** and embedded Linux

-   **Windows** with MSVC, clang-cl and MinGW, **Windows RT** (Store/Phone)

-   **macOS**, **iOS**

-   **Android**

-   **Web** ([asm.js](http://asmjs.org/) or [WebAssembly](http://webassembly.org/)),

    through [Emscripten](http://kripken.github.io/emscripten-site/)



Graphics APIs:



-   **OpenGL** 2.1 through 4.6, core profile functionality and modern

    extensions

-   **OpenGL ES** 2.0, 3.0–3.2 and extensions to match desktop OpenGL

    functionality

-   **WebGL** 1.0, 2.0 and extensions to match desktop OpenGL functionality



See the [Build Status page](https://magnum.graphics/build-status/) for detailed

per-platform build status.



WHAT'S NEW?

===========



Curious about what was added or improved recently? Check out the

[Changelog](https://doc.magnum.graphics/magnum/changelog.html#changelog-latest)

page in the documentation.



GETTING STARTED

===============



The best way to get started is to read the thorough

[download, build, install and start using Magnum](https://doc.magnum.graphics/magnum/getting-started.html)

in your project. There is also a complete

[building documentation](https://doc.magnum.graphics/magnum/building.html) — we

provide packages for many platforms, including Windows, Linux and macOS. After

that, there are various [tutorials and examples](https://doc.magnum.graphics/magnum/example-index.html)

and a complete [feature guide](https://doc.magnum.graphics/magnum/features.html)

explaining all aspects of the library.



Apart from that, various Magnum functionality is available through

[single-header libraries](https://doc.magnum.graphics/magnum/singles.html).

Just download a file, `#include` it in your project and you're ready to go! No

buildsystem wrangling needed.



RELATED PROJECTS

================



The engine itself is kept as small as possible with only a few dependencies.

Additional functionality, often depending on external libraries, is provided in

separate repositories.



-   **Corrade** — main Magnum dependency, a multiplatform utility library:

    https://github.com/mosra/corrade

-   **Magnum Bootstrap** — bootstrap projects for many use cases, helping you

    get up and running in no time: https://github.com/mosra/magnum-bootstrap

-   **Magnum Plugins** — various importer plugins for image, font, audio and

    3D model formats are at https://github.com/mosra/magnum-plugins

-   **Magnum Integration** — integration with various external math and

    physics, get it at https://github.com/mosra/magnum-integration

-   **Magnum Examples** — examples of engine usage, varying from simple

    *Hello World*-like example to more advanced applications, such as viewer

    for complex 3D models. See it at https://github.com/mosra/magnum-examples

-   **Magnum Extras** — playground for testing new APIs, specialized stuff

    that doesn't necessarily need to be a part of main Magnum repository or

    mutually exclusive functionality: https://github.com/mosra/magnum-extras

-   **Magnum Bindings** — bindings to other languages such as Python are at

    https://github.com/mosra/magnum-bindings

-   **Magnum Singles** — various functionality from Magnum available as

    easy-to-integrate fast-to-compile single-header libraries:

    https://github.com/mosra/magnum-singles



Outside of the project itself, there's also a lot of community contributions

— [check them out on the website](https://magnum.graphics/features/community/).



CONTACT & SUPPORT

=================



If you want to contribute to Magnum, if you spotted a bug, need a feature or

have an awesome idea, you can get a copy of the sources from GitHub and start

right away! There is the already mentioned guide about

[how to download and build Magnum](https://doc.magnum.graphics/magnum/building.html)

and also a guide about [coding style and best practices](https://doc.magnum.graphics/magnum/coding-style.html)

which you should follow to keep the library as consistent and maintainable as

possible.



-   Project homepage — https://magnum.graphics/

-   Documentation — https://doc.magnum.graphics/

-   GitHub — https://github.com/mosra/magnum and the

    [#magnum](https://github.com/topics/magnum) topic

-   GitLab — https://gitlab.com/mosra/magnum

-   Gitter community chat — https://gitter.im/mosra/magnum

-   E-mail — [email protected]

-   Google Groups mailing list — [email protected] ([archive](https://groups.google.com/forum/#!forum/magnum-engine))

-   Twitter — https://twitter.com/czmosra and the

    [#MagnumEngine](https://twitter.com/hashtag/MagnumEngine) hashtag



See also the Magnum Project [Contact & Support page](https://magnum.graphics/contact/)

for further information.



CREDITS

=======



See the [CREDITS.md](CREDITS.md) file for details. Big thanks to everyone

involved!



LICENSE

=======



Magnum is licensed under the MIT/Expat license, see the [COPYING](COPYING) file

for details.