X-Git-Url: http://git.tdb.fi/?p=libs%2Fgl.git;a=blobdiff_plain;f=source%2Ffont.h;h=4eaed9635361ecca51ae5604b84c3c0d533c1109;hp=a2406b9ee043009824dbe1787fd7a05d6b583038;hb=20af6dd2f04caa224d8cae00befc97d010a1ed08;hpb=652cb91c2b6008c4407c16054085f20bf5888c4d diff --git a/source/font.h b/source/font.h index a2406b9e..4eaed963 100644 --- a/source/font.h +++ b/source/font.h @@ -1,17 +1,10 @@ -/* $Id$ - -This file is part of libmspgl -Copyright © 2007 Mikko Rasa, Mikkosoft Productions -Distributed under the LGPL -*/ - #ifndef MSP_GL_FONT_H_ #define MSP_GL_FONT_H_ #include #include -#include -#include +#include +#include #include "vertexarray.h" namespace Msp { @@ -20,41 +13,82 @@ namespace GL { class PrimitiveBuilder; class Texture2D; +/** +Stores a set of glyphs and creates strings out of them. +*/ class Font { public: - class Loader: public DataFile::Loader + class Loader: public DataFile::CollectionObjectLoader { - private: - Font &font; - DataFile::Collection *coll; - public: - typedef DataFile::Collection Collection; - Loader(Font &); - Loader(Font &, DataFile::Collection &); - Font &get_object() { return font; } - DataFile::Collection &get_collection(); + Loader(Font &, Collection &); + private: void init(); void glyph(unsigned); - void texture_inline(); + void kerning(unsigned, unsigned, float); + void texture(); + void texture_ref(const std::string &); + }; + + struct Glyph + { + class Loader: public Msp::DataFile::ObjectLoader + { + public: + Loader(Glyph &); + private: + void texcoords(float, float, float, float); + }; + + unsigned code; + float x1, y1; + float x2, y2; + float w, h; + float off_x, off_y; + float advance; }; +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; + KerningMap kerning; + +public: Font(); ~Font(); - void set_texture(const Texture2D &); + void set_texture(const Texture2D &); const Texture2D &get_texture() const; - void add_glyph(unsigned, float, float, float, float, float, float, float, float, float); - float get_default_size() const { return default_size; } + + /** 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_string_width(const std::string &, Codecs::Decoder &) const; - void draw_glyph(unsigned); - void draw_string(const std::string &, Codecs::Decoder &) const; - void draw_string(const std::string &, Codecs::Decoder &, PrimitiveBuilder &) const; + 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 @@ -64,60 +98,41 @@ public: } float get_string_width(const std::string &str) const - { return get_string_width(str); } + { 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 + void draw_string(const std::string &str, const Color &color = Color()) const { typename C::Decoder dec; - draw_string(str, dec); + draw_string(str, dec, color); } - void draw_string(const std::string &str) const - { draw_string(str); } + 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 draw_string(const std::string &str, PrimitiveBuilder &pb) const + void build_string(const std::string &str, PrimitiveBuilder &pb) const { typename C::Decoder dec; - draw_string(str, dec, pb); + build_string(str, dec, pb); } - void draw_string(const std::string &str, PrimitiveBuilder &pb) const - { return draw_string(str, pb); } + void build_string(const std::string &str, PrimitiveBuilder &pb) const + { return build_string(str, pb); } private: - struct Glyph - { - class Loader: public Msp::DataFile::Loader - { - public: - Loader(Glyph &); - Glyph &get_object() { return glyph; } - private: - Glyph &glyph; - - void texcoords(float, float, float, float); - }; - - unsigned code; - float x1,y1; - float x2,y2; - float w,h; - float off_x, off_y; - float advance; - }; - typedef std::map GlyphMap; - - const Texture2D *tex; - bool own_tex; - float default_size; - float ascent; - float descent; - GlyphMap glyphs; - - void create_glyph_vertices(const Glyph &, VertexBuilder &, float) const; - float get_glyph_advance(unsigned) const; + void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const; + float get_glyph_advance(unsigned, unsigned = 0) const; }; } // namespace GL