magnum

History

Vladimír Vondruš 799870021e Converting APIs returning std::optional to Containers::Optional. And removing the bundled std::optional implementation. This finally makes this library compatible with C++17. Since this would be a huge backwards-incompatible change that would make everyone angry, the following had to be done in case both CORRADE_BUILD_DEPRECATED and MAGNUM_BUILD_DEPRECATED is defined: * Under C++11 and C++14, Containers::Optional / Containers::NullOpt is aliased to std::optional / std::nullopt. This is no worse than the state before, when we also provided these symbols. * Under C++17, where standard <optional> header is available, Containers::Optional provides implicit conversion to it. Only one-way conversion is supported, as there was fortunately no Magnum API that took std::optional via parameter, and there might be some corner cases that this doesn't cover. The goal is to have all examples compiling with the old API, at least. * There's a new test especially for this, which checks that both the C++11 and C++17 ways of doing things work as they should. The typedef and conversion is marked as deprecated, so it will spit out many warnings to push users to upgrade. I hope I can completely remove this mess soon :/		8 years ago
..
.gitattributes	Shaders: there's never enough documentation.	11 years ago
CMakeLists.txt	doc: using an actual snippet from the getting started app source.	8 years ago
README.md	doc: using an actual snippet from the getting started app source.	8 years ago
configure.h.cmake	Updated copyright year.	8 years ago
shaders.cpp	Converting APIs returning std::optional to Containers::Optional.	8 years ago
vector-distancefield.png	Shaders: there's never enough documentation.	11 years ago
vector.png	Shaders: there's never enough documentation.	11 years ago
vector.svg	Shaders: there's never enough documentation.	11 years ago

README.md

Source files for images in Magnum documentation

Compile and install Magnum with Sdl2Application, windowless application for your platform and magnum-distancefieldconverter utility and any PngImporter and PngImageConverter plugins from Magnum Plugins.

Create build dir, point CMake to this directory and compile the executables:

mkdir build-doc
cd build-doc
cmake ../doc/generated
cmake --build .

Shader images

Generated by the shaders executable. Must be run in this directory, the output is put into doc/ directory. The executable requires two textures:

vector.png, generated as full-page PNG output at 90 DPI from vector.svg, converted to pure grayscale using imagemagick:
```
mogrify -flatten -background '#ffffff' -format grayscale vector.png
```

vector-distancefield.png, generated as full-page PNG output at 360 DPI (1024x1024) and then processed through magnum-distancefieldconverter

magnum-distancefieldconverter --importer PngImporter --converter PngImageConverter --output-size "64 64" --radius 16 vector-src.png vector-distancefield.png