LEFontInstance.h

Go to the documentation of this file.

 
/*
 *
 * (C) Copyright IBM Corp. 1998-2012 - All Rights Reserved
 *
 */
 
#ifndef __LEFONTINSTANCE_H
#define __LEFONTINSTANCE_H
 
#include "LETypes.h"
 
U_NAMESPACE_BEGIN

class LECharMapper /* not : public UObject because this is an interface/mixin class */
{
public:
    virtual ~LECharMapper();

    virtual LEUnicode32 mapChar(LEUnicode32 ch) const = 0;
};

class LEGlyphStorage;

class U_LAYOUT_API LEFontInstance : public UObject
{
public:

    virtual ~LEFontInstance();

    virtual const LEFontInstance *getSubFont(const LEUnicode chars[], le_int32 *offset, le_int32 limit, le_int32 script, LEErrorCode &success) const;
 
    //
    // Font file access
    //

    virtual const void *getFontTable(LETag tableTag) const = 0;

    virtual const void* getFontTable(LETag tableTag, size_t &length) const { length=-1; return getFontTable(tableTag); }  /* -1 = unknown length */

    virtual le_bool canDisplay(LEUnicode32 ch) const;

    virtual le_int32 getUnitsPerEM() const = 0;

    virtual void mapCharsToGlyphs(const LEUnicode chars[], le_int32 offset, le_int32 count, le_bool reverse, const LECharMapper *mapper, le_bool filterZeroWidth, LEGlyphStorage &glyphStorage) const;

    virtual LEGlyphID mapCharToGlyph(LEUnicode32 ch, const LECharMapper *mapper, le_bool filterZeroWidth) const;

    virtual LEGlyphID mapCharToGlyph(LEUnicode32 ch, const LECharMapper *mapper) const;

    virtual LEGlyphID mapCharToGlyph(LEUnicode32 ch) const = 0;
 
    //
    // Metrics
    //

    virtual void getGlyphAdvance(LEGlyphID glyph, LEPoint &advance) const = 0;

    virtual le_bool getGlyphPoint(LEGlyphID glyph, le_int32 pointNumber, LEPoint &point) const = 0;

    virtual float getXPixelsPerEm() const = 0;

    virtual float getYPixelsPerEm() const = 0;

    virtual float xUnitsToPoints(float xUnits) const;

    virtual float yUnitsToPoints(float yUnits) const;

    virtual void unitsToPoints(LEPoint &units, LEPoint &points) const;

    virtual float xPixelsToUnits(float xPixels) const;

    virtual float yPixelsToUnits(float yPixels) const;

    virtual void pixelsToUnits(LEPoint &pixels, LEPoint &units) const;

    virtual float getScaleFactorX() const = 0;

    virtual float getScaleFactorY() const = 0;

    virtual void transformFunits(float xFunits, float yFunits, LEPoint &pixels) const;

    static inline float fixedToFloat(le_int32 fixed);

    static inline le_int32 floatToFixed(float theFloat);
 
    //
    // These methods won't ever be called by the LayoutEngine,
    // but are useful for clients of <code>LEFontInstance</code> who
    // need to render text.
    //

    virtual le_int32 getAscent() const = 0;

    virtual le_int32 getDescent() const = 0;

    virtual le_int32 getLeading() const = 0;

    virtual le_int32 getLineHeight() const;

    virtual UClassID getDynamicClassID() const;

    static UClassID getStaticClassID();
 
};
 
inline float LEFontInstance::fixedToFloat(le_int32 fixed)
{
    return (float) (fixed / 65536.0);
}
 
inline le_int32 LEFontInstance::floatToFixed(float theFloat)
{
    return (le_int32) (theFloat * 65536.0);
}
 
U_NAMESPACE_END
#endif