6 #include <msp/datafile/objectloader.h>
7 #include <msp/stringcodec/utf8.h>
8 #include "vertexarray.h"
13 class PrimitiveBuilder;
17 Stores a set of glyphs and creates strings out of them.
22 class Loader: public DataFile::CollectionObjectLoader<Font>
26 Loader(Font &, Collection &);
31 void kerning(unsigned, unsigned, float);
33 void texture_ref(const std::string &);
38 class Loader: public Msp::DataFile::ObjectLoader<Glyph>
43 void texcoords(float, float, float, float);
55 typedef std::map<unsigned, Glyph> GlyphMap;
56 typedef std::pair<unsigned, unsigned> KerningKey;
57 typedef std::map<KerningKey, float> KerningMap;
59 RefPtr<const Texture2D> texture;
70 void set_texture(const Texture2D &);
71 const Texture2D &get_texture() const;
73 /** Adds a glyph to the font. There must not be an existing glyph with the
75 void add_glyph(const Glyph &);
76 void set_kerning(unsigned, unsigned, float);
78 /** Returns the size used to generate the font texture. This serves as a
79 hint for obtaining the best quality when rendering strings. */
80 float get_native_size() const { return native_size; }
82 float get_ascent() const { return ascent; }
83 float get_descent() const { return descent; }
85 /** Returns the width of a string, in multiples of the font size. Scale the
86 result according to the size used in rendering. */
87 float get_string_width(const std::string &, StringCodec::Decoder &) const;
90 float get_string_width(const std::string &str) const
92 typename C::Decoder dec;
93 return get_string_width(str, dec);
96 float get_string_width(const std::string &str) const
97 { return get_string_width<StringCodec::Utf8>(str); }
99 /** Draws a string to the framebuffer with Immediate. It is drawn with size
100 1.0; set up matrices for the desired size before the call. */
101 void draw_string(const std::string &, StringCodec::Decoder &, const Color & = Color()) const;
104 void draw_string(const std::string &str, const Color &color = Color()) const
106 typename C::Decoder dec;
107 draw_string(str, dec, color);
110 void draw_string(const std::string &str, const Color &color = Color()) const
111 { draw_string<StringCodec::Utf8>(str, color); }
113 /** Builds the primitives for a string. Two-dimensional vertex and texture
114 coordinates are generated. Size 1.0 is used for building; set up the
115 builder's matrix before the call. The texture is not bound, to avoid
116 unnecessary bindings when creating meshes. */
117 void build_string(const std::string &, StringCodec::Decoder &, PrimitiveBuilder &) const;
120 void build_string(const std::string &str, PrimitiveBuilder &pb) const
122 typename C::Decoder dec;
123 build_string(str, dec, pb);
126 void build_string(const std::string &str, PrimitiveBuilder &pb) const
127 { return build_string<StringCodec::Utf8>(str, pb); }
130 void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const;
131 float get_glyph_advance(unsigned, unsigned = 0) const;