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 Types inherited from Object
using	NullAccess = cc::NullAccess
	Error thrown when trying to access a null object.
using	VirginityTestFailed = cc::VirginityTestFailed
	Error thrown when trying to initialize an object with a non-virgin state.

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.
int	useCount () const
	Reference count.
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.

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.