X-Git-Url: http://git.tdb.fi/?p=libs%2Fgl.git;a=blobdiff_plain;f=source%2Ffont.h;h=4eaed9635361ecca51ae5604b84c3c0d533c1109;hp=ebaa8e7a7f43f469b7ae1ae246db6d92ad860bde;hb=20af6dd2f04caa224d8cae00befc97d010a1ed08;hpb=84bc56b96c21c831104a22e0cbd0f3b72ab5d8c3 diff --git a/source/font.h b/source/font.h index ebaa8e7a..4eaed963 100644 --- a/source/font.h +++ b/source/font.h @@ -1,80 +1,138 @@ -#ifndef FONT_H_ -#define FONT_H_ +#ifndef MSP_GL_FONT_H_ +#define MSP_GL_FONT_H_ #include #include -#include +#include +#include #include "vertexarray.h" namespace Msp { namespace GL { +class PrimitiveBuilder; class Texture2D; +/** +Stores a set of glyphs and creates strings out of them. +*/ class Font { public: - class Loader: public Msp::Parser::Loader + class Loader: public DataFile::CollectionObjectLoader { public: Loader(Font &); - ~Loader(); - Font &get_object() { return font; } - private: - Font &font; + Loader(Font &, Collection &); - void texture(const std::string &); + private: + void init(); void glyph(unsigned); + void kerning(unsigned, unsigned, float); + void texture(); + void texture_ref(const std::string &); }; - Font(); - void set_texture(const Texture2D &); - void add_glyph(wchar_t, float, float, float, float, float, float, float, float, float); - float get_default_size() const { return default_size; } - float get_string_width(const std::string &) const; - float get_string_width(const std::wstring &) const; - void draw_glyph(wchar_t); - void draw_string(const std::string &) const; - void draw_string(const std::wstring &) const; - void draw_multiline(const std::string &) const; - ~Font(); -private: struct Glyph { - class Loader: public Msp::Parser::Loader + class Loader: public Msp::DataFile::ObjectLoader { public: Loader(Glyph &); - Glyph &get_object() { return glyph; } private: - Glyph &glyph; - void texcoords(float, float, float, float); - void size(float, float); - void offset(float, float); }; - wchar_t code; - float x1,y1; - float x2,y2; - float w,h; + unsigned code; + float x1, y1; + float x2, y2; + float w, h; float off_x, off_y; float advance; - unsigned index; }; - typedef std::map GlyphMap; - const Texture2D *tex; - bool own_tex; - float default_size; +private: + typedef std::map GlyphMap; + typedef std::pair KerningKey; + typedef std::map KerningMap; + + RefPtr texture; + float native_size; + float ascent; + float descent; + float cap_height; + float x_height; GlyphMap glyphs; - VertexArray varray; + KerningMap kerning; + +public: + Font(); + ~Font(); + + 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; } - void create_glyph_vertices(); - void create_glyph_vertices(const Glyph &, VertexArrayBuilder &); - void prepare_render() const; - void draw_glyph(wchar_t) const; - float get_glyph_advance(wchar_t) const; + 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 + 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(str); } + + /** Draws a string to the framebuffer with Immediate. It is drawn with size + 1.0; set up matrices for the desired size before the call. */ + void draw_string(const std::string &, StringCodec::Decoder &, const Color & = Color()) const; + + template + void draw_string(const std::string &str, const Color &color = Color()) const + { + typename C::Decoder dec; + draw_string(str, dec, color); + } + + void draw_string(const std::string &str, const Color &color = Color()) const + { draw_string(str, color); } + + /** 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 + 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(str, pb); } + +private: + void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const; + float get_glyph_advance(unsigned, unsigned = 0) const; }; } // namespace GL