FTFontMan Class Reference

A static class to allow access to fonts managed by FreeType. More...

#include <ftfonts.h>

Inheritance diagram for FTFontMan:

List of all members.

Public Member Functions
	FTFontMan ()
	Default constructor.
Static Public Member Functions
static BOOL	GetAscentDescent (CharDescription &ChDesc, INT32 *pAscent, INT32 *pDescent)
	This function returns the ascent and descent of a given font scaled to DefaultHeight.
static BOOL	GetCharWidth (CharDescription &ChDesc, TCHAR FirstChar, TCHAR LastChar, INT32 *pCharWidthsBuf)
	This function returns the widths of a range of characters scaled to DefaultHeight.
static INT32	GetCharsKerning (CharDescription &FontDesc, TCHAR LeftChar, TCHAR RightChar)
	This function returns the kerning between two glyphs scaled to DefaultHeight.
static void	EnumAllFonts (OILEnumFonts *pClass)
	Gives the kernel a way of enumerating fonts itself.
static FontClass	GetFontClass (String_64 &FaceName)
	Checks that the font is installed, is scalable and not a virtual font. Reports FC_TRUETYPE or FC_ATM. Reports FC_UNDEFINED if either of the above is not true or if the type could not be established.
static void	AddFontToCache (ENUMLOGFONT &EnumLogFont)
	Add the given font to the font list cache.
static BOOL	FontIsCached (ENUMLOGFONT &EnumLogFont)
	Check whether the given font is in the font list cache If it is, update its Referenced field as a side-effect.
static void	UpdateCache ()
	Update the font list cache to reflect the wxWidgets font enumeration.
Static Private Member Functions
static BOOL	IsOkToCall ()
	Determine whether we can make further calls to the TrueType Manager.
static BOOL	CacheNamedFont (String_64 *pFont)
	This function attempts to cache a font supported by FreeType. It caches the font in the kernels font list, and hence can be accessed via FONTMANAGER-> calls.
static BOOL	CacheCompatibleFont (String_64 *pFont)
	This function attempts to cache a compatible font.
static void	ValidateCache ()
	This function will attempt to recache all FreeType fonts within the kernels font manager cache.
static void	FindClosestFont ()
	Enumerates all the fonts reporting each to the Panose matcher in FontMan.
static FTFont *	CreateNewFont (String_64 *pFontName, FontClass Class)
	This function attempts to create a font instance and will be called by the font manager when new fonts are added.
static OUTLINETEXTMETRIC *	GetOutlineTextMetric (LOGFONT *pLogFont)
	get the Panose structure for a font
static BOOL	GetCharOutline (CharDescription &ChDesc, DocCoord **ppCoords, PathVerb **ppVerbs, UINT32 *pNumCoords, wxDC *pDC)
	Get the path associated with a given character.
static BOOL	CacheFontCore (String_64 *pFont, BOOL compatible)
	This function attempts to cache a font supported by FreeType. It caches the font in the kernels font list, and hence can be accessed via FONTMANAGER-> calls.
Static Private Attributes
static FTFontCache *	m_cache = NULL
Friends
class	OILFontMan

---

Detailed Description

A static class to allow access to fonts managed by FreeType.

Author:

Martin Wuerthner <xara@mw-software.com>

Date:

22/02/06

Definition at line 177 of file ftfonts.h.

---

Constructor & Destructor Documentation

FTFontMan::FTFontMan (   )

Default constructor. Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 12/09/95 Definition at line 214 of file ftfonts.cpp. { }

---

Member Function Documentation

void FTFontMan::AddFontToCache (  ENUMLOGFONT &  EnumLogFont  )  [static]

Add the given font to the font list cache. Author: Martin Wuerthner <xara@mw-software.com> Date: 19/05/06 Parameters: EnumLogFont  - the face name wrapped in a LOGFONT/ENUMLOGFONT structure [INPUTS] Definition at line 594 of file ftfonts.cpp. { FontClass OurFontClass = FTFontMan::GetFontClass(EnumLogFont.elfLogFont.FaceName); FTFontCacheEntry OurEntry(OurFontClass, TRUE); (*m_cache)[EnumLogFont] = OurEntry; }

BOOL FTFontMan::CacheCompatibleFont (  String_64 *  pFontName  )  [static, private]

This function attempts to cache a compatible font. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Parameters: pFontName  = a pointer to a fontname to find and cache [INPUTS] -  [OUTPUTS] Returns: TRUE if the font has been cached FALSE if not. Definition at line 368 of file ftfonts.cpp. { return CacheFontCore(pFontName, TRUE); }

BOOL FTFontMan::CacheFontCore (  String_64 *  pFontName, BOOL  compatible )  [static, private]

This function attempts to cache a font supported by FreeType. It caches the font in the kernels font list, and hence can be accessed via FONTMANAGER-> calls. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Parameters: pFontName  = a pointer to a fontname to find and cache [INPUTS] compatible = if TRUE, an inexact match can be tolerated, else we want an exact match -  [OUTPUTS] Returns: TRUE if the font has been cached FALSE if not. Definition at line 260 of file ftfonts.cpp. { DumpString64User("wuerthne", _T("FTFontMan::CacheNamedFont"), pFontName); TRACEUSER("wuerthne", _T("compatible = %d"), compatible); PangoContext* pPangoContext = GetPangoContext(); PangoFontMap* pFontMap = pango_context_get_font_map(pPangoContext); PangoFontDescription* pDescription = pango_font_description_new(); char ASCIIName[64]; // TYPENOTE: Correct - Pango wants a plain char name if (!ToASCII((TCHAR*)*pFontName, ASCIIName, 64)) return FALSE; // we ask Pango for a font with the given name pango_font_description_set_family_static(pDescription, ASCIIName); pango_font_description_set_style(pDescription, PANGO_STYLE_NORMAL); pango_font_description_set_weight(pDescription, PANGO_WEIGHT_NORMAL); pango_font_description_set_size(pDescription, 12 * PANGO_SCALE); PangoFont* pFont = pango_font_map_load_font(pFontMap, pPangoContext, pDescription); pango_font_description_free(pDescription); // Pango will always give us some font, no matter whether the font we asked // for is installed or not, so check what we really got PangoFontDescription *pRealDesc = pango_font_describe(pFont); wxString wxName(pango_font_description_get_family(pRealDesc), wxConvUTF8); String_64 OurFontName(wxName); DumpString64User("wuerthne", _T("Got font"), &OurFontName); TRACEUSER("wuerthne", _T("real font description has style = %d, weight = %d"), pango_font_description_get_style(pRealDesc), pango_font_description_get_weight(pRealDesc)); pango_font_description_free(pRealDesc); // NB - Apart from the following "if" this routine only fails in case of a technical error // not because the required font is not present. At the moment, we only check that we // got the right font if compatible == FALSE, but we are always called with // compatible == TRUE afterwards, so effectively, we always find a font, in the worst // case some system default font. That means that the clever Panose matching code is // never used because it is only called if both passes (first with compatible == FALSE // then with compatible == TRUE) fail. Removing the "!compatible" check on the other // hand means that we only allow an exact match and hence cannot make use of fontconfig's // font substitution service, most notably using the user's own font substitution rules. // check whether the font name is the same as the one we asked for (case-insensitive) if (!compatible && !pFontName->IsEmpty() && OurFontName.CompareTo(*pFontName, FALSE) != 0) { // we wanted an exact match, but the names do not match, so do not cache the font TRACEUSER("wuerthne", _T("Name did not match, so fail")); return FALSE; } // register the font with the kernel TRACEUSER("wuerthne", _T("Register font")); Application* pApp = GetApplication(); FontManager* pFontMan = pApp->GetFontManager(); ENUMLOGFONT OurEnumLogFont; OurEnumLogFont.elfLogFont.FaceName = OurFontName; FontClass Class = GetFontClass(OurFontName); if (Class == FC_TRUETYPE || Class == FC_ATM) { pFontMan->SetTempFont(Class, &OurFontName, &OurEnumLogFont); // kernel copies the ENUMLOGFONT structure return TRUE; } return FALSE; }

BOOL FTFontMan::CacheNamedFont (  String_64 *  pFontName  )  [static, private]

This function attempts to cache a font supported by FreeType. It caches the font in the kernels font list, and hence can be accessed via FONTMANAGER-> calls. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Parameters: pFontName  = a pointer to a fontname to find and cache [INPUTS] -  [OUTPUTS] Returns: TRUE if the font has been cached FALSE if not. Definition at line 341 of file ftfonts.cpp. { TRACEUSER("wuerthne", _T("CacheNamedFont %08x"), pFontName); if (pFontName == NULL) { // we are called with a NULL pointer from the kernel, so pass an empty string instead, // which will probably prompt Pango to return its default font TRACEUSER("wuerthne", _T("CacheNamedFont called with NULL ptr, using emtpy string instead")); String_64 FontName(_T("")); return CacheFontCore(&FontName, FALSE); } else return CacheFontCore(pFontName, FALSE); }

FTFont * FTFontMan::CreateNewFont (  String_64 *  pFontName, FontClass  Class )  [static, private]

This function attempts to create a font instance and will be called by the font manager when new fonts are added. Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 12/9/95 Parameters: pFontName  = a pointer to a fontname [INPUTS] Returns: NULL if no FreeType font structure has been created A pointer to a FreeType font structure if successfull. Definition at line 701 of file ftfonts.cpp. { DumpString64User("wuerthne", _T("FTFontMan::CreateNewFont"), pFontName); FTFont* pFont = new FTFont(Class); if (pFont && !pFont->Initialise(pFontName)) { delete pFont; return NULL; } return pFont; }

void FTFontMan::EnumAllFonts (  OILEnumFonts *  pOilEnumerator  )  [static]

Gives the kernel a way of enumerating fonts itself. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Parameters: pOilEnumerator  = A pointer to an object to call back. [INPUTS] Definition at line 665 of file ftfonts.cpp. { // use wxWidgets to enumerate all font families TRACEUSER("wuerthne", _T("FTFontMan::EnumAllFonts")); // we cache the results so we first check whether the cache can still be used UpdateCache(); // now, simply return the information from the cache BOOL go_on = TRUE; for (FTFontCache::iterator it = m_cache->begin(); go_on && it != m_cache->end(); ++it) { FontClass OurFontClass = (*it).second.m_Class; if (OurFontClass == FC_TRUETYPE || OurFontClass == FC_ATM) { ENUMLOGFONT EnumLogFont = (*it).first; go_on = pOilEnumerator->NewFont(OurFontClass, &EnumLogFont); } } TRACEUSER("wuerthne", _T("FTFontMan::EnumAllFonts done")); }

void FTFontMan::FindClosestFont (   )  [static, private]

Enumerates all the fonts reporting each to the Panose matcher in FontMan. Author: Martin Wuerthner <xara@mw-software.com> Date: 19/04/06 Definition at line 489 of file ftfonts.cpp. { // use wxWidgets to enumerate all font families TRACEUSER("wuerthne", _T("FTFonMan::FindClosestFont")); ClosestFontEnumerator WxEnumerator; WxEnumerator.EnumerateFacenames(); }

BOOL FTFontMan::FontIsCached (  ENUMLOGFONT &  EnumLogFont  )  [static]

Check whether the given font is in the font list cache If it is, update its Referenced field as a side-effect. Author: Martin Wuerthner <xara@mw-software.com> Date: 19/05/06 Parameters: EnumLogFont  - the face name wrapped in a LOGFONT/ENUMLOGFONT structure [INPUTS] Returns: TRUE if the font is in the cache Definition at line 572 of file ftfonts.cpp. { FTFontCache::iterator it = m_cache->find(EnumLogFont); if (it != m_cache->end()) { (*it).second.m_Referenced = TRUE; return TRUE; } return FALSE; }

BOOL FTFontMan::GetAscentDescent (  CharDescription &  ChDesc, INT32 *  pAscent, INT32 *  pDescent )  [static]

This function returns the ascent and descent of a given font scaled to DefaultHeight. Author: Martin Wuerthner <xara@mw-software.com> Date: 09/03/06 Parameters: chDesc  - a Kernel character description (to identify the font) [INPUTS] font  ascent and descent in pAscent and pDescent [OUTPUTS] Returns: TRUE if the values could be retrieved FALSE if not. Definition at line 1349 of file ftfonts.cpp. { PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; // TRACEUSER("wuerthne", _T("GetAscentDescent")); if (!GetPangoFcFontAndFreeTypeFaceForCharDesc(ChDesc, &pPangoFcFont, &pFreeTypeFace)) return FALSE; // get the design size INT32 DesignSize = pFreeTypeFace->units_per_EM; *pAscent = ScaleToDefaultHeight(pFreeTypeFace->ascender, DesignSize); *pDescent = ScaleToDefaultHeight(-pFreeTypeFace->descender, DesignSize); // TRACEUSER("wuerthne", _T("returning ascent = %d, descent = %d"), *pAscent, *pDescent); pango_fc_font_unlock_face(pPangoFcFont); return TRUE; }

BOOL FTFontMan::GetCharOutline (  CharDescription &  ChDesc, DocCoord **  ppCoords, PathVerb **  ppVerbs, UINT32 *  pNumCoords, wxDC *  pDC )  [static, private]

Get the path associated with a given character. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Parameters: ChDesc  = description of char [INPUTS] pDC = (possible) pointer to a DC (for optimisation) defaults to NULL ppCoords  = pointer to path coords buffer [OUTPUTS] ppVerbs = pointer to path verbs buffer pNumCoords = number of elements in path Returns: FALSE if unable to generate the character outline Definition at line 1219 of file ftfonts.cpp. { // TRACEUSER("wuerthne", _T("FTFontMan::GetCharOutline %04x"), ChDesc.GetCharCode()); // Check some input parameters ERROR2IF(ppCoords==NULL,FALSE,"FTFontMan::GetCharOutline ppCoords==NULL"); ERROR2IF(ppVerbs==NULL,FALSE,"FTFontMan::GetCharOutline ppVerbs==NULL"); ERROR2IF(pNumCoords==NULL,FALSE,"FTFontMan::GetCharOutline pNumCoords==NULL"); PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; if (!GetPangoFcFontAndFreeTypeFaceForCharDesc(ChDesc, &pPangoFcFont, &pFreeTypeFace)) return FALSE; // get the design size INT32 DesignSize = pFreeTypeFace->units_per_EM; // TRACEUSER("wuerthne", _T("DesignSize = %d"), DesignSize); // load the glyph data for our character into the font's glyph slot if (FT_Load_Char(pFreeTypeFace, ChDesc.GetCharCode(), FT_LOAD_NO_SCALE)) { pango_fc_font_unlock_face(pPangoFcFont); ERROR2(FALSE, "FTFontMan::GetCharOutline - could not load glyph"); } FT_GlyphSlotRec *pGlyph = pFreeTypeFace->glyph; // TRACEUSER("wuerthne", _T("found outline, %d contours, %d points"), // pGlyph->outline.n_contours, pGlyph->outline.n_points); // finally, we have the glyph we want, so transfer it to the outlines cache OILFontMan::InitialiseOutlineCache(); FT_Outline_Funcs funcs = { AddMoveTo, AddLineTo, AddConicTo, AddCubicTo, 0, 0 }; DecompState state; state.DesignSize = DesignSize; state.IsFirstMove = TRUE; // TRACEUSER("wuerthne", _T("calling Outline_Decompose")); if (FT_Outline_Decompose(&pGlyph->outline, &funcs, &state)) { OILFontMan::FinaliseOutlineCache(); pango_fc_font_unlock_face(pPangoFcFont); return FALSE; } // TRACEUSER("wuerthne", _T("Outline_Decompose success")); // close the last contour if there was any output at all if (!state.IsFirstMove) { OILFontMan::ClosePath(); } OILFontMan::FinaliseOutlineCache(); pango_fc_font_unlock_face(pPangoFcFont); (*pNumCoords) = OILFontMan::GetOutlineCache(ppCoords,ppVerbs); // TRACEUSER("wuerthne", _T("FTFontMan::GetCharOutline Returning %d coords"), *pNumCoords); return TRUE; }

INT32 FTFontMan::GetCharsKerning (  CharDescription &  FontDesc, TCHAR  LeftChar, TCHAR  RightChar )  [static]

This function returns the kerning between two glyphs scaled to DefaultHeight. Author: Martin Wuerthner <xara@mw-software.com> Date: 19/04/06 Parameters: FontDesc  - a Kernel character description (to identify the font) [INPUTS] LeftChar, RightChar - left and right character -  [OUTPUTS] Returns: the kerning to be applied between LeftChar and RightChar Definition at line 1424 of file ftfonts.cpp. { PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; // TRACEUSER("wuerthne", _T("GetCharsKerning, %04x %04x"), LeftChar, RightChar); if (!GetPangoFcFontAndFreeTypeFaceForCharDesc(FontDesc, &pPangoFcFont, &pFreeTypeFace)) return 0; // get the design size INT32 DesignSize = pFreeTypeFace->units_per_EM; FT_ULong LeftIndex = FT_Get_Char_Index(pFreeTypeFace, LeftChar); FT_ULong RightIndex = FT_Get_Char_Index(pFreeTypeFace, RightChar);; FT_Vector kerning; FT_Error FreeTypeError; if ((FreeTypeError = FT_Get_Kerning(pFreeTypeFace, LeftIndex, RightIndex, FT_KERNING_UNSCALED, &kerning)) != 0) { TRACEUSER("wuerthne", _T("could not get kerning, error = %d"), FreeTypeError); return 0; } // TRACEUSER("wuerthne", _T("Got kerning: %d"), kerning.x); pango_fc_font_unlock_face(pPangoFcFont); return ScaleToDefaultHeight(kerning.x, DesignSize); }

BOOL FTFontMan::GetCharWidth (  CharDescription &  ChDesc, TCHAR  FirstChar, TCHAR  LastChar, INT32 *  pCharWidthsBuf )  [static]

This function returns the widths of a range of characters scaled to DefaultHeight. Author: Martin Wuerthner <xara@mw-software.com> Date: 09/03/06 Parameters: chDesc  - a Kernel character description (to identify the font) [INPUTS] FirstChar - first character to get the width for LastChar - last character character  widths into pCharWidthsBuf [OUTPUTS] Returns: TRUE if the widths could be retrieved FALSE if not. Definition at line 1383 of file ftfonts.cpp. { // TRACEUSER("wuerthne", _T("FTFontMan::GetCharWidth first=%04x last=%04x"), FirstChar, LastChar); UINT32 NumChars = LastChar - FirstChar + 1; PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; if (!GetPangoFcFontAndFreeTypeFaceForCharDesc(ChDesc, &pPangoFcFont, &pFreeTypeFace)) return FALSE; // get the design size INT32 DesignSize = pFreeTypeFace->units_per_EM; // TRACEUSER("wuerthne", _T("GetCharWidth, DesignSize = %d"), DesignSize); for (UINT32 i = 0; i < NumChars; i++) { // load the glyph data for our character into the font's glyph slot if (FT_Load_Char(pFreeTypeFace, FirstChar + i, FT_LOAD_NO_SCALE | FT_LOAD_LINEAR_DESIGN)) { pango_fc_font_unlock_face(pPangoFcFont); ERROR2(FALSE, "FTFontMan::GetCharWidth - could not load glyph"); } FT_GlyphSlotRec *pGlyph = pFreeTypeFace->glyph; pCharWidthsBuf[i] = ScaleToDefaultHeight(pGlyph->linearHoriAdvance, DesignSize); } pango_fc_font_unlock_face(pPangoFcFont); return TRUE; }

FontClass FTFontMan::GetFontClass (  String_64 &  FaceName  )  [static]

Checks that the font is installed, is scalable and not a virtual font. Reports FC_TRUETYPE or FC_ATM. Reports FC_UNDEFINED if either of the above is not true or if the type could not be established. Author: Martin Wuerthner <xara@mw-software.com> Date: 18/05/06 Parameters: FaceName  - the name of the font we want to enquire about [INPUTS] Definition at line 406 of file ftfonts.cpp. { FontClass fc = FC_UNDEFINED; PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; if (GetPangoFcFontAndFreeTypeFaceForFaceName(&FaceName, &pPangoFcFont, &pFreeTypeFace)) { // At this stage, we know that the font is scalable, otherwise the above call // would have returned an error already. Now, check whether this is a virtual // font (e.g., "Monospace") presented to us by fontconfig. We do that by reading // back the family name and comparing it to the one we passed. PangoFontDescription *pRealDesc = pango_font_describe((PangoFont*)pPangoFcFont); wxString wxName(pango_font_description_get_family(pRealDesc), wxConvUTF8); String_64 OurFontName(wxName); pango_font_description_free(pRealDesc); if (OurFontName.CompareTo(FaceName, FALSE) == 0) { PS_FontInfoRec PSRec; if (FT_Get_PS_Font_Info(pFreeTypeFace, &PSRec) != FT_Err_Invalid_Argument) fc = FC_ATM; else { if (FT_IS_SFNT(pFreeTypeFace)) fc = FC_TRUETYPE; else { // scalable, but not PS-based and not SFNT-based, so not TrueType either // ignore this for the time being, but we can probably support this type // of font } } } pango_fc_font_unlock_face(pPangoFcFont); } return fc; }

OUTLINETEXTMETRIC * FTFontMan::GetOutlineTextMetric (  LOGFONT *  pLogFont  )  [static, private]

get the Panose structure for a font Author: Martin Wuerthner <xara@mw-software.com> Date: 19/04/06 Parameters: pLogFont  = font descriptor [INPUTS] Returns: an OUTLINETEXTMETRIC structure or NULL if the information cannot be obtained (Panose information is only available for TrueType fonts, not for Type-1 fonts) The caller is responsible for freeing the structure Definition at line 1297 of file ftfonts.cpp. { String_64* pFaceName = &pLogFont->FaceName; PangoFcFont* pPangoFcFont; FT_Face pFreeTypeFace; // DumpString64User("wuerthne", _T("FTFontMan::GetOutlineTextMetric"), pFaceName); // first of all, retrieve the underlying font information if (!GetPangoFcFontAndFreeTypeFaceForFaceName(pFaceName, &pPangoFcFont, &pFreeTypeFace)) return NULL; // we have successfully retrieved the FreeType information (we need to release it below!) // ask FreeType for the Panose information - this is found in the OS/2 font table, // so check whether this font has a TrueType OS/2 font table TT_OS2* pOS2_Table; if ((pOS2_Table = (TT_OS2*)FT_Get_Sfnt_Table(pFreeTypeFace, ft_sfnt_os2)) == NULL /* error loading */ || pOS2_Table->version == 0xffff /* Mac font without OS/2 table */) { // we could not get the table with the Panose information, either because there // was an error when trying to load it or because the font is not a TrueType font, // or because it is an old Mac TrueType font without Panose information pango_fc_font_unlock_face(pPangoFcFont); return NULL; } // we have got the OS/2 table - it is owned by the face object so we need not free it, // it will disappear when we unlock the font face below // We need a permanent structure - the pointer may be cached. Otherwise, the kernel // will free the structure. OUTLINETEXTMETRIC* pMetric = new OUTLINETEXTMETRIC; pMetric->otmPanoseNumber = *((struct PANOSE*)&pOS2_Table->panose); // TRACEUSER("wuerthne", _T("returning valid OUTLINEFONTMETRIC structure")); pango_fc_font_unlock_face(pPangoFcFont); return pMetric; }

BOOL FTFontMan::IsOkToCall (   )  [static, private]

Determine whether we can make further calls to the TrueType Manager. static BOOL TTFontMan::IsOkToCall() Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 01/9/95 Returns: TRUE if the FreeType manager is actually running and can be used on this OpSys Definition at line 229 of file ftfonts.cpp. { // Currently its always true as this is the wxOil return TRUE; }

void FTFontMan::UpdateCache (   )  [static]

Update the font list cache to reflect the wxWidgets font enumeration. Author: Martin Wuerthner <xara@mw-software.com> Date: 19/05/06 Parameters: -  [INPUTS] Definition at line 612 of file ftfonts.cpp. { MyFontEnumerator::CacheAction action; if (m_cache) { // we already have a cache, so just update it incrementally action = MyFontEnumerator::UpdateCache; // we want to purge entries that are no longer installed, so mark all entries as unreferenced // the cache update step will mark all the fonts it finds as Referenced for (FTFontCache::iterator it = m_cache->begin(); it != m_cache->end(); ++it) (*it).second.m_Referenced = FALSE; } else { // initial run m_cache = new FTFontCache; action = MyFontEnumerator::FillCache; } MyFontEnumerator FontEnumerator(action); FontEnumerator.EnumerateFacenames(); if (action == MyFontEnumerator::UpdateCache) { // delete all fonts that have been deinstalled since we last checked for (FTFontCache::iterator it = m_cache->begin(); it != m_cache->end();) { if (!(*it).second.m_Referenced) { TRACEUSER("wuerthne", _T("%s removed from font list cache"), (const TCHAR*)((*it).first.elfLogFont.FaceName)); // NB - it++ first increments the iterator, then returns the iterator // to the current element, which is then deleted - this is safe, // as opposed to first deleting and then incrementing m_cache->erase(it++); } else { ++it; } } } }

void FTFontMan::ValidateCache (   )  [static, private]

This function will attempt to recache all FreeType fonts within the kernels font manager cache. Author: Martin Wuerthner <xara@mw-software.com> Date: 06/03/06 Definition at line 384 of file ftfonts.cpp. { PORTNOTETRACE("text", "FTFontMan::ValidateCache - do nothing"); }

---

Friends And Related Function Documentation

friend class OILFontMan [friend]

Definition at line 181 of file ftfonts.h.

---

Member Data Documentation

FTFontCache * FTFontMan::m_cache = NULL [static, private]

Definition at line 216 of file ftfonts.h.

---

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

• wxOil/ftfonts.h (r1785/r1138)
• wxOil/ftfonts.cpp (r1785/r1535)

---