magnum/doc/generated/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 .

Primitive images

Generated by the primitives executable. Run it in this directory, the output is put into doc/ directory. Apply pngcrush to them for smaller file sizes:

for f in $(ls primitives-*.png); do pngcrush -ow $f; done

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
  

Apply pngcrush to the result for smaller file sizes:

for f in $(ls shaders-*.png); do pngcrush -ow $f; done