This is a snapshot of a work-in-progress documentation theme. If you feel lost, miss something, or want to see the original Doxygen docs instead, head over to the archived version of this documentation page.

Utilities » Font conversion utility

Converts font to raster one of given atlas size.


magnum-fontconverter [--magnum-...] [-h|--help] --font FONT
    --converter CONVERTER [--plugin-dir DIR] [--characters CHARACTERS]
    [--font-size N] [--atlas-size "X Y"] [--output-size "X Y"] [--radius N]
    [--] input output


  • input — input font
  • output — output filename prefix
  • -h, --help — display help message and exit
  • --font FONT — font plugin
  • --converter CONVERTER — font converter plugin
  • --plugin-dir DIR — base plugin dir (defaults to plugin directory in Magnum install location)
  • --characters CHARACTERS — characters to include in the output (default: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789?!:;,. )
  • --font-size N — input font size (default: 128)
  • --atlas-size "X Y" — glyph atlas size (default: "2048 2048")
  • --output-size "X Y" — output atlas size. If set to zero size, distance field computation will not be used. (default: "256 256")
  • --radius N — distance field computation radius (default: 24)
  • --magnum-... — engine-specific options (see Context for details)

The resulting font files can be then used as specified in the documentation of converter plugin.

Example usage

Making raster font from TTF file with default set of characters using FreeTypeFont font plugin and MagnumFontConverter converter plugin:

magnum-fontconverter --font FreeTypeFont --converter MagnumFontConverter DejaVuSans.ttf myfont

According to MagnumFontConverter plugin documentation, this will generate files myfont.conf and myfont.tga in current directory. You can then load and use them via the MagnumFont plugin.