ic
/
magnum
mirror of https://github.com/mosra/magnum.git
6
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4949 Commits
21 Branches
19 Tags
70 MiB
 
 
 
 
 
Tree: 1a10ee7515
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '1a10ee7515'
${ noResults }
magnum/doc/generated
Vladimír Vondruš 1a10ee7515
doc: don't use deprecated functionality. 		10 years ago
..
.gitattributes Shaders: there's never enough documentation. 11 years ago
CMakeLists.txt Modern CMake usage: reworked to use target-specific properties. 10 years ago
README.md doc: updated also Getting Started image to the new color. 11 years ago
configure.h.cmake Hell, this project is big. 10 years ago
hello.cpp doc: don't use deprecated functionality. 10 years ago
shaders.cpp Explicitly use Magnum::Math::Literals namespace. 10 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 .

"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:

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:

    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