Collects and provides information about available fonts in system. More...

#include <Font_FontMgr.hxx>

Inheritance diagram for Font_FontMgr:

Public Member Functions
void	AvailableFonts (Font_NListOfSystemFont &theList) const
	Return the list of available fonts. More...

Font_NListOfSystemFont	GetAvailableFonts () const
	Return the list of available fonts. More...

void	GetAvailableFontsNames (TColStd_SequenceOfHAsciiString &theFontsNames) const
	Returns sequence of available fonts names. More...

Handle< Font_SystemFont >	GetFont (const Handle< TCollection_HAsciiString > &theFontName, const Font_FontAspect theFontAspect, const Standard_Integer theFontSize) const
	Returns font that match given parameters. If theFontName is empty string returned font can have any FontName. If theFontAspect is Font_FA_Undefined returned font can have any FontAspect. If theFontSize is "-1" returned font can have any FontSize. More...

Handle< Font_SystemFont >	GetFont (const TCollection_AsciiString &theFontName) const
	Returns font that match given name or NULL if such font family is NOT registered. Note that unlike FindFont(), this method ignores font aliases and does not look for fall-back. More...

Handle< Font_SystemFont >	FindFont (const TCollection_AsciiString &theFontName, Font_StrictLevel theStrictLevel, Font_FontAspect &theFontAspect) const
	Tries to find font by given parameters. If the specified font is not found tries to use font names mapping. If the requested family name not found -> search for any font family with given aspect and height. If the font is still not found, returns any font available in the system. Returns NULL in case when the fonts are not found in the system. More...

Handle< Font_SystemFont >	FindFont (const TCollection_AsciiString &theFontName, Font_FontAspect &theFontAspect) const
	Tries to find font by given parameters. More...

Handle< Font_SystemFont >	FindFallbackFont (Font_UnicodeSubset theSubset, Font_FontAspect theFontAspect) const
	Tries to find fallback font for specified Unicode subset. Returns NULL in case when fallback font is not found in the system. More...

Handle< Font_SystemFont >	CheckFont (const Standard_CString theFontPath) const
	Read font file and retrieve information from it. More...

Standard_Boolean	RegisterFont (const Handle< Font_SystemFont > &theFont, const Standard_Boolean theToOverride)
	Register new font. If there is existing entity with the same name and properties but different path then font will be overridden or ignored depending on theToOverride flag. More...

Standard_Boolean	ToTraceAliases () const
	Return flag for tracing font aliases usage via Message_Trace messages; TRUE by default. More...

void	SetTraceAliases (Standard_Boolean theToTrace)
	Set flag for tracing font alias usage; useful to trace which fonts are actually used. Can be disabled to avoid redundant messages with Message_Trace level. More...

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor. More...

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing. More...

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter. More...

virtual	~Standard_Transient ()
	Destructor must be virtual. More...

virtual void	Delete () const
	Memory deallocator for transient classes. More...

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object. More...

Standard_Boolean	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type. More...

Standard_Boolean	IsInstance (const Standard_CString theTypeName) const
	Returns a true value if this is an instance of TypeName. More...

Standard_Boolean	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Boolean	IsKind (const Standard_CString theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism. More...

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero. More...

Standard_Integer	GetRefCount () const
	Get the reference counter of this object. More...

void	IncrementRefCounter () const
	Increments the reference counter of this object. More...

Standard_Integer	DecrementRefCounter () const
	Decrements the reference counter of this object; returns the decremented value. More...

Static Public Member Functions
static Handle< Font_FontMgr >	GetInstance ()
	Return global instance of font manager. More...

static const char *	FontAspectToString (Font_FontAspect theAspect)
	Return font aspect as string. More...

static Standard_Boolean &	ToUseUnicodeSubsetFallback ()
	Return flag to use fallback fonts in case if used font does not include symbols from specific Unicode subset; TRUE by default. More...

Static Public Member Functions inherited from Standard_Transient
static const char *	get_type_name ()
	Returns a type descriptor about this object. More...

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class. More...

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object. More...

Detailed Description

Collects and provides information about available fonts in system.

Member Function Documentation

◆ AvailableFonts()

void Font_FontMgr::AvailableFonts ( Font_NListOfSystemFont & theList ) const

inline

Return the list of available fonts.

◆ CheckFont()

Handle< Font_SystemFont > Font_FontMgr::CheckFont ( const Standard_CString theFontPath ) const

Read font file and retrieve information from it.

◆ FindFallbackFont()

Handle< Font_SystemFont > Font_FontMgr::FindFallbackFont	(	Font_UnicodeSubset	theSubset,
		Font_FontAspect	theFontAspect
	)		const

Tries to find fallback font for specified Unicode subset. Returns NULL in case when fallback font is not found in the system.

Parameters

theSubset	[in] Unicode subset
theFontAspect	[in] font aspect to find

◆ FindFont() [1/2]

Handle< Font_SystemFont > Font_FontMgr::FindFont	(	const TCollection_AsciiString &	theFontName,
		Font_StrictLevel	theStrictLevel,
		Font_FontAspect &	theFontAspect
	)		const

Tries to find font by given parameters. If the specified font is not found tries to use font names mapping. If the requested family name not found -> search for any font family with given aspect and height. If the font is still not found, returns any font available in the system. Returns NULL in case when the fonts are not found in the system.

Parameters

theFontName	[in] font family to find or alias name
theStrictLevel	[in] search strict level for using aliases and fallback
theFontAspect	[in] [out] font aspect to find (considered only if family name is not found); can be modified if specified font alias refers to another style (compatibility with obsolete aliases)

◆ FindFont() [2/2]

Handle< Font_SystemFont > Font_FontMgr::FindFont	(	const TCollection_AsciiString &	theFontName,
		Font_FontAspect &	theFontAspect
	)		const

inline

Tries to find font by given parameters.

◆ FontAspectToString()

static const char* Font_FontMgr::FontAspectToString ( Font_FontAspect theAspect )

inlinestatic

Return font aspect as string.

◆ GetAvailableFonts()

Font_NListOfSystemFont Font_FontMgr::GetAvailableFonts ( ) const

inline

Return the list of available fonts.

◆ GetAvailableFontsNames()

void Font_FontMgr::GetAvailableFontsNames ( TColStd_SequenceOfHAsciiString & theFontsNames ) const

Returns sequence of available fonts names.

◆ GetFont() [1/2]

Handle< Font_SystemFont > Font_FontMgr::GetFont	(	const Handle< TCollection_HAsciiString > &	theFontName,
		const Font_FontAspect	theFontAspect,
		const Standard_Integer	theFontSize
	)		const

Returns font that match given parameters. If theFontName is empty string returned font can have any FontName. If theFontAspect is Font_FA_Undefined returned font can have any FontAspect. If theFontSize is "-1" returned font can have any FontSize.

◆ GetFont() [2/2]

Handle< Font_SystemFont > Font_FontMgr::GetFont ( const TCollection_AsciiString & theFontName ) const

Returns font that match given name or NULL if such font family is NOT registered. Note that unlike FindFont(), this method ignores font aliases and does not look for fall-back.

◆ GetInstance()

static Handle< Font_FontMgr > Font_FontMgr::GetInstance ( )

static

Return global instance of font manager.

◆ RegisterFont()

Standard_Boolean Font_FontMgr::RegisterFont	(	const Handle< Font_SystemFont > &	theFont,
		const Standard_Boolean	theToOverride
	)

Register new font. If there is existing entity with the same name and properties but different path then font will be overridden or ignored depending on theToOverride flag.

◆ SetTraceAliases()

void Font_FontMgr::SetTraceAliases ( Standard_Boolean theToTrace )

inline

Set flag for tracing font alias usage; useful to trace which fonts are actually used. Can be disabled to avoid redundant messages with Message_Trace level.

◆ ToTraceAliases()

Standard_Boolean Font_FontMgr::ToTraceAliases ( ) const

inline

Return flag for tracing font aliases usage via Message_Trace messages; TRUE by default.

◆ ToUseUnicodeSubsetFallback()

static Standard_Boolean& Font_FontMgr::ToUseUnicodeSubsetFallback ( )

static

Return flag to use fallback fonts in case if used font does not include symbols from specific Unicode subset; TRUE by default.

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

Font_FontMgr.hxx

Font_FontMgr Class Reference

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AvailableFonts()

◆ CheckFont()

◆ FindFallbackFont()

◆ FindFont() [1/2]

◆ FindFont() [2/2]

◆ FontAspectToString()

◆ GetAvailableFonts()

◆ GetAvailableFontsNames()

◆ GetFont() [1/2]

◆ GetFont() [2/2]

◆ GetInstance()

◆ RegisterFont()

◆ SetTraceAliases()

◆ ToTraceAliases()

◆ ToUseUnicodeSubsetFallback()