#include <PdfFontManager.h>

Public Member Functions
	~PdfFontManager ()

PdfFont *	GetFont (PdfObject &obj)

PdfFont *	GetFont (const std::string_view &fontName, const PdfFontCreationParams &params={ })

PdfFont *	GetFont (FT_Face face, const PdfEncoding &encoding=PdfEncodingFactory::CreateWinAnsiEncoding(), bool isSymbolCharset=false, PdfFontInitOptions initOptions=PdfFontInitOptions::Embed)

Detailed Description

This class assists PdfDocument with caching font information.

Additional to font caching, this class is also responsible for font matching.

PdfFont is an actual font that can be used in a PDF file (i.e. it does also font embedding) and PdfFontMetrics provides only metrics informations.

Constructor & Destructor Documentation

PdfFontManager::~PdfFontManager ( )

Destroy and empty the font cache

PdfFont * mm::PdfFontManager::GetFont	(	const std::string_view &	fontName,
		const PdfFontCreationParams &	params = `{ }`
	)

Get a font from the cache. If the font does not yet exist, add it to the cache.

Parameters

fontName	a valid fontname
params	font creation params

Returns: a PdfFont object or nullptr if the font could not be created or found.

PdfFont * PdfFontManager::GetFont	(	FT_Face	face,
		const PdfEncoding &	encoding = `PdfEncodingFactory::CreateWinAnsiEncoding()`,
		bool	isSymbolCharset = `false`,
		PdfFontInitOptions	initOptions = `PdfFontInitOptions::Embed`
	)

Get a font from the cache. If the font does not yet exist, add it to the cache.

Parameters

face	a valid freetype font face (will be free'd by pdfmm)
encoding	the encoding of the font. The font will not take ownership of this object.
isSymbolCharset	whether to use a symbol charset
embed	if true a font for embedding into PDF will be created

Returns: a PdfFont object or nullptr if the font could not be created or found.

PdfFont * PdfFontManager::GetFont ( PdfObject & obj )

Get a font from the cache. If the font does not yet exist, add it to the cache. This font is created from an existing object.

Parameters

obj	a PdfObject that is a font

Returns: a PdfFont object or nullptr if the font could not be created or found.