6 #include <msp/datafile/objectloader.h>
7 #include <msp/stringcodec/utf8.h>
12 class PrimitiveBuilder;
16 Stores a set of glyphs and creates strings out of them.
21 class Loader: public DataFile::CollectionObjectLoader<Font>
24 Loader(Font &, Collection &);
28 void kerning(unsigned, unsigned, float);
29 void ligature(unsigned, unsigned, unsigned);
31 void texture_ref(const std::string &);
36 class Loader: public Msp::DataFile::ObjectLoader<Glyph>
41 void texcoords(float, float, float, float);
55 typedef std::map<unsigned, Glyph> GlyphMap;
56 typedef std::pair<unsigned, unsigned> CodePair;
57 typedef std::map<CodePair, float> KerningMap;
58 typedef std::map<CodePair, unsigned> LigatureMap;
60 const Texture2D *texture;
68 LigatureMap ligatures;
74 void set_texture(const Texture2D &);
75 const Texture2D &get_texture() const;
77 /** Adds a glyph to the font. There must not be an existing glyph with the
79 void add_glyph(const Glyph &);
80 void set_kerning(unsigned, unsigned, float);
82 /** Returns the size used to generate the font texture. This serves as a
83 hint for obtaining the best quality when rendering strings. */
84 float get_native_size() const { return native_size; }
86 float get_ascent() const { return ascent; }
87 float get_descent() const { return descent; }
88 float get_cap_height() const { return cap_height; }
89 float get_x_height() const { return x_height; }
91 /** Returns the width of a string, in multiples of the font size. Scale the
92 result according to the size used in rendering. */
93 float get_string_width(const std::string &, StringCodec::Decoder &) const;
96 float get_string_width(const std::string &str) const
98 typename C::Decoder dec;
99 return get_string_width(str, dec);
102 float get_string_width(const std::string &str) const
103 { return get_string_width<StringCodec::Utf8>(str); }
105 /** Builds the primitives for a string. Two-dimensional vertex and texture
106 coordinates are generated. Size 1.0 is used for building; set up the
107 builder's matrix before the call. The texture is not bound, to avoid
108 unnecessary bindings when creating meshes. */
109 void build_string(const std::string &, StringCodec::Decoder &, PrimitiveBuilder &) const;
112 void build_string(const std::string &str, PrimitiveBuilder &pb) const
114 typename C::Decoder dec;
115 build_string(str, dec, pb);
118 void build_string(const std::string &str, PrimitiveBuilder &pb) const
119 { return build_string<StringCodec::Utf8>(str, pb); }
122 void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const;
123 float get_glyph_advance(unsigned, unsigned = 0) const;
124 unsigned get_ligature(unsigned, unsigned) const;