From c0803a2e03d97a4bff1ef80f5b1adf2a049791cb Mon Sep 17 00:00:00 2001 From: the_fiddler Date: Tue, 24 Jun 2008 18:27:51 +0000 Subject: [PATCH] Renamed MeasureCharacterRanges to MeasureText. Sped up MeasureText. Added MeasureText overloads. Obsoleted MeasureString function. --- Source/Utilities/Fonts/TextureFont.cs | 122 +++++++++++++++++++------- 1 file changed, 89 insertions(+), 33 deletions(-) diff --git a/Source/Utilities/Fonts/TextureFont.cs b/Source/Utilities/Fonts/TextureFont.cs index edb1f54d..e561d629 100644 --- a/Source/Utilities/Fonts/TextureFont.cs +++ b/Source/Utilities/Fonts/TextureFont.cs @@ -33,15 +33,17 @@ namespace OpenTK.Graphics static int texture; static TexturePacker pack; static int texture_width, texture_height; + static StringFormat default_string_format = StringFormat.GenericTypographic; + static SizeF maximum_graphics_size; + + int[] data = new int[256]; // Used to upload the glyph buffer to the OpenGL texture. - int[] data = new int[256]; // Used to upload glyph buffer to the OpenGL texture. - object upload_lock = new object(); #region --- Constructor --- /// - /// Constructs a new TextureFont object, using the specified System.Drawing.Font. + /// Constructs a new TextureFont, using the specified System.Drawing.Font. /// /// The System.Drawing.Font to use. public TextureFont(Font font) @@ -53,6 +55,7 @@ namespace OpenTK.Graphics bmp = new Bitmap(font.Height * 2, font.Height * 2); gfx = Graphics.FromImage(bmp); + maximum_graphics_size = gfx.ClipBounds.Size; // Adjust font rendering mode. Small sizes look blurry without gridfitting, so turn // that on. Increasing contrast also seems to help. @@ -68,6 +71,25 @@ namespace OpenTK.Graphics } } + /// + /// Constructs a new TextureFont, using the specified parameters. + /// + /// The System.Drawing.FontFamily to use for the typeface. + /// The em size to use for the typeface. + public TextureFont(FontFamily family, float emSize) + : this(new Font(family, emSize)) + { } + + /// + /// Constructs a new TextureFont, using the specified parameters. + /// + /// The System.Drawing.FontFamily to use for the typeface. + /// The em size to use for the typeface. + /// The style to use for the typeface. + public TextureFont(FontFamily family, float emSize, FontStyle style) + : this(new Font(family, emSize, style)) + { } + #endregion #region --- Public Methods --- @@ -83,8 +105,16 @@ namespace OpenTK.Graphics RectangleF rect = new RectangleF(); foreach (char c in glyphs) { - if (!loaded_glyphs.ContainsKey(c)) - LoadGlyph(c, out rect); + try + { + if (!loaded_glyphs.ContainsKey(c)) + LoadGlyph(c, out rect); + } + catch (Exception e) + { + Debug.Print(e.ToString()); + throw; + } } } @@ -165,6 +195,7 @@ namespace OpenTK.Graphics /// The measured width. /// The measured height. /// If true, adds space to account for glyph overhangs. Set to true if you wish to measure a complete string. Set to false if you wish to perform layout on adjacent strings. + [Obsolete("Returns invalid results - use MeasureText() instead")] public void MeasureString(string str, out float width, out float height, bool accountForOverhangs) { System.Drawing.StringFormat format = accountForOverhangs ? System.Drawing.StringFormat.GenericDefault : System.Drawing.StringFormat.GenericTypographic; @@ -212,6 +243,7 @@ namespace OpenTK.Graphics /// The measured width. /// The measured height. /// + [Obsolete("Returns invalid results - use MeasureText() instead")] public void MeasureString(string str, out float width, out float height) { MeasureString(str, out width, out height, true); @@ -219,56 +251,75 @@ namespace OpenTK.Graphics #endregion - #region public void MeasureCharacterRanges(string text, ref ICollection ranges) + #region public RectangleF MeasureText(string text) /// - /// Measures the individual character positions for the specified string. + /// Calculates size information for the specified text. /// /// The string to measure. - /// An ICollection of RectangleF structures, containing the positions of individual characters. - public void MeasureCharacterRanges(string text, ref ICollection ranges) + /// A RectangleF containing the bounding box for the specified text. + public RectangleF MeasureText(string text) { - MeasureCharacterRanges(text, false, ref ranges); + return MeasureText(text, SizeF.Empty, default_string_format, null); } #endregion - #region public void MeasureCharacterRanges(string text, bool accountForOverhangs, ref ICollection ranges) + #region public RectangleF MeasureText(string text, SizeF bounds) /// - /// Measures the individual character positions for the specified string. + /// Calculates size information for the specified text. /// /// The string to measure. - /// If true, adds space to account for glyph overhangs. Set to true if you wish to measure a complete string. Set to false if you wish to perform layout on adjacent strings. - /// An ICollection of RectangleF structures, containing the positions of individual characters. - public void MeasureCharacterRanges(string text, bool accountForOverhangs, ref ICollection ranges) + /// A SizeF structure containing the maximum desired width and height of the text. Default is SizeF.Empty. + /// A RectangleF containing the bounding box for the specified text. + public RectangleF MeasureText(string text, SizeF bounds) { - System.Drawing.StringFormat format = accountForOverhangs ? System.Drawing.StringFormat.GenericDefault : System.Drawing.StringFormat.GenericTypographic; - RectangleF rect = new RectangleF(0, 0, gfx.ClipBounds.Width, gfx.ClipBounds.Height); - MeasureCharacterRanges(text, ref rect, format, ref ranges); + return MeasureText(text, bounds, default_string_format, null); } #endregion + #region public RectangleF MeasureText(string text, SizeF bounds, StringFormat format) + + /// + /// Calculates size information for the specified text. + /// + /// The string to measure. + /// A SizeF structure containing the maximum desired width and height of the text. Pass SizeF.Empty to disable wrapping calculations. A width or height of 0 disables the relevant calculation. + /// A StringFormat object which specifies the measurement format of the string. Pass null to use the default StringFormat (StringFormat.GenericTypographic). + /// A RectangleF containing the bounding box for the specified text. + public RectangleF MeasureText(string text, SizeF bounds, StringFormat format) + { + return MeasureText(text, bounds, format, null); + } + #endregion - #region --- Private Methods --- + #region public RectangleF MeasureText(string text, SizeF bounds, StringFormat format, IList ranges) - #region void MeasureCharacterRanges(string text, ref RectangleF layoutRect, StringFormat format, ref ICollection ranges) - - void MeasureCharacterRanges(string text, ref RectangleF layoutRect, StringFormat format, ref ICollection ranges) + /// + /// Calculates size information for the specified text. + /// + /// The string to measure. + /// A SizeF structure containing the maximum desired width and height of the text. Pass SizeF.Empty to disable wrapping calculations. A width or height of 0 disables the relevant calculation. + /// A StringFormat object which specifies the measurement format of the string. Pass null to use the default StringFormat (StringFormat.GenericTypographic). + /// Fills the specified IList of RectangleF structures with position information for individual characters. If this argument is null, these calculations are skipped. + /// A RectangleF containing the bounding box for the specified text. + public RectangleF MeasureText(string text, SizeF bounds, StringFormat format, IList ranges) { - ranges.Clear(); // Hopefully this doesn't trim the collection. - - //GPRECTF rect = new GPRECTF(layoutRect); - //rect = new GPRECTF(0, 0, 256, 256); int status = 0; - if (String.IsNullOrEmpty(text)) - return; + RectangleF bounding_box = new RectangleF(); - if (font == null) throw new ArgumentNullException("font"); - if (format == null) throw new ArgumentNullException("format"); + if (String.IsNullOrEmpty(text)) + return RectangleF.Empty; + + if (bounds == SizeF.Empty) + bounds = maximum_graphics_size; + + if (format == null) + format = default_string_format; IntPtr[] regions = new IntPtr[GdiPlus.MaxMeasurableCharacterRanges]; CharacterRange[] characterRanges = new CharacterRange[GdiPlus.MaxMeasurableCharacterRanges]; @@ -295,6 +346,7 @@ namespace OpenTK.Graphics IntPtr native_graphics = GdiPlus.GetNativeGraphics(gfx); IntPtr native_font = GdiPlus.GetNativeFont(font); IntPtr native_string_format = GdiPlus.GetNativeStringFormat(format); + RectangleF layoutRect = new RectangleF(PointF.Empty, bounds); status = GdiPlus.MeasureCharacterRanges(new HandleRef(gfx, native_graphics), text, text.Length, new HandleRef(font, native_font), ref layoutRect, @@ -303,15 +355,19 @@ namespace OpenTK.Graphics for (int j = 0; j < num_characters; j++) { - RectangleF rect = new RectangleF(); - status = GdiPlus.GetRegionBounds(regions[j], new HandleRef(gfx, GdiPlus.GetNativeGraphics(gfx)), ref rect); + status = GdiPlus.GetRegionBounds(regions[j], new HandleRef(gfx, GdiPlus.GetNativeGraphics(gfx)), ref bounding_box); - ranges.Add(rect); + if (ranges != null) + ranges.Add(bounding_box); status = GdiPlus.DeleteRegion(regions[j]); } + bounding_box.Size = new SizeF(bounding_box.X + bounding_box.Width, bounding_box.Y + bounding_box.Height); + bounding_box.Location = PointF.Empty; } + + return bounding_box; } #endregion