The font rendering class, see IFont. More...

#include <murl_util_font.h>

Detailed Description

The font rendering class, see IFont.

Inheritance diagram for Murl::Util::Font:

Public Member Functions
	Font (const Resource::IFont *resourceFont, Real size)
	Constructor taking a font resource and size. More...

	~Font () override
	The destructor.

Bool	SetSize (Real size) override
	Implementation of IFont::SetSize(). More...

Real	GetSize () const override
	Implementation of IFont::GetSize(). More...

Bool	SetAscent (Real ascent) override
	Implementation of IFont::SetAscent(). More...

Real	GetAscent () const override
	Implementation of IFont::GetAscent(). More...

Bool	SetDescent (Real descent) override
	Implementation of IFont::SetDescent(). More...

Real	GetDescent () const override
	Implementation of IFont::GetDescent(). More...

Bool	SetSpacing (Real spacing) override
	Implementation of IFont::SetSpacing(). More...

Real	GetSpacing () const override
	Implementation of IFont::GetSpacing(). More...

Bool	SetLeading (Real leading) override
	Implementation of IFont::SetLeading(). More...

Real	GetLeading () const override
	Implementation of IFont::GetLeading(). More...

Bool	SetOffset (Real offsetX, Real offsetY) override
	Implementation of IFont::SetOffset(). More...

Bool	SetOffsetX (Real offsetX) override
	Implementation of IFont::SetOffsetX(). More...

Bool	SetOffsetY (Real offsetY) override
	Implementation of IFont::SetOffsetY(). More...

Real	GetOffsetX () const override
	Implementation of IFont::GetOffsetX(). More...

Real	GetOffsetY () const override
	Implementation of IFont::GetOffsetY(). More...

Bool	SetRaster (Real rasterX, Real rasterY) override
	Implementation of IFont::SetRaster(). More...

Bool	SetRasterX (Real rasterX) override
	Implementation of IFont::SetRasterX(). More...

Bool	SetRasterY (Real rasterY) override
	Implementation of IFont::SetRasterY(). More...

Real	GetRasterX () const override
	Implementation of IFont::GetRasterX(). More...

Real	GetRasterY () const override
	Implementation of IFont::GetRasterY(). More...

Bool	SetEmbolding (Real strength) override
	Implementation of IFont::SetEmbolding(). More...

Real	GetEmbolding () const override
	Implementation of IFont::GetEmbolding(). More...

Bool	SetBlur (Real strength) override
	Implementation of IFont::SetBlur(). More...

Real	GetBlur () const override
	Implementation of IFont::GetBlur(). More...

Bool	SetSpaceWidthFactor (Real factor) override
	Implementation of IFont::SetSpaceWidthFactor(). More...

Real	GetSpaceWidthFactor () const override
	Implementation of IFont::GetSpaceWidthFactor(). More...

Bool	SetDigitWidthFactor (Real factor) override
	Implementation of IFont::SetDigitWidthFactor(). More...

Real	GetDigitWidthFactor () const override
	Implementation of IFont::GetDigitWidthFactor(). More...

Bool	SetSameDigitWidthEnabled (Bool enabled) override
	Implementation of IFont::SetSameDigitWidthEnabled(). More...

Bool	IsSameDigitWidthEnabled () const override
	Implementation of IFont::IsSameDigitWidthEnabled(). More...

Bool	SetLegacyEmboldingEnabled (Bool enabled) override
	Implementation of IFont::SetLegacyEmboldingEnabled(). More...

Bool	IsLegacyEmboldingEnabled () const override
	Implementation of IFont::IsLegacyEmboldingEnabled(). More...

Bool	RenderText (const String &text, const Color &textColor, const Color &backgroundColor, Bool clearSurface, Bool enableWordWrap, Real containerPosX, Real containerPosY, Real containerSizeX, Real containerSizeY, IEnums::TextAlignmentX alignX, IEnums::TextAlignmentY alignY, IVideoSurface *surface) const override
	Implementation of IFont::RenderText(). More...

Bool	QueryTextSize (const String &text, Bool enableWordWrap, Real containerPosX, Real containerPosY, Real containerSizeX, Real containerSizeY, Real &textSizeX, Real &textSizeY) const override
	Implementation of IFont::QueryTextSize(). More...

virtual void	SetResourceFont (const Resource::IFont *resourceFont)
	Set the font resource. More...

virtual const Resource::IFont *	GetResourceFont () const
	Get the font resource. More...

Constructor & Destructor Documentation

◆ Font()

Murl::Util::Font::Font	(	const Resource::IFont *	resourceFont,
		Real	size
	)

Constructor taking a font resource and size.

Parameters

resourceFont	The font resource.
size	The size of the font.

Member Function Documentation

◆ SetSize()

Bool Murl::Util::Font::SetSize ( Real size )

overridevirtual

Implementation of IFont::SetSize().

Parameters

size	The font size.

Returns: true if successful.

Implements Murl::IFont.

◆ GetSize()

Real Murl::Util::Font::GetSize ( ) const

overridevirtual

Implementation of IFont::GetSize().

Returns: The font size.

Implements Murl::IFont.

◆ SetAscent()

Bool Murl::Util::Font::SetAscent ( Real ascent )

overridevirtual

Implementation of IFont::SetAscent().

Parameters

ascent The font ascent.

Returns: true if successful.

Implements Murl::IFont.

◆ GetAscent()

Real Murl::Util::Font::GetAscent ( ) const

overridevirtual

Implementation of IFont::GetAscent().

Returns: The font ascent.

Implements Murl::IFont.

◆ SetDescent()

Bool Murl::Util::Font::SetDescent ( Real descent )

overridevirtual

Implementation of IFont::SetDescent().

Parameters

descent The font descent.

Returns: true if successful.

Implements Murl::IFont.

◆ GetDescent()

Real Murl::Util::Font::GetDescent ( ) const

overridevirtual

Implementation of IFont::GetDescent().

Returns: The font descent.

Implements Murl::IFont.

◆ SetSpacing()

Bool Murl::Util::Font::SetSpacing ( Real spacing )

overridevirtual

Implementation of IFont::SetSpacing().

Parameters

spacing The character spacing value.

Returns: true if successful.

Implements Murl::IFont.

◆ GetSpacing()

Real Murl::Util::Font::GetSpacing ( ) const

overridevirtual

Implementation of IFont::GetSpacing().

Returns: The character spacing value.

Implements Murl::IFont.

◆ SetLeading()

Bool Murl::Util::Font::SetLeading ( Real leading )

overridevirtual

Implementation of IFont::SetLeading().

Parameters

leading The leading value.

Returns: true if successful.

Implements Murl::IFont.

◆ GetLeading()

Real Murl::Util::Font::GetLeading ( ) const

overridevirtual

Implementation of IFont::GetLeading().

Returns: The font leading value.

Implements Murl::IFont.

◆ SetOffset()

Bool Murl::Util::Font::SetOffset	(	Real	offsetX,
		Real	offsetY
	)

overridevirtual

Implementation of IFont::SetOffset().

Parameters

offsetX	The horizontal offset.
offsetY	The vertical offset.

Returns: true if successful.

Implements Murl::IFont.

◆ SetOffsetX()

Bool Murl::Util::Font::SetOffsetX ( Real offsetX )

overridevirtual

Implementation of IFont::SetOffsetX().

Parameters

offsetX The horizontal offset.

Returns: true if successful.

Implements Murl::IFont.

◆ SetOffsetY()

Bool Murl::Util::Font::SetOffsetY ( Real offsetY )

overridevirtual

Implementation of IFont::SetOffsetY().

Parameters

offsetY The vertical offset.

Returns: true if successful.

Implements Murl::IFont.

◆ GetOffsetX()

Real Murl::Util::Font::GetOffsetX ( ) const

overridevirtual

Implementation of IFont::GetOffsetX().

Returns: The horizontal offset.

Implements Murl::IFont.

◆ GetOffsetY()

Real Murl::Util::Font::GetOffsetY ( ) const

overridevirtual

Implementation of IFont::GetOffsetY().

Returns: The vertical offset.

Implements Murl::IFont.

◆ SetRaster()

Bool Murl::Util::Font::SetRaster	(	Real	rasterX,
		Real	rasterY
	)

overridevirtual

Implementation of IFont::SetRaster().

Parameters

rasterX	The horizontal raster value.
rasterY	The vertical raster value.

Returns: true if successful.

Implements Murl::IFont.

◆ SetRasterX()

Bool Murl::Util::Font::SetRasterX ( Real rasterX )

overridevirtual

Implementation of IFont::SetRasterX().

Parameters

rasterX The horizontal raster value.

Returns: true if successful.

Implements Murl::IFont.

◆ SetRasterY()

Bool Murl::Util::Font::SetRasterY ( Real rasterY )

overridevirtual

Implementation of IFont::SetRasterY().

Parameters

rasterY The vertical raster value.

Returns: true if successful.

Implements Murl::IFont.

◆ GetRasterX()

Real Murl::Util::Font::GetRasterX ( ) const

overridevirtual

Implementation of IFont::GetRasterX().

Returns: The horizontal raster value.

Implements Murl::IFont.

◆ GetRasterY()

Real Murl::Util::Font::GetRasterY ( ) const

overridevirtual

Implementation of IFont::GetRasterY().

Returns: The vertical raster value.

Implements Murl::IFont.

◆ SetEmbolding()

Bool Murl::Util::Font::SetEmbolding ( Real strength )

overridevirtual

Implementation of IFont::SetEmbolding().

Parameters

strength The embolding strength value.

Returns: true if successful.

Implements Murl::IFont.

◆ GetEmbolding()

Real Murl::Util::Font::GetEmbolding ( ) const

overridevirtual

Implementation of IFont::GetEmbolding().

Returns: The embolding strength value.

Implements Murl::IFont.

◆ SetBlur()

Bool Murl::Util::Font::SetBlur ( Real strength )

overridevirtual

Implementation of IFont::SetBlur().

Parameters

strength The positive blur strength value.

Returns: true if successful.

Implements Murl::IFont.

◆ GetBlur()

Real Murl::Util::Font::GetBlur ( ) const

overridevirtual

Implementation of IFont::GetBlur().

Returns: The blur strength value.

Implements Murl::IFont.

◆ SetSpaceWidthFactor()

Bool Murl::Util::Font::SetSpaceWidthFactor ( Real factor )

overridevirtual

Implementation of IFont::SetSpaceWidthFactor().

Parameters

factor The space width factor.

Returns: true if successful.

Implements Murl::IFont.

◆ GetSpaceWidthFactor()

Real Murl::Util::Font::GetSpaceWidthFactor ( ) const

overridevirtual

Implementation of IFont::GetSpaceWidthFactor().

Returns: The space width factor.

Implements Murl::IFont.

◆ SetDigitWidthFactor()

Bool Murl::Util::Font::SetDigitWidthFactor ( Real factor )

overridevirtual

Implementation of IFont::SetDigitWidthFactor().

Parameters

factor The digit width factor.

Returns: true if successful.

Implements Murl::IFont.

◆ GetDigitWidthFactor()

Real Murl::Util::Font::GetDigitWidthFactor ( ) const

overridevirtual

Implementation of IFont::GetDigitWidthFactor().

Returns: The digit width factor.

Implements Murl::IFont.

◆ SetSameDigitWidthEnabled()

Bool Murl::Util::Font::SetSameDigitWidthEnabled ( Bool enabled )

overridevirtual

Implementation of IFont::SetSameDigitWidthEnabled().

Parameters

enabled If true, all digits use the same horizontal advance value.

Returns: true if successful.

Implements Murl::IFont.

◆ IsSameDigitWidthEnabled()

Bool Murl::Util::Font::IsSameDigitWidthEnabled ( ) const

overridevirtual

Implementation of IFont::IsSameDigitWidthEnabled().

Returns: true if all digits use the same horizontal advance value.

Implements Murl::IFont.

◆ SetLegacyEmboldingEnabled()

Bool Murl::Util::Font::SetLegacyEmboldingEnabled ( Bool enabled )

overridevirtual

Implementation of IFont::SetLegacyEmboldingEnabled().

Parameters

enabled If true, legacy embolding is used.

Returns: true if successful.

Implements Murl::IFont.

◆ IsLegacyEmboldingEnabled()

Bool Murl::Util::Font::IsLegacyEmboldingEnabled ( ) const

overridevirtual

Implementation of IFont::IsLegacyEmboldingEnabled().

Returns: true if used.

Implements Murl::IFont.

◆ RenderText()

Bool Murl::Util::Font::RenderText	(	const String &	text,
		const Color &	textColor,
		const Color &	backgroundColor,
		Bool	clearSurface,
		Bool	enableWordWrap,
		Real	containerPosX,
		Real	containerPosY,
		Real	containerSizeX,
		Real	containerSizeY,
		IEnums::TextAlignmentX	alignX,
		IEnums::TextAlignmentY	alignY,
		IVideoSurface *	surface
	)		const

overridevirtual

Implementation of IFont::RenderText().

Parameters

text	The text to render.
textColor	The text color to render.
backgroundColor	The text background color to render.
clearSurface	If true, the output surface is cleared before rendering.
enableWordWrap	If true, word wrapping is enabled.
containerPosX	The horizontal text position in the video stream.
containerPosY	The vertical text position in the video stream.
containerSizeX	The horizontal size of the text rectangle, or 0 if the video stream's X size should be used
containerSizeY	The vertical size of the text rectangle, or 0 if the video stream's Y size should be used
alignX	The horizontal text alignment.
alignY	The vertical text alignment.
surface	The destination video surface.

Returns: true if successful.

Implements Murl::IFont.

◆ QueryTextSize()

Bool Murl::Util::Font::QueryTextSize	(	const String &	text,
		Bool	enableWordWrap,
		Real	containerPosX,
		Real	containerPosY,
		Real	containerSizeX,
		Real	containerSizeY,
		Real &	textSizeX,
		Real &	textSizeY
	)		const

overridevirtual

Implementation of IFont::QueryTextSize().

Parameters

text	The text to query.
enableWordWrap	If true, word wrapping is enabled.
containerPosX	The horizontal text position in the video stream.
containerPosY	The vertical text position in the video stream.
containerSizeX	The horizontal size of the text rectangle, or 0 if the video stream's X size should be used
containerSizeY	The vertical size of the text rectangle, or 0 if the video stream's Y size should be used
textSizeX	The text width return value.
textSizeY	The text height return value.

Returns: true if successful.

Implements Murl::IFont.

◆ SetResourceFont()

virtual void Murl::Util::Font::SetResourceFont ( const Resource::IFont * resourceFont )

virtual

Set the font resource.

Parameters

resourceFont The font resource.

◆ GetResourceFont()

virtual const Resource::IFont* Murl::Util::Font::GetResourceFont ( ) const

virtual

Get the font resource.

Returns: The font resource.

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

murl_util_font.h

Detailed Description

Public Member Functions

Constructor & Destructor Documentation

◆ Font()

Member Function Documentation

◆ SetSize()

◆ GetSize()

◆ SetAscent()

◆ GetAscent()

◆ SetDescent()

◆ GetDescent()

◆ SetSpacing()

◆ GetSpacing()

◆ SetLeading()

◆ GetLeading()

◆ SetOffset()

◆ SetOffsetX()

◆ SetOffsetY()

◆ GetOffsetX()

◆ GetOffsetY()

◆ SetRaster()

◆ SetRasterX()

◆ SetRasterY()

◆ GetRasterX()

◆ GetRasterY()

◆ SetEmbolding()

◆ GetEmbolding()

◆ SetBlur()

◆ GetBlur()

◆ SetSpaceWidthFactor()

◆ GetSpaceWidthFactor()

◆ SetDigitWidthFactor()

◆ GetDigitWidthFactor()

◆ SetSameDigitWidthEnabled()

◆ IsSameDigitWidthEnabled()

◆ SetLegacyEmboldingEnabled()

◆ IsLegacyEmboldingEnabled()

◆ RenderText()

◆ QueryTextSize()

◆ SetResourceFont()

◆ GetResourceFont()