Wrapper over FreeType font. Notice that this class uses internal buffers for loaded glyphs and it is absolutely UNSAFE to load/read glyph from concurrent threads! More...

#include <Font_FTFont.hxx>

Inheritance diagram for Font_FTFont:

[legend]

Public Member Functions
	Font_FTFont (const Handle< Font_FTLibrary > &theFTLib=Handle< Font_FTLibrary >())
	Create uninitialized instance. More...

virtual	~Font_FTFont ()
	Destructor. More...

bool	IsValid () const

const Image_PixMap &	GlyphImage () const

bool	Init (const NCollection_String &theFontPath, const unsigned int thePointSize, const unsigned int theResolution)
	Initialize the font. More...

bool	Init (const NCollection_String &theFontName, const Font_FontAspect theFontAspect, const unsigned int thePointSize, const unsigned int theResolution)
	Initialize the font. More...

bool	IsSingleStrokeFont () const
	Return TRUE if this is single-stroke (one-line) font, FALSE by default. Such fonts define single-line glyphs instead of closed contours, so that they are rendered incorrectly by normal software. More...

void	SetSingleStrokeFont (bool theIsSingleLine)
	Set if this font should be rendered as single-stroke (one-line). More...

virtual void	Release ()
	Release currently loaded font. More...

bool	RenderGlyph (const Standard_Utf32Char theChar)
	Render specified glyph into internal buffer (bitmap). More...

unsigned int	GlyphMaxSizeX () const

unsigned int	GlyphMaxSizeY () const

float	Ascender () const

float	Descender () const

float	LineSpacing () const

unsigned int	PointSize () const
	Configured point size. More...

void	SetWidthScaling (const float theScaleFactor)
	Setup glyph scaling along X-axis. By default glyphs are not scaled (scaling factor = 1.0) More...

float	AdvanceX (Standard_Utf32Char theUCharNext) const
	Compute horizontal advance to the next character with kerning applied when applicable. Assuming text rendered horizontally. More...

float	AdvanceX (Standard_Utf32Char theUChar, Standard_Utf32Char theUCharNext)
	Compute horizontal advance to the next character with kerning applied when applicable. Assuming text rendered horizontally. More...

float	AdvanceY (Standard_Utf32Char theUCharNext) const
	Compute vertical advance to the next character with kerning applied when applicable. Assuming text rendered vertically. More...

float	AdvanceY (Standard_Utf32Char theUChar, Standard_Utf32Char theUCharNext)
	Compute vertical advance to the next character with kerning applied when applicable. Assuming text rendered vertically. More...

Standard_Integer	GlyphsNumber () const

void	GlyphRect (Font_Rect &theRect) const
	Retrieve glyph bitmap rectangle. More...

Font_Rect	BoundingBox (const NCollection_String &theString, const Graphic3d_HorizontalTextAlignment theAlignX, const Graphic3d_VerticalTextAlignment theAlignY)
	Computes bounding box of the given text using plain-text formatter (Font_TextFormatter). Note that bounding box takes into account the text alignment options. Its corners are relative to the text alignment anchor point, their coordinates can be negative. 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...

Protected Member Functions
template<typename theInput_t >
int32_t	toFTPoints (const theInput_t thePointSize) const
	Convert value to 26.6 fixed-point format for FT library API. More...

template<typename theReturn_t , typename theFTUnits_t >
theReturn_t	fromFTPoints (const theFTUnits_t theFTUnits) const
	Convert value from 26.6 fixed-point format for FT library API. More...

bool	loadGlyph (const Standard_Utf32Char theUChar)
	Load glyph without rendering it. More...

bool	getKerning (FT_Vector &theKern, Standard_Utf32Char theUCharCurr, Standard_Utf32Char theUCharNext) const
	Wrapper for FT_Get_Kerning - retrieve kerning values. More...

Protected Attributes
Handle< Font_FTLibrary >	myFTLib
	handle to the FT library object More...

FT_Face	myFTFace
	FT face object. More...

NCollection_String	myFontPath
	font path More...

unsigned int	myPointSize
	point size set by FT_Set_Char_Size More...

float	myWidthScaling
	scale glyphs along X-axis More...

int32_t	myLoadFlags
	default load flags More...

bool	myIsSingleLine
	single stroke font flag, FALSE by default More...

Image_PixMap	myGlyphImg
	cached glyph plane More...

Standard_Utf32Char	myUChar
	currently loaded unicode character More...

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object. 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...

Detailed Description

Wrapper over FreeType font. Notice that this class uses internal buffers for loaded glyphs and it is absolutely UNSAFE to load/read glyph from concurrent threads!

Constructor & Destructor Documentation

◆ Font_FTFont()

Font_FTFont::Font_FTFont ( const Handle< Font_FTLibrary > & theFTLib = Handle< Font_FTLibrary >() )

Create uninitialized instance.

◆ ~Font_FTFont()

virtual Font_FTFont::~Font_FTFont ( )

virtual

Destructor.

Member Function Documentation

◆ AdvanceX() [1/2]

float Font_FTFont::AdvanceX ( Standard_Utf32Char theUCharNext ) const

Compute horizontal advance to the next character with kerning applied when applicable. Assuming text rendered horizontally.

Parameters

theUCharNext the next character to compute advance from current one

◆ AdvanceX() [2/2]

float Font_FTFont::AdvanceX	(	Standard_Utf32Char	theUChar,
		Standard_Utf32Char	theUCharNext
	)

Compute horizontal advance to the next character with kerning applied when applicable. Assuming text rendered horizontally.

Parameters

theUChar	the character to be loaded as current one
theUCharNext	the next character to compute advance from current one

◆ AdvanceY() [1/2]

float Font_FTFont::AdvanceY ( Standard_Utf32Char theUCharNext ) const

Compute vertical advance to the next character with kerning applied when applicable. Assuming text rendered vertically.

Parameters

theUCharNext the next character to compute advance from current one

◆ AdvanceY() [2/2]

float Font_FTFont::AdvanceY	(	Standard_Utf32Char	theUChar,
		Standard_Utf32Char	theUCharNext
	)

Compute vertical advance to the next character with kerning applied when applicable. Assuming text rendered vertically.

Parameters

theUChar	the character to be loaded as current one
theUCharNext	the next character to compute advance from current one

◆ Ascender()

float Font_FTFont::Ascender ( ) const

Returns: vertical distance from the horizontal baseline to the highest character coordinate.

◆ BoundingBox()

Font_Rect Font_FTFont::BoundingBox	(	const NCollection_String &	theString,
		const Graphic3d_HorizontalTextAlignment	theAlignX,
		const Graphic3d_VerticalTextAlignment	theAlignY
	)

Computes bounding box of the given text using plain-text formatter (Font_TextFormatter). Note that bounding box takes into account the text alignment options. Its corners are relative to the text alignment anchor point, their coordinates can be negative.

◆ Descender()

float Font_FTFont::Descender ( ) const

Returns: vertical distance from the horizontal baseline to the lowest character coordinate.

◆ fromFTPoints()

template<typename theReturn_t , typename theFTUnits_t >

theReturn_t Font_FTFont::fromFTPoints ( const theFTUnits_t theFTUnits ) const

inlineprotected

Convert value from 26.6 fixed-point format for FT library API.

◆ getKerning()

bool Font_FTFont::getKerning	(	FT_Vector &	theKern,
		Standard_Utf32Char	theUCharCurr,
		Standard_Utf32Char	theUCharNext
	)		const

protected

Wrapper for FT_Get_Kerning - retrieve kerning values.

◆ GlyphImage()

const Image_PixMap& Font_FTFont::GlyphImage ( ) const

inline

Returns: image plane for currently rendered glyph

◆ GlyphMaxSizeX()

unsigned int Font_FTFont::GlyphMaxSizeX ( ) const

Returns: maximal glyph width in pixels (rendered to bitmap).

◆ GlyphMaxSizeY()

unsigned int Font_FTFont::GlyphMaxSizeY ( ) const

Returns: maximal glyph height in pixels (rendered to bitmap).

◆ GlyphRect()

void Font_FTFont::GlyphRect ( Font_Rect & theRect ) const

Retrieve glyph bitmap rectangle.

◆ GlyphsNumber()

Standard_Integer Font_FTFont::GlyphsNumber ( ) const

Returns: glyphs number in this font.

◆ Init() [1/2]

bool Font_FTFont::Init	(	const NCollection_String &	theFontPath,
		const unsigned int	thePointSize,
		const unsigned int	theResolution
	)

Initialize the font.

Parameters

theFontPath	path to the font
thePointSize	the face size in points (1/72 inch)
theResolution	the resolution of the target device in dpi

Returns: true on success

◆ Init() [2/2]

bool Font_FTFont::Init	(	const NCollection_String &	theFontName,
		const Font_FontAspect	theFontAspect,
		const unsigned int	thePointSize,
		const unsigned int	theResolution
	)

Initialize the font.

Parameters

theFontName	the font name
theFontAspect	the font style
thePointSize	the face size in points (1/72 inch)
theResolution	the resolution of the target device in dpi

Returns: true on success

◆ IsSingleStrokeFont()

bool Font_FTFont::IsSingleStrokeFont ( ) const

inline

Return TRUE if this is single-stroke (one-line) font, FALSE by default. Such fonts define single-line glyphs instead of closed contours, so that they are rendered incorrectly by normal software.

◆ IsValid()

bool Font_FTFont::IsValid ( ) const

inline

Returns: true if font is loaded

◆ LineSpacing()

float Font_FTFont::LineSpacing ( ) const

Returns: default line spacing (the baseline-to-baseline distance).

◆ loadGlyph()

bool Font_FTFont::loadGlyph ( const Standard_Utf32Char theUChar )

protected

Load glyph without rendering it.

◆ PointSize()

unsigned int Font_FTFont::PointSize ( ) const

inline

Configured point size.

◆ Release()

virtual void Font_FTFont::Release ( )

virtual

Release currently loaded font.

Reimplemented in Font_BRepFont.

◆ RenderGlyph()

bool Font_FTFont::RenderGlyph ( const Standard_Utf32Char theChar )

Render specified glyph into internal buffer (bitmap).

◆ SetSingleStrokeFont()

void Font_FTFont::SetSingleStrokeFont ( bool theIsSingleLine )

inline

Set if this font should be rendered as single-stroke (one-line).

◆ SetWidthScaling()

void Font_FTFont::SetWidthScaling ( const float theScaleFactor )

inline

Setup glyph scaling along X-axis. By default glyphs are not scaled (scaling factor = 1.0)

◆ toFTPoints()

template<typename theInput_t >

int32_t Font_FTFont::toFTPoints ( const theInput_t thePointSize ) const

inlineprotected

Convert value to 26.6 fixed-point format for FT library API.

Field Documentation

◆ myFontPath

NCollection_String Font_FTFont::myFontPath

protected

font path

◆ myFTFace

FT_Face Font_FTFont::myFTFace

protected

FT face object.

◆ myFTLib

Handle< Font_FTLibrary > Font_FTFont::myFTLib

protected

handle to the FT library object

◆ myGlyphImg

Image_PixMap Font_FTFont::myGlyphImg

protected

cached glyph plane

◆ myIsSingleLine

bool Font_FTFont::myIsSingleLine

protected

single stroke font flag, FALSE by default

◆ myLoadFlags

int32_t Font_FTFont::myLoadFlags

protected

default load flags

◆ myPointSize

unsigned int Font_FTFont::myPointSize

protected

point size set by FT_Set_Char_Size

◆ myUChar

Standard_Utf32Char Font_FTFont::myUChar

protected

currently loaded unicode character

◆ myWidthScaling

float Font_FTFont::myWidthScaling

protected

scale glyphs along X-axis

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

Font_FTFont.hxx

Font_FTFont Class Reference

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ Font_FTFont()

◆ ~Font_FTFont()

Member Function Documentation

◆ AdvanceX() [1/2]

◆ AdvanceX() [2/2]

◆ AdvanceY() [1/2]

◆ AdvanceY() [2/2]

◆ Ascender()

◆ BoundingBox()

◆ Descender()

◆ fromFTPoints()

◆ getKerning()

◆ GlyphImage()

◆ GlyphMaxSizeX()

◆ GlyphMaxSizeY()

◆ GlyphRect()

◆ GlyphsNumber()

◆ Init() [1/2]

◆ Init() [2/2]

◆ IsSingleStrokeFont()

◆ IsValid()

◆ LineSpacing()

◆ loadGlyph()

◆ PointSize()

◆ Release()

◆ RenderGlyph()

◆ SetSingleStrokeFont()

◆ SetWidthScaling()

◆ toFTPoints()

Field Documentation

◆ myFontPath

◆ myFTFace

◆ myFTLib

◆ myGlyphImg

◆ myIsSingleLine

◆ myLoadFlags

◆ myPointSize

◆ myUChar

◆ myWidthScaling