dcpp::gui::IGUIFont Class Reference

Font interface. More...

#include <duckcpp/core/engine/IGUIFont.hpp>

Inheritance diagram for dcpp::gui::IGUIFont:

Collaboration diagram for dcpp::gui::IGUIFont:

Public Member Functions
virtual void	draw (const dcpp::nub::wstring &text, const dcpp::nub::recti &position, dcpp::video::SColor color, bool hcenter=false, bool vcenter=false, const dcpp::nub::recti *clip=0)=0
	Draws some text and clips it to the specified rectangle if wanted.
virtual dcpp::nub::dimension2du	getDimension (const wchar_t *text) const =0
	Calculates the width and height of a given string of text.
virtual dcpp::int32_kt	getCharacterFromPos (const wchar_t *text, dcpp::int32_kt pixel_x) const =0
	Calculates the index of the character in the text which is on a specific position.
virtual EGUI_FONT_TYPE	getType () const
	Returns the type of this font.
virtual void	setKerningWidth (dcpp::int32_kt kerning)=0
	Sets global kerning width for the font.
virtual void	setKerningHeight (dcpp::int32_kt kerning)=0
	Sets global kerning height for the font.
virtual dcpp::int32_kt	getKerningWidth (const wchar_t *thisLetter=0, const wchar_t *previousLetter=0) const =0
	Gets kerning values (distance between letters) for the font. If no parameters are provided,.
virtual dcpp::int32_kt	getKerningHeight () const =0
	Returns the distance between letters.
virtual void	setInvisibleCharacters (const wchar_t *s)=0
	Define which characters should not be drawn by the font.
Public Member Functions inherited from dcpp::IReferenceCounted
	IReferenceCounted ()
	Constructor.
virtual	~IReferenceCounted ()
	Destructor.
void	grab () const
	Grabs the object. Increments the reference counter by one.
bool	drop () const
	Drops the object. Decrements the reference counter by one.
dcpp::int32_kt	getReferenceCount () const
	Get the reference count.
const dcpp::char_kt *	getDebugName () const
	Returns the debug name of the object.

Additional Inherited Members
Protected Member Functions inherited from dcpp::IReferenceCounted
void	setDebugName (const dcpp::char_kt *newName)
	Sets the debug name of the object.

Detailed Description

Font interface.

Member Function Documentation

draw()

virtual void dcpp::gui::IGUIFont::draw ( const dcpp::nub::wstring &  text, const dcpp::nub::recti &  position, dcpp::video::SColor  color, bool  hcenter = false, bool  vcenter = false, const dcpp::nub::recti *  clip = 0  )

pure virtual

Draws some text and clips it to the specified rectangle if wanted.

Parameters

text	Text to draw
position	Rectangle specifying position where to draw the text.
color	Color of the text
hcenter	Specifies if the text should be centered horizontally into the rectangle.
vcenter	Specifies if the text should be centered vertically into the rectangle.
clip	Optional pointer to a rectangle against which the text will be clipped. If the pointer is null, no clipping will be done.

getCharacterFromPos()

virtual dcpp::int32_kt dcpp::gui::IGUIFont::getCharacterFromPos ( const wchar_t *  text, dcpp::int32_kt  pixel_x  ) const

pure virtual

Calculates the index of the character in the text which is on a specific position.

Parameters

text	Text string.
pixel_x	X pixel position of which the index of the character will be returned.

Returns

Returns zero based index of the character in the text, and -1 if no no character is on this position. (=the text is too short).

getDimension()

virtual dcpp::nub::dimension2du dcpp::gui::IGUIFont::getDimension ( const wchar_t *  text ) const

pure virtual

Calculates the width and height of a given string of text.

Returns

Returns width and height of the area covered by the text if it would be drawn.

getKerningWidth()

virtual dcpp::int32_kt dcpp::gui::IGUIFont::getKerningWidth ( const wchar_t *  thisLetter = 0, const wchar_t *  previousLetter = 0  ) const

pure virtual

Gets kerning values (distance between letters) for the font. If no parameters are provided,.

the global kerning distance is returned.

Parameters

thisLetter	If this parameter is provided, the left side kerning for this letter is added to the global kerning value. For example, a space might only be one pixel wide, but it may be displayed as several pixels.
previousLetter	If provided, kerning is calculated for both letters and added to the global kerning value. For example, in a font which supports kerning pairs a string such as 'Wo' may have the 'o' tucked neatly under the 'W'.

Implemented in dcpp::gui::IGUIFontBitmap.

getType()

virtual EGUI_FONT_TYPE dcpp::gui::IGUIFont::getType ( ) const

inlinevirtual

Returns the type of this font.

Reimplemented in dcpp::gui::IGUIFontBitmap.

setInvisibleCharacters()

virtual void dcpp::gui::IGUIFont::setInvisibleCharacters ( const wchar_t *  s )

pure virtual

Define which characters should not be drawn by the font.

For example " " would not draw any space which is usually blank in most fonts.

Parameters

s	String of symbols which are not send down to the videodriver

---

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

• include/duckcpp/core/engine/IGUIFont.hpp