+ void set_texture(const Texture2D &);
+ const Texture2D &get_texture() const;
+
+ /** Adds a glyph to the font. There must not be an existing glyph with the
+ same code. */
+ void add_glyph(const Glyph &);
+ void set_kerning(unsigned, unsigned, float);
+
+ /** Returns the size used to generate the font texture. This serves as a
+ hint for obtaining the best quality when rendering strings. */
+ float get_native_size() const { return native_size; }
+
+ float get_ascent() const { return ascent; }
+ float get_descent() const { return descent; }
+ float get_cap_height() const { return cap_height; }
+ float get_x_height() const { return x_height; }
+
+ /** Returns the width of a string, in multiples of the font size. Scale the
+ result according to the size used in rendering. */
+ float get_string_width(const std::string &, StringCodec::Decoder &) const;
+
+ template<class C>
+ float get_string_width(const std::string &str) const
+ {
+ typename C::Decoder dec;
+ return get_string_width(str, dec);
+ }
+
+ float get_string_width(const std::string &str) const
+ { return get_string_width<StringCodec::Utf8>(str); }
+
+ /** Builds the primitives for a string. Two-dimensional vertex and texture
+ coordinates are generated. Size 1.0 is used for building; set up the
+ builder's matrix before the call. The texture is not bound, to avoid
+ unnecessary bindings when creating meshes. */
+ void build_string(const std::string &, StringCodec::Decoder &, PrimitiveBuilder &) const;
+
+ template<class C>
+ void build_string(const std::string &str, PrimitiveBuilder &pb) const
+ {
+ typename C::Decoder dec;
+ build_string(str, dec, pb);
+ }
+
+ void build_string(const std::string &str, PrimitiveBuilder &pb) const
+ { return build_string<StringCodec::Utf8>(str, pb); }
+
+private:
+ void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const;
+ float get_glyph_advance(unsigned, unsigned = 0) const;
+ unsigned get_ligature(unsigned, unsigned) const;