Truetype font rasterizer/converter based on freetype library. More...

#include <FreetypeGlyphsProvider.h>

Public Member Functions
	~FreetypeGlyphsProvider ()
	Destructor. More...

std::unique_ptr< SWF::ShapeRecord >	getGlyph (std::uint16_t code, float &advance)
	Return the given DisplayObject glyph as a shape DisplayObject definition in unitsPerEM() coordinates. More...

float	ascent () const
	Return the font's ascender in terms of its EM own square. More...

float	descent () const
	Return the font's descender in terms of its own EM square. More...

unsigned short	unitsPerEM () const
	Return the number of units of glyphs EM. More...

Static Public Member Functions
static std::unique_ptr< FreetypeGlyphsProvider >	createFace (const std::string &name, bool bold, bool italic)
	Named constructor for a face-bound rasterizer. More...

Detailed Description

Truetype font rasterizer/converter based on freetype library.

Instances of this class provide rasterized or vectorial glyphs for a given truetype font face.

The rasterized glyphs have a max size of 96 (TODO: make parametrizable) but I think the actual size could change between glyphs (see the 'box' parameter of getRenderedGlyph() method).

Vectorial glyphs are instances of a SWF::ShapeRecord, same class resulting from parsing of embedded fonts.

Constructor & Destructor Documentation

§ ~FreetypeGlyphsProvider()

gnash::FreetypeGlyphsProvider::~FreetypeGlyphsProvider ( )

Destructor.

Release face resources

References _, and gnash::log_error().

Member Function Documentation

§ ascent()

float gnash::FreetypeGlyphsProvider::ascent ( ) const

Return the font's ascender in terms of its EM own square.

Referenced by gnash::Font::ascent().

§ createFace()

std::unique_ptr< FreetypeGlyphsProvider > gnash::FreetypeGlyphsProvider::createFace	(	const std::string &	name,
		bool	bold,
		bool	italic
	)

static

Named constructor for a face-bound rasterizer.

Parameters

name	Name of the font to get glyphs info from
bold	Whether to use a bold version of the font
italic	Whether to use an italic version of the font

Returns: a rasterizer bound to the given font name, or a NULL unique_ptr if the given truetype font could not be found.

References _, and gnash::log_error().

Referenced by gnash::Font::ftProvider().

§ descent()

float gnash::FreetypeGlyphsProvider::descent ( ) const

Return the font's descender in terms of its own EM square.

Referenced by gnash::Font::descent().

§ getGlyph()

std::unique_ptr< SWF::ShapeRecord > gnash::FreetypeGlyphsProvider::getGlyph	(	std::uint16_t	code,
		float &	advance
	)

Return the given DisplayObject glyph as a shape DisplayObject definition in unitsPerEM() coordinates.

TODO: allow using a custom EM square ?

Parameters

code	Character code.
advance	Output parameter... units to advance horizontally from this glyph to the next, in unitsPerEM() units.

Returns: A DefineShapeTag in unitsPerEM() coordinates, or a NULL pointer if the given DisplayObject code doesn't exist in this font.

Referenced by gnash::Font::unitsPerEM().

§ unitsPerEM()

unsigned short gnash::FreetypeGlyphsProvider::unitsPerEM ( ) const

Return the number of units of glyphs EM.

This is currently hard-coded to 1024, but could in future depend on actual font file being used.