CoreComponents 3.0.0
A Modern C++ Toolkit
Loading...
Searching...
No Matches
FontManager Class Reference

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< FontFamilyfontFamilies () 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 >
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 >
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)
 
Objectoperator= (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< Stateme
 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()

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
textText to typeset
fontFont to use
originStarting 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.

Parameters
textText to find covering fonts for
fontDefault font to use
fontRangeFunction to call for each font range