Magnum::Text::HarfBuzzFont class

HarfBuzz font plugin.

Improves FreeTypeFont with HarfBuzz text layouting capabilities, such as kerning, ligatures etc.

This plugin provides the TrueTypeFont and OpenTypeFont plugins.


This plugin depends on the Text and HarfBuzz libraries and the FreeTypeFont plugin. It is built if MAGNUM_WITH_HARFBUZZFONT is enabled when building Magnum Plugins. To use as a dynamic plugin, load "HarfBuzzFont" via Corrade::PluginManager::Manager.

Additionally, if you're using Magnum as a CMake subproject, bundle the magnum-plugins repository and do the following. Using HarfBuzz itself as a CMake subproject isn't tested at the moment, so you need to provide it as a system dependency and point CMAKE_PREFIX_PATH to its installation dir if necessary.

add_subdirectory(magnum-plugins EXCLUDE_FROM_ALL)

# So the dynamically loaded plugin gets built implicitly
add_dependencies(your-app MagnumPlugins::HarfBuzzFont)

To use as a static plugin or as a dependency of another plugin with CMake, put FindMagnumPlugins.cmake and FindHarfBuzz.cmake into your modules/ directory, request the HarfBuzzFont component of the MagnumPlugins package and link to the MagnumPlugins::HarfBuzzFont target:

find_package(MagnumPlugins REQUIRED HarfBuzzFont)

# ...
target_link_libraries(your-app PRIVATE MagnumPlugins::HarfBuzzFont)

See Downloading and building plugins, Plugin usage with CMake and Loading and using plugins for more information.

Base classes

class FreeTypeFont
FreeType font plugin.

Public static functions

static void initialize()
Initialize the HarfBuzz library.
static void finalize()
Finalize the HarfBuzz library.

Constructors, destructors, conversion operators

HarfBuzzFont() explicit
Default constructor.
HarfBuzzFont(PluginManager::AbstractManager& manager, const Containers::StringView& plugin) explicit
Plugin manager constructor.

Function documentation

static void Magnum::Text::HarfBuzzFont::initialize()

Initialize the HarfBuzz library.

Empty in order to avoid FreeTypeFont::initialize() being called again when initializing this plugin.

static void Magnum::Text::HarfBuzzFont::finalize()

Finalize the HarfBuzz library.

Empty in order to avoid FreeTypeFont::finalize() being called again when initializing this plugin.