Base class for GlyphLib-based font wrapper using GL textures. More...

#include <FntWrapGlyphLibGL.h>

Inheritance diagram for CFntWrapGlyphLibGL:

Static Public Member Functions
static eC_Bool	CreateInstance (const eC_UInt &uiGlyphCacheInitialSize=32, const eC_Bool &bGlyphCacheAutoResize=true, const eC_UInt &uiGlyphCacheResizeBy=10)

Static Public Member Functions inherited from CFntWrapGlyphLib
static eC_Bool	CreateInstance ()

Static Public Member Functions inherited from CFntWrap
static void	DeleteInstance ()

Protected Member Functions
virtual eC_Int	GetAscender () const

virtual eC_Int	GetDescender () const

virtual void	GetGlyphMetrics (const eC_Char cChar, GlyphMetrics_t &kMetrics)

virtual eC_Int	GetInternalLeading () const

virtual void	LoadFont (const FontResource_t &eFontID)

virtual eC_Bool	SetNOFFonts (const eC_UInt uiNOFFonts)

virtual void	UnloadFont (const FontResource_t &eFontID)

Protected Member Functions inherited from CFntWrapGlyphLib
virtual eC_Int	GetAscender () const

virtual eC_Int	GetDescender () const

virtual void	GetGlyphMetrics (const eC_Char cChar, GlyphMetrics_t &kMetrics)

virtual eC_Int	GetInternalLeading () const

virtual void	RenderGlyphToScreen (const eC_Value &vX1, const eC_Value &vY1, CGUIImageData &kGlyphImage)

virtual void	RenderTextInternal (const eC_String *lpString, const TextOperation_t &eOperation, const eC_Value &vX1, const eC_Value &vY1, eC_Value &vWidth, eC_Value &vHeight, eC_Value vWidthMax, eC_UInt &uiNumFittingChars)

eC_Bool	SetNOFFonts (const eC_UInt uiNOFFonts)

void	Text (const eC_Value &vX1, const eC_Value &vY1, const eC_String *const lpString)

Protected Member Functions inherited from CFntWrap
	CFntWrap ()
	Constructor.

virtual	~CFntWrap ()
	Destructor.

Protected Attributes
eC_TArray< CFntWrapGLFontAtlas * >	m_apGLFontAtlas
	The font cache array is an eC_TArray of CFntWrapGlyphLibGLCache pointers.

Protected Attributes inherited from CFntWrapGlyphLib
eC_TArray< FontEntry_s >	m_kFontsHandles
	handles of all loaded fonts

eC_UInt	m_uiCurrentFontIndex
	the currently used font-index

Protected Attributes inherited from CFntWrap
FontResource_t	m_eCurFont
	Current font id.

CGUICommonEnums::Rotation_t	m_eRotation
	Rotation.

eC_UInt	m_uiNOFFonts
	Total number of fonts.

eC_Value	m_vSpacing
	Font spacing, i.e the space between letters.

Additional Inherited Members
Public Types inherited from CFntWrap
enum	GUIFont_t { FNT_NORMAL = 0 , FNT_ITALIC = 1 , FNT_UNDERLINED = 2 , FNT_BOLD = 4 }

enum	TextOperation_t { RENDER_TEXT , GET_REQUIRED_SPACE }

Public Member Functions inherited from CFntWrapGlyphLib
void	LoadFont (const FontResource_t &eFontID)

void	RequiredSpace (const eC_String *const pkText, eC_Value &vWidth, eC_Value &vHeight)

void	SetFont (const FontResource_t &eID)

void	UnloadFont (const FontResource_t &eFontID)

Public Member Functions inherited from CFntWrap
void	ChangeFont (const FontResource_t &eFontID, const eC_String &pcPath, const eC_UInt uiFontSize, const GUIFont_t &eFontStyle)

virtual void	FittingNumChars (const eC_String *const pkText, eC_Value vWidthMax, eC_UInt &uiNumChars, const eC_Bool &bStartAtEnd=false)

virtual eC_Int	GetAscender () const

virtual eC_Int	GetDescender () const

virtual void	GetGlyphMetrics (const eC_Char cChar, GlyphMetrics_t &kMetrics)

virtual eC_Int	GetInternalLeading () const

virtual eC_UInt	GetNOFFonts ()

CGUICommonEnums::Rotation_t	GetRotation () const

virtual eC_Value	GetTextXPosAdjustment (const CGUIText::HorAligned_t eHorAlignment)

virtual eC_Value	GetTextYPosAdjustment (const CGUIText::VerAligned_t eVerAlignment)

virtual void	LoadFont (const FontResource_t &eFontID)

virtual void	RequiredSpace (const eC_String *const pkText, eC_Value &vWidth, eC_Value &vHeight)=0

virtual void	SetFont (const FontResource_t &eID)

virtual void	SetFontSpacing (const eC_Float &fSpacing)

virtual eC_Bool	SetNOFFonts (const eC_UInt uiNOFFonts)

void	SetRotation (const CGUICommonEnums::Rotation_t &eRotation)

virtual void	Text (const eC_Value &vX1, const eC_Value &vY1, const eC_String *const lpString)=0

virtual void	UnloadFont (const FontResource_t &eFontID)

Detailed Description

Base class for GlyphLib-based font wrapper using GL textures.

This class uses the class FntWrapGlyphLibGLCache for displaying GlyphLib fonts using the OpenGL-Wrapper.

Member Function Documentation

◆ CreateInstance()

static eC_Bool CFntWrapGlyphLibGL::CreateInstance	(	const eC_UInt &	uiGlyphCacheInitialSize = `32`,
		const eC_Bool &	bGlyphCacheAutoResize = `true`,
		const eC_UInt &	uiGlyphCacheResizeBy = `10`
	)

static

Creates the instance of this wrapper.

Parameters

uiGlyphCacheInitialSize	initial size for glyph-cache
bGlyphCacheAutoResize	if true the cache will be resized if necessary
uiGlyphCacheResizeBy	amount of glyph to be resized

Returns: True if successful, False otherwise

◆ GetAscender()

virtual eC_Int CFntWrapGlyphLibGL::GetAscender ( ) const

protectedvirtual

Returns the currently set font's ascender-metric. If the ascender is not supported by a given Font-Wrapper, this returns 0.

Returns: ascender in pixels

Reimplemented from CFntWrapGlyphLib.

◆ GetDescender()

virtual eC_Int CFntWrapGlyphLibGL::GetDescender ( ) const

protectedvirtual

Returns the currently set font's descender-metric. If the descender is not supported by a given Font-Wrapper, this returns 0.

Returns: descender in pixels

Reimplemented from CFntWrapGlyphLib.

◆ GetGlyphMetrics()

virtual void CFntWrapGlyphLibGL::GetGlyphMetrics	(	const eC_Char	cChar,
		GlyphMetrics_t &	kMetrics
	)

protectedvirtual

Get the metrics of a glyph for a specific character

Parameters

cChar	character
kMetrics	metrics of glyph

Reimplemented from CFntWrapGlyphLib.

◆ GetInternalLeading()

virtual eC_Int CFntWrapGlyphLibGL::GetInternalLeading ( ) const

protectedvirtual

Returns the currently set font's internal leading. If the internal leading is not supported by a given Font-Wrapper, this returns 0.

Returns: internal leading in pixels

Reimplemented from CFntWrapGlyphLib.

◆ LoadFont()

virtual void CFntWrapGlyphLibGL::LoadFont ( const FontResource_t & eFontID )

protectedvirtual

Loads a font identified by eFontID into an array of fonts at position eFontID. If the font already exists, it's not loaded again. Should only be called by a FntWrapper.

Parameters

eFontID id (and hence index) of the font. False else.

Reimplemented from CFntWrapGlyphLib.

◆ SetNOFFonts()

virtual eC_Bool CFntWrapGlyphLibGL::SetNOFFonts ( const eC_UInt uiNOFFonts )

protectedvirtual

Sets the total number of fonts. This is called internally by the ResourceManager when dynamically allocated font resources require the total number of fonts to be raised. Derived classes will have to override this method and resize their internal font-storage structures according to the new number of fonts which will have to be stored.

Parameters

uiNOFFonts The number of fonts

Returns: True if internal storage has been successfully adapted to support the requested number of fonts. False otherwise.

Reimplemented from CFntWrapGlyphLib.

◆ UnloadFont()

virtual void CFntWrapGlyphLibGL::UnloadFont ( const FontResource_t & eFontID )

protectedvirtual

Unloading is not supported by GlyphLib

Parameters

eFontID FontID to unload

Reimplemented from CFntWrapGlyphLib.

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

FntWrapGlyphLibGL.h

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ CreateInstance()

◆ GetAscender()

◆ GetDescender()

◆ GetGlyphMetrics()

◆ GetInternalLeading()

◆ LoadFont()

◆ SetNOFFonts()

◆ UnloadFont()