#pragma once #include #include "../core/Shape.h" namespace msdfgen { typedef unsigned char byte; typedef unsigned unicode_t; class FreetypeHandle; class FontHandle; class GlyphIndex { public: explicit GlyphIndex(unsigned index = 0); unsigned getIndex() const; private: unsigned index; }; /// Global metrics of a typeface (in font units). struct FontMetrics { /// The size of one EM. double emSize; /// The vertical position of the ascender and descender relative to the baseline. double ascenderY, descenderY; /// The vertical difference between consecutive baselines. double lineHeight; /// The vertical position and thickness of the underline. double underlineY, underlineThickness; }; /// A structure to model a given axis of a variable font. struct FontVariationAxis { /// The name of the variation axis. const char *name; /// The axis's minimum coordinate value. double minValue; /// The axis's maximum coordinate value. double maxValue; /// The axis's default coordinate value. FreeType computes meaningful default values for Adobe MM fonts. double defaultValue; }; /// Initializes the FreeType library. FreetypeHandle * initializeFreetype(); /// Deinitializes the FreeType library. void deinitializeFreetype(FreetypeHandle *library); #ifdef FT_FREETYPE_H /// Creates a FontHandle from FT_Face that was loaded by the user. destroyFont must still be called but will not affect the FT_Face. FontHandle * adoptFreetypeFont(FT_Face ftFace); #endif /// Loads a font file and returns its handle. FontHandle * loadFont(FreetypeHandle *library, const char *filename); /// Loads a font from binary data and returns its handle. FontHandle * loadFontData(FreetypeHandle *library, const byte *data, int length); /// Unloads a font file. void destroyFont(FontHandle *font); /// Outputs the metrics of a font file. bool getFontMetrics(FontMetrics &metrics, FontHandle *font); /// Outputs the width of the space and tab characters. bool getFontWhitespaceWidth(double &spaceAdvance, double &tabAdvance, FontHandle *font); /// Outputs the glyph index corresponding to the specified Unicode character. bool getGlyphIndex(GlyphIndex &glyphIndex, FontHandle *font, unicode_t unicode); /// Loads the geometry of a glyph from a font file. bool loadGlyph(Shape &output, FontHandle *font, GlyphIndex glyphIndex, double *advance = NULL); bool loadGlyph(Shape &output, FontHandle *font, unicode_t unicode, double *advance = NULL); /// Outputs the kerning distance adjustment between two specific glyphs. bool getKerning(double &output, FontHandle *font, GlyphIndex glyphIndex1, GlyphIndex glyphIndex2); bool getKerning(double &output, FontHandle *font, unicode_t unicode1, unicode_t unicode2); /// Sets a single variation axis of a variable font. bool setFontVariationAxis(FreetypeHandle *library, FontHandle *font, const char *name, double coordinate); /// Lists names and ranges of variation axes of a variable font. bool listFontVariationAxes(std::vector &axes, FreetypeHandle *library, FontHandle *font); }