From 6ce200cdae4bf4555a9f2ed60fa4d127c68cab9a Mon Sep 17 00:00:00 2001
From: the_fiddler <the_fiddler@ebc5dd9b-fb1d-0410-b6f8-d24c324e9604>
Date: Sat, 24 May 2008 07:47:30 +0000
Subject: [PATCH] Allow the user to code his own ITextPrinterImplementation.

---
 .../Utilities/Fonts/IPrinterImplementation.cs | 27 ++++++++++++++++---
 Source/Utilities/Fonts/TextPrinter.cs         | 17 ++++++++----
 2 files changed, 36 insertions(+), 8 deletions(-)

diff --git a/Source/Utilities/Fonts/IPrinterImplementation.cs b/Source/Utilities/Fonts/IPrinterImplementation.cs
index 1b332c9c..c849ed1f 100644
--- a/Source/Utilities/Fonts/IPrinterImplementation.cs
+++ b/Source/Utilities/Fonts/IPrinterImplementation.cs
@@ -15,10 +15,31 @@ namespace OpenTK.Graphics
     /// <summary>
     /// Defines the interface for TextPrinter implementations.
     /// </summary>
-    interface ITextPrinterImplementation
+    public interface ITextPrinterImplementation
     {
-        TextHandle Load(Vector2[] vertices, ushort[] indices, int index_count);
+        /// <summary>
+        /// Caches a text fragment for future use.
+        /// </summary>
+        /// <param name="vertices">The vertex array for the text fragment.</param>
+        /// <param name="indices">The index array for the text fragment. Please use the indexCount parameter
+        /// instead of indices.Count, as the indices array may be larger than necessary for performance reasons.</param>
+        /// <param name="indexCount">The actual number of indices in the text fragment.</param>
+        /// <returns>A TextHandle that can be used to draw the text fragment.</returns>
+        TextHandle Load(Vector2[] vertices, ushort[] indices, int indexCount);
+
+        /// <summary>
+        /// Draws the specified cached text fragment.
+        /// </summary>
+        /// <param name="handle">The TextHandle corresponding to the desired text fragment.</param>
         void Draw(TextHandle handle);
-        void Draw(Vector2[] vertices, ushort[] indices, int index_count);
+
+        /// <summary>
+        /// Draws a text fragment, without caching.
+        /// </summary>
+        /// <param name="vertices">The vertex array for the text fragment.</param>
+        /// <param name="indices">The index array for the text fragment. Please use the indexCount parameter
+        /// instead of indices.Count, as the indices array may be larger than necessary for performance reasons.</param>
+        /// <param name="indexCount">The actual number of indices in the text fragment.</param>
+        void Draw(Vector2[] vertices, ushort[] indices, int indexCount);
     }
 }
diff --git a/Source/Utilities/Fonts/TextPrinter.cs b/Source/Utilities/Fonts/TextPrinter.cs
index b66cacb9..f46f5c4e 100644
--- a/Source/Utilities/Fonts/TextPrinter.cs
+++ b/Source/Utilities/Fonts/TextPrinter.cs
@@ -28,23 +28,30 @@ namespace OpenTK.Graphics
     public class TextPrinter : ITextPrinter
     {
         //static Regex break_point = new Regex("[ .,/*-+?\\!=]", RegexOptions.Compiled | RegexOptions.IgnoreCase);
-        //static char[] split_chars = new char[]
-        //{
-        //    ' ', '\n', '\t', ',', '.', '/', '?', '!', ';', '\\', '-', '+', '*', '='
+        //static char[] split_chars = new char[]
+        //{
+        //    ' ', '\n', '\t', ',', '.', '/', '?', '!', ';', '\\', '-', '+', '*', '='
         //};
         static ITextPrinterImplementation printer;
-        float[] viewport = new float[4];
+        float[] viewport = new float[4];
           // Interleaved, vertex, texcoord, vertex, etc... Starts with 8 chars, will expand as needed.
         Vector2[] vertices = new Vector2[8 * 8];
         ushort[] indices = new ushort[6 * 8];
 
-        #region --- Constructor ---
+        #region --- Constructors ---
 
         /// <summary>
         /// Constructs a new TextPrinter object.
         /// </summary>
         public TextPrinter() { }
 
+        public TextPrinter(ITextPrinterImplementation implementation)
+        {
+            if (implementation == null)
+                throw new ArgumentNullException("implementation");
+            printer = implementation;
+        }
+
         #endregion
 
         #region --- Private Members ---