d6c292a2cc
https://github.com/Robmaister/SharpFont TODO: replace Code Bold.otf with the full version, fix any bugs, build on Linux, possibly move ToolBox string wrapping and limiting logic to ScalableFont class for better results.
547 lines
16 KiB
C#
547 lines
16 KiB
C#
#region MIT License
|
||
/*Copyright (c) 2012-2013, 2015-2016 Robert Rouhani <robert.rouhani@gmail.com>
|
||
|
||
SharpFont based on Tao.FreeType, Copyright (c) 2003-2007 Tao Framework Team
|
||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||
this software and associated documentation files (the "Software"), to deal in
|
||
the Software without restriction, including without limitation the rights to
|
||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
|
||
of the Software, and to permit persons to whom the Software is furnished to do
|
||
so, subject to the following conditions:
|
||
|
||
The above copyright notice and this permission notice shall be included in all
|
||
copies or substantial portions of the Software.
|
||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||
SOFTWARE.*/
|
||
#endregion
|
||
|
||
using System;
|
||
#if !SHARPFONT_PORTABLE
|
||
using System.Drawing;
|
||
using System.Drawing.Imaging;
|
||
#endif
|
||
using System.Runtime.InteropServices;
|
||
|
||
using SharpFont.Internal;
|
||
|
||
namespace SharpFont
|
||
{
|
||
/// <summary>
|
||
/// A structure used to describe a bitmap or pixmap to the raster. Note that we now manage pixmaps of various
|
||
/// depths through the <see cref="PixelMode"/> field.
|
||
/// </summary>
|
||
/// <remarks>
|
||
/// For now, the only pixel modes supported by FreeType are mono and grays. However, drivers might be added in the
|
||
/// future to support more ‘colorful’ options.
|
||
/// </remarks>
|
||
public sealed class FTBitmap : IDisposable
|
||
{
|
||
#region Fields
|
||
|
||
private IntPtr reference;
|
||
private BitmapRec rec;
|
||
|
||
private Library library;
|
||
|
||
private bool disposed;
|
||
|
||
//If the bitmap was generated with FT_Bitmap_New.
|
||
private bool user;
|
||
|
||
//HACK these variables exist to reduce the cost of reflection at runtime.
|
||
//Meant to be a temporary fix to https://github.com/Robmaister/SharpFont/issues/62
|
||
//until libgdiplus gets patched.
|
||
#if !SHARPFONT_PORTABLE
|
||
private bool hasCheckedForMono;
|
||
private bool isRunningOnMono;
|
||
private System.Reflection.FieldInfo monoPaletteFlagsField;
|
||
#endif
|
||
|
||
#endregion
|
||
|
||
#region Constructors
|
||
|
||
/// <summary>
|
||
/// Initializes a new instance of the <see cref="FTBitmap"/> class.
|
||
/// </summary>
|
||
/// <param name="library">The parent <see cref="Library"/>.</param>
|
||
public FTBitmap(Library library)
|
||
{
|
||
IntPtr bitmapRef = Marshal.AllocHGlobal(Marshal.SizeOf(typeof(BitmapRec)));
|
||
FT.FT_Bitmap_New(bitmapRef);
|
||
Reference = bitmapRef;
|
||
|
||
this.library = library;
|
||
this.user = true;
|
||
}
|
||
|
||
internal FTBitmap(IntPtr reference, Library library)
|
||
{
|
||
Reference = reference;
|
||
this.library = library;
|
||
}
|
||
|
||
internal FTBitmap(IntPtr reference, BitmapRec bmpInt, Library library)
|
||
{
|
||
this.reference = reference;
|
||
this.rec = bmpInt;
|
||
this.library = library;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Finalizes an instance of the <see cref="FTBitmap"/> class.
|
||
/// </summary>
|
||
~FTBitmap()
|
||
{
|
||
Dispose(false);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region Properties
|
||
|
||
/// <summary>
|
||
/// Gets a value indicating whether the <see cref="FTBitmap"/> has been disposed.
|
||
/// </summary>
|
||
public bool IsDisposed
|
||
{
|
||
get
|
||
{
|
||
return disposed;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the number of bitmap rows.
|
||
/// </summary>
|
||
public int Rows
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.rows;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the number of pixels in bitmap row.
|
||
/// </summary>
|
||
public int Width
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.width;
|
||
}
|
||
}
|
||
|
||
/// <summary><para>
|
||
/// Gets the pitch's absolute value is the number of bytes taken by one bitmap row, including padding. However,
|
||
/// the pitch is positive when the bitmap has a ‘down’ flow, and negative when it has an ‘up’ flow. In all
|
||
/// cases, the pitch is an offset to add to a bitmap pointer in order to go down one row.
|
||
/// </para><para>
|
||
/// Note that ‘padding’ means the alignment of a bitmap to a byte border, and FreeType functions normally align
|
||
/// to the smallest possible integer value.
|
||
/// </para><para>
|
||
/// For the B/W rasterizer, ‘pitch’ is always an even number.
|
||
/// </para><para>
|
||
/// To change the pitch of a bitmap (say, to make it a multiple of 4), use <see cref="FTBitmap.Convert"/>.
|
||
/// Alternatively, you might use callback functions to directly render to the application's surface; see the
|
||
/// file ‘example2.cpp’ in the tutorial for a demonstration.
|
||
/// </para></summary>
|
||
public int Pitch
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.pitch;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a typeless pointer to the bitmap buffer. This value should be aligned on 32-bit boundaries in most
|
||
/// cases.
|
||
/// </summary>
|
||
public IntPtr Buffer
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.buffer;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the number of gray levels used in the bitmap. This field is only used with
|
||
/// <see cref="SharpFont.PixelMode.Gray"/>.
|
||
/// </summary>
|
||
public short GrayLevels
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.num_grays;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the pixel mode, i.e., how pixel bits are stored.
|
||
/// </summary>
|
||
public PixelMode PixelMode
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.pixel_mode;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets how the palette is stored. This field is intended for paletted pixel modes.
|
||
/// </summary>
|
||
[Obsolete("Not used currently.")]
|
||
public byte PaletteMode
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.palette_mode;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets a typeless pointer to the bitmap palette; this field is intended for paletted pixel modes.
|
||
/// </summary>
|
||
[Obsolete("Not used currently.")]
|
||
public IntPtr Palette
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return rec.palette;
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// Gets the <see cref="FTBitmap"/>'s buffer as a byte array.
|
||
/// </summary>
|
||
public byte[] BufferData
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
//TODO deal with negative pitch
|
||
byte[] data = new byte[rec.rows * rec.pitch];
|
||
Marshal.Copy(rec.buffer, data, 0, data.Length);
|
||
return data;
|
||
}
|
||
}
|
||
|
||
internal IntPtr Reference
|
||
{
|
||
get
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
return reference;
|
||
}
|
||
|
||
set
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
reference = value;
|
||
rec = PInvokeHelper.PtrToStructure<BitmapRec>(reference);
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region Methods
|
||
|
||
/// <summary>
|
||
/// Copy a bitmap into another one.
|
||
/// </summary>
|
||
/// <param name="library">A handle to a library object.</param>
|
||
/// <returns>A handle to the target bitmap.</returns>
|
||
public FTBitmap Copy(Library library)
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
if (library == null)
|
||
throw new ArgumentNullException("library");
|
||
|
||
FTBitmap newBitmap = new FTBitmap(library);
|
||
IntPtr bmpRef = newBitmap.reference;
|
||
Error err = FT.FT_Bitmap_Copy(library.Reference, Reference, bmpRef);
|
||
newBitmap.Reference = bmpRef;
|
||
|
||
if (err != Error.Ok)
|
||
throw new FreeTypeException(err);
|
||
|
||
return newBitmap;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Embolden a bitmap. The new bitmap will be about ‘xStrength’ pixels wider and ‘yStrength’ pixels higher. The
|
||
/// left and bottom borders are kept unchanged.
|
||
/// </summary>
|
||
/// <remarks><para>
|
||
/// The current implementation restricts ‘xStrength’ to be less than or equal to 8 if bitmap is of pixel_mode
|
||
/// <see cref="SharpFont.PixelMode.Mono"/>.
|
||
/// </para><para>
|
||
/// If you want to embolden the bitmap owned by a <see cref="GlyphSlot"/>, you should call
|
||
/// <see cref="GlyphSlot.OwnBitmap"/> on the slot first.
|
||
/// </para></remarks>
|
||
/// <param name="library">A handle to a library object.</param>
|
||
/// <param name="xStrength">
|
||
/// How strong the glyph is emboldened horizontally. Expressed in 26.6 pixel format.
|
||
/// </param>
|
||
/// <param name="yStrength">
|
||
/// How strong the glyph is emboldened vertically. Expressed in 26.6 pixel format.
|
||
/// </param>
|
||
public void Embolden(Library library, Fixed26Dot6 xStrength, Fixed26Dot6 yStrength)
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
if (library == null)
|
||
throw new ArgumentNullException("library");
|
||
|
||
Error err = FT.FT_Bitmap_Embolden(library.Reference, Reference, (IntPtr)xStrength.Value, (IntPtr)yStrength.Value);
|
||
|
||
if (err != Error.Ok)
|
||
throw new FreeTypeException(err);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Convert a bitmap object with depth 1bpp, 2bpp, 4bpp, or 8bpp to a bitmap object with depth 8bpp, making the
|
||
/// number of used bytes per line (a.k.a. the ‘pitch’) a multiple of ‘alignment’.
|
||
/// </summary>
|
||
/// <remarks><para>
|
||
/// It is possible to call <see cref="Convert"/> multiple times without calling
|
||
/// <see cref="Dispose()"/> (the memory is simply reallocated).
|
||
/// </para><para>
|
||
/// Use <see cref="Dispose()"/> to finally remove the bitmap object.
|
||
/// </para><para>
|
||
/// The ‘library’ argument is taken to have access to FreeType's memory handling functions.
|
||
/// </para></remarks>
|
||
/// <param name="library">A handle to a library object.</param>
|
||
/// <param name="alignment">
|
||
/// The pitch of the bitmap is a multiple of this parameter. Common values are 1, 2, or 4.
|
||
/// </param>
|
||
/// <returns>The target bitmap.</returns>
|
||
public FTBitmap Convert(Library library, int alignment)
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
if (library == null)
|
||
throw new ArgumentNullException("library");
|
||
|
||
FTBitmap newBitmap = new FTBitmap(library);
|
||
IntPtr bmpRef = newBitmap.reference;
|
||
Error err = FT.FT_Bitmap_Convert(library.Reference, Reference, bmpRef, alignment);
|
||
newBitmap.Reference = bmpRef;
|
||
|
||
if (err != Error.Ok)
|
||
throw new FreeTypeException(err);
|
||
|
||
return newBitmap;
|
||
}
|
||
|
||
#if !SHARPFONT_PORTABLE
|
||
/// <summary>
|
||
/// Copies the contents of the <see cref="FTBitmap"/> to a GDI+ <see cref="Bitmap"/>.
|
||
/// </summary>
|
||
/// <returns>A GDI+ <see cref="Bitmap"/> containing this bitmap's data.</returns>
|
||
public Bitmap ToGdipBitmap()
|
||
{
|
||
return ToGdipBitmap(Color.Black);
|
||
}
|
||
|
||
/// <summary>
|
||
/// Copies the contents of the <see cref="FTBitmap"/> to a GDI+ <see cref="Bitmap"/>.
|
||
/// </summary>
|
||
/// <param name="color">The color of the text.</param>
|
||
/// <returns>A GDI+ <see cref="Bitmap"/> containing this bitmap's data with a transparent background.</returns>
|
||
public Bitmap ToGdipBitmap(Color color)
|
||
{
|
||
if (disposed)
|
||
throw new ObjectDisposedException("FTBitmap", "Cannot access a disposed object.");
|
||
|
||
if (rec.width == 0 || rec.rows == 0)
|
||
throw new InvalidOperationException("Invalid image size - one or both dimensions are 0.");
|
||
|
||
//TODO deal with negative pitch
|
||
switch (rec.pixel_mode)
|
||
{
|
||
case PixelMode.Mono:
|
||
{
|
||
Bitmap bmp = new Bitmap(rec.width, rec.rows, PixelFormat.Format1bppIndexed);
|
||
var locked = bmp.LockBits(new Rectangle(0, 0, rec.width, rec.rows), ImageLockMode.ReadWrite, PixelFormat.Format1bppIndexed);
|
||
|
||
for (int i = 0; i < rec.rows; i++)
|
||
PInvokeHelper.Copy(Buffer, i * rec.pitch, locked.Scan0, i * locked.Stride, locked.Stride);
|
||
|
||
bmp.UnlockBits(locked);
|
||
|
||
ColorPalette palette = bmp.Palette;
|
||
palette.Entries[0] = Color.FromArgb(0, color);
|
||
palette.Entries[1] = Color.FromArgb(255, color);
|
||
|
||
bmp.Palette = palette;
|
||
return bmp;
|
||
}
|
||
|
||
case PixelMode.Gray4:
|
||
{
|
||
Bitmap bmp = new Bitmap(rec.width, rec.rows, PixelFormat.Format4bppIndexed);
|
||
var locked = bmp.LockBits(new Rectangle(0, 0, rec.width, rec.rows), ImageLockMode.ReadWrite, PixelFormat.Format4bppIndexed);
|
||
|
||
for (int i = 0; i < rec.rows; i++)
|
||
PInvokeHelper.Copy(Buffer, i * rec.pitch, locked.Scan0, i * locked.Stride, locked.Stride);
|
||
|
||
bmp.UnlockBits(locked);
|
||
|
||
ColorPalette palette = bmp.Palette;
|
||
for (int i = 0; i < palette.Entries.Length; i++)
|
||
{
|
||
float a = (i * 17) / 255f;
|
||
palette.Entries[i] = Color.FromArgb(i * 17, (int)(color.R * a), (int)(color.G * a), (int)(color.B * a));
|
||
}
|
||
|
||
bmp.Palette = palette;
|
||
return bmp;
|
||
}
|
||
|
||
case PixelMode.Gray:
|
||
{
|
||
Bitmap bmp = new Bitmap(rec.width, rec.rows, PixelFormat.Format8bppIndexed);
|
||
var locked = bmp.LockBits(new Rectangle(0, 0, rec.width, rec.rows), ImageLockMode.ReadWrite, PixelFormat.Format8bppIndexed);
|
||
|
||
for (int i = 0; i < rec.rows; i++)
|
||
PInvokeHelper.Copy(Buffer, i * rec.pitch, locked.Scan0, i * locked.Stride, locked.Stride);
|
||
|
||
bmp.UnlockBits(locked);
|
||
|
||
ColorPalette palette = bmp.Palette;
|
||
for (int i = 0; i < palette.Entries.Length; i++)
|
||
{
|
||
float a = i / 255f;
|
||
palette.Entries[i] = Color.FromArgb(i, (int)(color.R * a), (int)(color.G * a), (int)(color.B * a));
|
||
}
|
||
|
||
//HACK There's a bug in Mono's libgdiplus requiring the "PaletteHasAlpha" flag to be set for transparency to work properly
|
||
//See https://github.com/Robmaister/SharpFont/issues/62
|
||
if (!hasCheckedForMono)
|
||
{
|
||
hasCheckedForMono = true;
|
||
isRunningOnMono = Type.GetType("Mono.Runtime") != null;
|
||
if (isRunningOnMono)
|
||
{
|
||
monoPaletteFlagsField = typeof(ColorPalette).GetField("flags", System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic);
|
||
}
|
||
}
|
||
|
||
if (isRunningOnMono)
|
||
monoPaletteFlagsField.SetValue(palette, palette.Flags | 1);
|
||
|
||
bmp.Palette = palette;
|
||
return bmp;
|
||
}
|
||
|
||
case PixelMode.Lcd:
|
||
{
|
||
//TODO apply color
|
||
int bmpWidth = rec.width / 3;
|
||
Bitmap bmp = new Bitmap(bmpWidth, rec.rows, PixelFormat.Format24bppRgb);
|
||
var locked = bmp.LockBits(new Rectangle(0, 0, bmpWidth, rec.rows), ImageLockMode.ReadWrite, PixelFormat.Format24bppRgb);
|
||
|
||
for (int i = 0; i < rec.rows; i++)
|
||
PInvokeHelper.Copy(Buffer, i * rec.pitch, locked.Scan0, i * locked.Stride, locked.Stride);
|
||
|
||
bmp.UnlockBits(locked);
|
||
|
||
return bmp;
|
||
}
|
||
/*case PixelMode.VerticalLcd:
|
||
{
|
||
int bmpHeight = rec.rows / 3;
|
||
Bitmap bmp = new Bitmap(rec.width, bmpHeight, PixelFormat.Format24bppRgb);
|
||
var locked = bmp.LockBits(new Rectangle(0, 0, rec.width, bmpHeight), ImageLockMode.ReadWrite, PixelFormat.Format24bppRgb);
|
||
for (int i = 0; i < bmpHeight; i++)
|
||
PInvokeHelper.Copy(Buffer, i * rec.pitch, locked.Scan0, i * locked.Stride, rec.width);
|
||
bmp.UnlockBits(locked);
|
||
|
||
return bmp;
|
||
}*/
|
||
|
||
default:
|
||
throw new InvalidOperationException("System.Drawing.Bitmap does not support this pixel mode.");
|
||
}
|
||
}
|
||
#endif
|
||
|
||
#region IDisposable
|
||
|
||
/// <summary>
|
||
/// Disposes an instance of the <see cref="FTBitmap"/> class.
|
||
/// </summary>
|
||
public void Dispose()
|
||
{
|
||
Dispose(true);
|
||
GC.SuppressFinalize(this);
|
||
}
|
||
|
||
private void Dispose(bool disposing)
|
||
{
|
||
if (!disposed)
|
||
{
|
||
disposed = true;
|
||
|
||
if (user)
|
||
{
|
||
FT.FT_Bitmap_Done(library.Reference, reference);
|
||
Marshal.FreeHGlobal(reference);
|
||
}
|
||
|
||
reference = IntPtr.Zero;
|
||
library = null;
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#endregion
|
||
}
|
||
}
|