Font cache for basic fonts. More...

#include <fontcache.h>

Inheritance diagram for FontCache:

Public Member Functions
	FontCache (FontSize fs)
	Create a new font cache. More...

virtual	~FontCache ()
	Clean everything up.

FontSize	GetSize () const
	Get the FontSize of the font. More...

int	GetHeight () const
	Get the height of the font. More...

int	GetAscender () const
	Get the ascender value of the font. More...

int	GetDescender () const
	Get the descender value of the font. More...

virtual int	GetFontSize () const
	Get the nominal font size of the font. More...

virtual void	SetUnicodeGlyph (char32_t key, SpriteID sprite)=0
	Map a SpriteID to the key. More...

virtual void	InitializeUnicodeGlyphMap ()=0
	Initialize the glyph map.

virtual void	ClearFontCache ()=0
	Clear the font cache.

virtual const Sprite *	GetGlyph (GlyphID key)=0
	Get the glyph (sprite) of the given key. More...

virtual uint	GetGlyphWidth (GlyphID key)=0
	Get the width of the glyph with the given key. More...

virtual bool	GetDrawGlyphShadow ()=0
	Do we need to draw a glyph shadow? More...

virtual GlyphID	MapCharToGlyph (char32_t key, bool fallback=true)=0
	Map a character into a glyph. More...

virtual const void *	GetOSHandle ()
	Get the native OS font handle, if there is one. More...

virtual std::string	GetFontName ()=0
	Get the name of this font. More...

bool	HasParent ()
	Check whether the font cache has a parent.

virtual bool	IsBuiltInFont ()=0
	Is this a built-in sprite font?

Static Public Member Functions
static void	InitializeFontCaches ()

static int	GetDefaultFontHeight (FontSize fs)

static FontCache *	Get (FontSize fs)
	Get the font cache of a given font size. More...

static std::string	GetName (FontSize fs)
	Get the font name of a given font size. More...

Protected Attributes
FontCache *	parent
	The parent of this font cache.

const FontSize	fs
	The size of the font.

int	height
	The height of the font.

int	ascender
	The ascender value of the font.

int	descender
	The descender value of the font.

Static Protected Attributes
static FontCache *	caches [FS_END]
	All the font caches.

Detailed Description

Font cache for basic fonts.

Definition at line 21 of file fontcache.h.

Constructor & Destructor Documentation

◆ FontCache()

FontCache::FontCache ( FontSize fs )

Create a new font cache.

Parameters

fs	The size of the font.

Definition at line 35 of file fontcache.cpp.

Member Function Documentation

◆ Get()

static FontCache* FontCache::Get ( FontSize fs )

inlinestatic

Get the font cache of a given font size.

Parameters

fs	The font size to look up.

Returns: The font cache.

Definition at line 129 of file fontcache.h.

References fs.

Referenced by MissingGlyphSearcher::FindMissingGlyphs(), GetCharacterHeight(), GetGlyph(), GetGlyphWidth(), GetName(), SetUnicodeGlyph(), and SurveyFont().

◆ GetAscender()

int FontCache::GetAscender ( ) const

inline

Get the ascender value of the font.

Returns: The ascender value of the font.

Definition at line 54 of file fontcache.h.

References ascender.

◆ GetDescender()

int FontCache::GetDescender ( ) const

inline

Get the descender value of the font.

Returns: The descender value of the font.

Definition at line 60 of file fontcache.h.

References descender.

◆ GetDrawGlyphShadow()

virtual bool FontCache::GetDrawGlyphShadow ( )

pure virtual

Do we need to draw a glyph shadow?

Returns: True if it has to be done, otherwise false.

Implemented in TrueTypeFontCache, MockFontCache, and SpriteFontCache.

◆ GetFontName()

virtual std::string FontCache::GetFontName ( )

pure virtual

Get the name of this font.

Returns: The name of the font.

Implemented in FreeTypeFontCache, Win32FontCache, MockFontCache, CoreTextFontCache, and SpriteFontCache.

Referenced by GetName(), HFontFromFont(), and SurveyFont().

◆ GetFontSize()

virtual int FontCache::GetFontSize ( ) const

inlinevirtual

Get the nominal font size of the font.

Returns: The nominal font size.

Reimplemented in TrueTypeFontCache.

Definition at line 66 of file fontcache.h.

References height.

◆ GetGlyph()

virtual const Sprite* FontCache::GetGlyph ( GlyphID key )

pure virtual

Get the glyph (sprite) of the given key.

Parameters

key	The key to look up.

Returns: The sprite.

Implemented in MockFontCache, TrueTypeFontCache, and SpriteFontCache.

Referenced by GetGlyph().

◆ GetGlyphWidth()

virtual uint FontCache::GetGlyphWidth ( GlyphID key )

pure virtual

Get the width of the glyph with the given key.

Parameters

key	The key to look up.

Returns: The width.

Implemented in MockFontCache, TrueTypeFontCache, and SpriteFontCache.

Referenced by GetGlyphWidth().

◆ GetHeight()

int FontCache::GetHeight ( ) const

inline

Get the height of the font.

Returns: The height of the font.

Definition at line 48 of file fontcache.h.

References height.

Referenced by GetCharacterHeight(), and HFontFromFont().

◆ GetName()

std::string FontCache::GetName ( FontSize fs )

static

Get the font name of a given font size.

Parameters

fs	The font size to look up.

Returns: The font name.

Definition at line 61 of file fontcache.cpp.

References fs, Get(), and GetFontName().

◆ GetOSHandle()

virtual const void* FontCache::GetOSHandle ( )

inlinevirtual

Get the native OS font handle, if there is one.

Returns: Opaque OS font handle.

Reimplemented in FreeTypeFontCache, Win32FontCache, and CoreTextFontCache.

Definition at line 113 of file fontcache.h.

Referenced by HFontFromFont().

◆ GetSize()

FontSize FontCache::GetSize ( ) const

inline

Get the FontSize of the font.

Returns: The FontSize.

Definition at line 42 of file fontcache.h.

References fs.

Referenced by UniscribeShapeRun().

◆ MapCharToGlyph()

virtual GlyphID FontCache::MapCharToGlyph	(	char32_t	key,
		bool	fallback = `true`
	)

pure virtual

Map a character into a glyph.

Parameters

key	The character.
fallback	Allow fallback to the parent font.

Returns: The glyph ID used to draw the character.

Implemented in FreeTypeFontCache, Win32FontCache, CoreTextFontCache, and SpriteFontCache.

Referenced by GetGlyph(), and GetGlyphWidth().

◆ SetUnicodeGlyph()

virtual void FontCache::SetUnicodeGlyph	(	char32_t	key,
		SpriteID	sprite
	)

pure virtual

Map a SpriteID to the key.

Parameters

key	The key to map to.
sprite	The sprite that is being mapped.

Implemented in MockFontCache, TrueTypeFontCache, and SpriteFontCache.

Referenced by TrueTypeFontCache::SetUnicodeGlyph(), and SetUnicodeGlyph().

The documentation for this class was generated from the following files:

src/fontcache.h
src/fontcache.cpp

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FontCache()

Member Function Documentation

◆ Get()

◆ GetAscender()

◆ GetDescender()

◆ GetDrawGlyphShadow()

◆ GetFontName()

◆ GetFontSize()

◆ GetGlyph()

◆ GetGlyphWidth()

◆ GetHeight()

◆ GetName()

◆ GetOSHandle()

◆ GetSize()

◆ MapCharToGlyph()

◆ SetUnicodeGlyph()