# Add Font.render_glyph() method to PyGame.
#
# This is nicer than full string rendering, as Tuikit renders screen
# one character at the time and render_glyph is optimized for caching.
# See documentation for TTF_RenderGlyph_Shaded and TTF_GlyphMetrics.
#
# Radek Brich <radek.brich@devl.cz>
diff -rupd pygame-1.9.1release/src/font.c pygame-1.9.1release-my/src/font.c
--- pygame-1.9.1release/src/font.c	2009-06-17 01:18:34.000000000 +0200
+++ pygame-1.9.1release-my/src/font.c	2011-10-09 23:19:46.000000000 +0200
@@ -371,6 +371,78 @@ font_render (PyObject* self, PyObject* a
 }
 
 static PyObject*
+font_render_glyph (PyObject* self, PyObject* args)
+{
+    TTF_Font* font = PyFont_AsFont (self);
+    int aa;
+    PyObject* text, *final;
+    PyObject* fg_rgba_obj, *bg_rgba_obj = NULL;
+    Uint8 rgba[4];
+    SDL_Surface* surf;
+    SDL_Color foreg, backg;
+
+    if (!PyArg_ParseTuple (args, "OiO|O", &text, &aa, &fg_rgba_obj,
+                           &bg_rgba_obj))
+        return NULL;
+
+    if (!RGBAFromColorObj (fg_rgba_obj, rgba))
+        return RAISE (PyExc_TypeError, "Invalid foreground RGBA argument");
+    foreg.r = rgba[0];
+    foreg.g = rgba[1];
+    foreg.b = rgba[2];
+    if (bg_rgba_obj)
+    {
+        if (!RGBAFromColorObj (bg_rgba_obj, rgba))
+            return RAISE (PyExc_TypeError, "Invalid background RGBA argument");
+        backg.r = rgba[0];
+        backg.g = rgba[1];
+        backg.b = rgba[2];
+        backg.unused = 0;
+    }
+    else
+    {
+        backg.r = 0;
+        backg.g = 0;
+        backg.b = 0;
+        backg.unused = 0;
+    }
+
+    if (PyUnicode_Check (text) && PyObject_Length (text) == 1)
+    {
+        Py_UNICODE *buf = PyUnicode_AsUnicode (text);
+        Uint16 ch = (Uint16) buf[0];
+
+        if (aa)
+        {
+            if (!bg_rgba_obj)
+                surf = TTF_RenderGlyph_Blended (font, ch, foreg);
+            else
+                surf = TTF_RenderGlyph_Shaded (font, ch, foreg, backg);
+        }
+        else
+            surf = TTF_RenderGlyph_Solid (font, ch, foreg);
+    }
+    else
+        return RAISE (PyExc_TypeError, "char must be string of exactly one unicode character");
+
+    if (!surf)
+        return RAISE (PyExc_SDLError, TTF_GetError());
+
+    if (!aa && bg_rgba_obj) /*turn off transparancy*/
+    {
+        SDL_SetColorKey (surf, 0, 0);
+        surf->format->palette->colors[0].r = backg.r;
+        surf->format->palette->colors[0].g = backg.g;
+        surf->format->palette->colors[0].b = backg.b;
+    }
+
+    final = PySurface_New (surf);
+    if (!final)
+        SDL_FreeSurface (surf);
+    return final;
+}
+
+static PyObject*
 font_size (PyObject* self, PyObject* args)
 {
     TTF_Font* font = PyFont_AsFont (self);
@@ -509,6 +581,7 @@ static PyMethodDef font_methods[] =
 
     { "metrics", font_metrics, METH_VARARGS, DOC_FONTMETRICS },
     { "render", font_render, METH_VARARGS, DOC_FONTRENDER },
+    { "render_glyph", font_render_glyph, METH_VARARGS, DOC_FONTRENDERGLYPH },
     { "size", font_size, METH_VARARGS, DOC_FONTSIZE },
 
     { NULL, NULL, 0, NULL }
diff -rupd pygame-1.9.1release/src/pygamedocs.h pygame-1.9.1release-my/src/pygamedocs.h
--- pygame-1.9.1release/src/pygamedocs.h	2009-06-19 08:20:25.000000000 +0200
+++ pygame-1.9.1release-my/src/pygamedocs.h	2011-10-09 23:27:34.000000000 +0200
@@ -299,6 +299,8 @@
 
 #define DOC_FONTRENDER "Font.render(text, antialias, color, background=None): return Surface\ndraw text on a new Surface"
 
+#define DOC_FONTRENDERGLYPH "Font.render_glyph(char, antialias, color, background=None): return Surface\ndraw glyph of char on a new Surface"
+
 #define DOC_FONTSIZE "Font.size(text): return (width, height)\ndetermine the amount of space needed to render text"
 
 #define DOC_FONTSETUNDERLINE "Font.set_underline(bool): return None\ncontrol if text is rendered with an underline"