|
|
|
|
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 .
|
|
|
|
|
|
|
|
|
|
### "Getting started" image
|
|
|
|
|
|
|
|
|
|
Displayed by the `hello` executable. Run the app and take screenshot using
|
|
|
|
|
KSnapshot (including decorations, 880x707). Similarly for the gray version. The
|
|
|
|
|
resulting files should be resized to half the size and without alpha channel
|
|
|
|
|
using imagemagick:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
mogrify -flatten -background '#ffffff' -resize 440 getting-started.png
|
|
|
|
|
mogrify -flatten -background '#ffffff' -resize 440 getting-started-blue.png
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The output printed by the application can be used to update the example output
|
|
|
|
|
in `doc/getting-started.dox`.
|
|
|
|
|
|
|
|
|
|
### 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:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
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`
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
magnum-distancefieldconverter --importer PngImporter --converter PngImageConverter --output-size "64 64" --radius 16 vector-src.png vector-distancefield.png
|
|
|
|
|
```
|
