Keep track of application fonts. More...

#include <cc/FontManager>

Inheritance diagram for FontManager:

Public Types
using	FontRange = Function<void(const Font &font, long i0, long i1)>
	Inform about fonts covering ranges of text.

Public Member Functions
	FontManager ()
	Get access to the platform's font manager.

void	addPath (const String &dirPath, const String &namePrefix="")
	Make font directory known to the font manager.

Set< FontFamily >	fontFamilies () const
	Return set of all available font families

FontFamily	selectFontFamily (const String &name) const
	Select font family which matches best giving name.

ScaledFont	selectFont (const Font &font) const
	Select font which matches best giving font selector font.

GlyphRun	typeset (const String &text, const Font &font, const Point &origin=Point{}) const
	Typeset a text and return the resulting glyph run.

TextRun	createTextRun () const
	Create a new text run.

void	selectFontRanges (const String &text, const Font &font, const FontRange &fontRange) const
	Select a proper font for each range of text.

Public Member Functions inherited from Object
	Object ()=default
	Create a null object.

	operator bool () const
	Check if this is a non-null object.

bool	isNull () const
	Check if this is a null object.

template<class T >
bool	is () const
	Check if this object is of type T.

template<class T >
T	as () const
	Cast this object to type T.

bool	isWeak () const
	Check if the underlying object reference is weak.

bool	operator== (const Object &other) const
	Equality operator.

std::strong_ordering	operator<=> (const Object &other) const
	Ordering operator.

long	useCount () const
	Reference count.

Protected Member Functions
	FontManager (State *state)

void	addFontFace (const FontFace &fontFace)

State &	me ()

const State &	me () const

Protected Member Functions inherited from ThreadLocalSingleton
	ThreadLocalSingleton ()=default
	Create a null singleton.

	ThreadLocalSingleton (State *state)
	Initialize singleton object with instance state.

Protected Member Functions inherited from Object
template<class T >
T	weak () const

template<class T >
void	initOnce ()
	Create the object state when called the first time.

template<class T >
void	initOncePerThread ()
	Create a distinct object state for each thread when called the first time in that thread.

	Object (State *newState)
	Initialize object with newState.

	Object (State *state, Alias)

	Object (State *state, Weak)

Object &	operator= (std::nullptr_t)

Additional Inherited Members
Static Protected Member Functions inherited from ThreadLocalSingleton
template<class T >
static T *	instance ()
	Get access to the singleton instance.

Static Protected Member Functions inherited from Object
template<class T >
static T	alias (const State *state)
	Create an alias object for the given state.

template<class T >
static T	weak (const State *state)

Protected Attributes inherited from Object
Handle< State >	me
	Internal object state

Detailed Description

Keep track of application fonts.

Exceptions

FontError

Member Typedef Documentation

◆ FontRange

using FontRange = Function<void(const Font &font, long i0, long i1)>

Inform about fonts covering ranges of text.

Constructor & Destructor Documentation

◆ FontManager()

FontManager ( )

Get access to the platform's font manager.

Member Function Documentation

◆ addPath()

void addPath	(	const String &	dirPath,
		const String &	namePrefix = "" )

Make font directory known to the font manager.

◆ fontFamilies()

Set< FontFamily > fontFamilies ( ) const

Return set of all available font families

◆ selectFontFamily()

FontFamily selectFontFamily ( const String & name ) const

Select font family which matches best giving name.

◆ selectFont()

ScaledFont selectFont ( const Font & font ) const

Select font which matches best giving font selector font.

◆ typeset()

GlyphRun typeset	(	const String &	text,
		const Font &	font,
		const Point &	origin = Point{} ) const

Typeset a text and return the resulting glyph run.

Parameters

text	Text to typeset
font	Font to use
origin	Starting position

◆ createTextRun()

TextRun createTextRun ( ) const

Create a new text run.

◆ selectFontRanges()

void selectFontRanges	(	const String &	text,
		const Font &	font,
		const FontRange &	fontRange ) const

Select a proper font for each range of text.