Utilities » Font conversion utility

Converts font to raster one of given atlas size.

This utility is built if MAGNUM_WITH_FONTCONVERTER is enabled when building Magnum. To use this utility with CMake, you need to request the fontconverter component of the Magnum package and use the Magnum::fontconverter target for example in a custom command:

find_package(Magnum REQUIRED fontconverter)

add_custom_command(OUTPUT ... COMMAND Magnum::fontconverter ...)

See Downloading and building, Usage with CMake and the Text namespace for more information.

Example usage

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

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

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.

Full usage documentation

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 — override base plugin dir
  • --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 Command-line options for details)

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