X-Git-Url: http://git.tdb.fi/?p=libs%2Fgl.git;a=blobdiff_plain;f=source%2Ffont.h;h=4eaed9635361ecca51ae5604b84c3c0d533c1109;hp=a55933519b6c792a72bf967a7bdce2d7514afdf1;hb=20af6dd2f04caa224d8cae00befc97d010a1ed08;hpb=f098a871fc6dc7b61a5aca5581fa327e4124c036

diff --git a/source/font.h b/source/font.h
index a5593351..4eaed963 100644
--- a/source/font.h
+++ b/source/font.h
@@ -1,54 +1,94 @@
-/* $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 <map>
 #include <string>
-#include <msp/datafile/loader.h>
-#include <msp/strings/codec.h>
+#include <msp/datafile/objectloader.h>
+#include <msp/stringcodec/utf8.h>
 #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::DataFile::Loader
+	class Loader: public DataFile::CollectionObjectLoader<Font>
 	{
 	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 &);
 	};
 
+	struct Glyph
+	{
+		class Loader: public Msp::DataFile::ObjectLoader<Glyph>
+		{
+		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<unsigned, Glyph> GlyphMap;
+	typedef std::pair<unsigned, unsigned> KerningKey;
+	typedef std::map<KerningKey, float> KerningMap;
+
+	RefPtr<const Texture2D> 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  add_glyph(unsigned, float, float, float, float, float, float, float, float, float);
-	float get_default_size() const { return default_size; }
+	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_string_width(const std::string &) const;
-	float get_string_width(const std::string &, Codecs::Decoder &) const;
-	void  draw_glyph(unsigned);
-	void  draw_string(const std::string &) const;
-	void  draw_string(const std::string &, Codecs::Decoder &) const;
-	void  draw_multiline(const std::string &) 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<class C>
 	float get_string_width(const std::string &str) const
@@ -57,49 +97,42 @@ public:
 		return get_string_width(str, dec);
 	}
 
+	float get_string_width(const std::string &str) const
+	{ return get_string_width<StringCodec::Utf8>(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<class C>
-	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);
 	}
-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);
-		};
+	void draw_string(const std::string &str, const Color &color = Color()) const
+	{ draw_string<StringCodec::Utf8>(str, color); }
 
-		unsigned code;
-		float x1,y1;
-		float x2,y2;
-		float w,h;
-		float off_x, off_y;
-		float advance;
-		unsigned index;
-	};
-	typedef std::map<unsigned, Glyph> GlyphMap;
+	/** 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;
 
-	const Texture2D *tex;
-	bool     own_tex;
-	float    default_size;
-	float    ascent;
-	float    descent;
-	GlyphMap glyphs;
-	VertexArray varray;
+	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); }
 
-	void create_glyph_vertices();
-	void create_glyph_vertices(const Glyph &, VertexArrayBuilder &);
-	void prepare_render() const;
-	void draw_glyph(unsigned) const;
-	float get_glyph_advance(unsigned) const;
+private:
+	void create_glyph_quad(const Glyph &, PrimitiveBuilder &) const;
+	float get_glyph_advance(unsigned, unsigned = 0) const;
 };
 
 } // namespace GL