Class MOpenFontShapingExtension

class MOpenFontShapingExtension;

Description

Open Font System Extension Interface abstract base class.

COpenFont derivers should also derive from this interface to enable complex font "shaping".

This interface should be returned by the overridden COpenFont::ExtendedInterface function when KUidOpenFontShapingExtension is supplied as the UID.

Members

Defined in MOpenFontShapingExtension:
GetExtensionFontMetrics(), GlyphIndex(), GlyphPointInFontUnits(), GlyphPointInHintedPixels(), RasterizeGlyphL(), TExtensionFontMetrics

See also:

• COpenFont
• KUidOpenFontShapingExtension

virtual void RasterizeGlyphL(TInt aCode, TOpenFontGlyphData *aGlyphData)=0;

Description

Creates a bitmap for the specified Glyph code.

Implementations of this function should put the bitmap in aGlyphData->iBitmapBuffer, and the character metrics are placed in aGlyphData->iMetricsBuffer. The other parts of aGlyphData should be left alone.

This function provides the same functionality as the COpenFont::RasterizeL() except that the glyph code is supplied rather than the unicode.

For more information:

Parameters

TInt aCode The glyph code of the character for which the bitmap is required. TOpenFontGlyphData *aGlyphData The function puts its output here.

See also:

• COpenFont::RasterizeL()

virtual TInt GlyphIndex(TInt aUnicodeCharacter) const=0;

Description

Maps a character to a glyph index.

Parameters

TInt aUnicodeCharacter Unicode character code to be mapped.

Return value

TInt Glyph code corresponding to aUnicodeCharacter.

virtual TBool GlyphPointInHintedPixels(TInt aGlyphIndex, TInt aPointNumber, TReal &aX, TReal &aY) const=0;

Description

Returns the hinted pixel coordinates of a particular point in the outline of the given glyph.

Parameters

TInt aGlyphIndex TInt aPointNumber The number of the point. TReal &aX Returns the point's X pixel value. TReal &aY Returns the point's Y pixel value.

Return value

TBool True on success, false otherwise.

virtual TBool GlyphPointInFontUnits(TInt aGlyphIndex, TInt aPointNumber, TInt &aX, TInt &aY) const=0;

Description

Returns the coordinates of a particular (unhinted) point in the outline of the given glyph in font units.

Parameters

TInt aGlyphIndex TInt aPointNumber The number of the point. TInt &aX Returns the point's X co-ordinate in font units. TInt &aY Returns the point's Y co-ordinate in font units.

Return value

TBool True on success, false otherwise.

virtual void GetExtensionFontMetrics(TExtensionFontMetrics &aOut)=0;

Description

Returns font metrics.

Parameters

TExtensionFontMetrics &aOut Font metrics returned.

class TExtensionFontMetrics;

Description

Various font metrics.

Members

Defined in MOpenFontShapingExtension::TExtensionFontMetrics:
iUnitsPerEm, iXPixelsPerEm, iXScaleFactor, iYPixelsPerEm, iYScaleFactor

Member data

---

iUnitsPerEm

TInt iUnitsPerEm;

Description

The number of font design units per em.

---

iXPixelsPerEm

TReal iXPixelsPerEm;

Description

The width of the font's em square in pixels.

---

iYPixelsPerEm

TReal iYPixelsPerEm;

Description

The height of the font's em square in pixels.

---

iXScaleFactor

TReal iXScaleFactor;

Description

The horizontal scaling factor from the font's transform; the number of horizontal pixels per font unit.

---

iYScaleFactor

TReal iYScaleFactor;

Description

The vertical scaling factor from the font's transform; the number of vertical pixels per font unit.