本文将和大家介绍在 C# 里面简单使用 SharpFont 对 FreeType 的封装,读取 ttf 等字体文件信息,绘制出某个文字到图片文件
由于本文使用的 SharpFont 库已经很久没有维护了,本文的例子里面使用的 .NET 框架就退回到 .NET Framework 4.7.2 版本。我大概看了代码,预计 dotnet 6 等版本还是能够兼容的,只是为了方便我写例子代码,减少遇到一些奇怪的问题,本文的例子就采用比较旧的框架
开始之前先感谢 Robert Rouhani 大佬开源的 https://github.com/Robmaister/SharpFont 项目,尽管这个项目已经很久没有维护了
按照 .NET 的惯例,先通过 NuGet 安装库,我通过编辑 csproj 文件快速进行安装,编辑之后的 csproj 项目文件的代码如下
代码语言:csharp复制<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net472</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<LangVersion>latest</LangVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="SharpFont" Version="4.0.1" />
</ItemGroup>
</Project>
先通过 SetDllDirectory 按照 x64 或 x86 方式加载库,代码如下,以下这部分感觉是基础库没有封装好的部分
代码语言:csharp复制 public static void Main(string[] args)
{
var folderPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
var nugetFolder = Path.Combine(folderPath, @"...nugetpackagessharpfont.dependencies");
// 如果自己的 nuget 没有设置为其他路径的话
var sharpFontDependenciesNuGetFolder = Directory.EnumerateDirectories(nugetFolder).First();
if (Environment.Is64BitProcess)
{
var libraryFolder = Path.Combine(sharpFontDependenciesNuGetFolder, @"binmsvc12x64");
SetDllDirectory(libraryFolder);
}
else
{
var libraryFolder = Path.Combine(sharpFontDependenciesNuGetFolder, @"binmsvc12x86");
SetDllDirectory(libraryFolder);
}
}
[DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern bool SetDllDirectory(string path);
以上代码我是去找 NuGet 文件夹里面的依赖包里面的文件
完成以上步骤之后,即可创建出 Face 对象。如以下代码随意给一个字体文件进行测试
代码语言:csharp复制 var library = new Library();
var face = new Face(library, @"C:windowsfontssimfang.ttf");
接下来的代码将演示如何获取某个字符在字体里面的信息,以及将这个字体用这个字体渲染到本地图片文件
获取字符在字体里面的信息,需要先获取到字符在字体里面的索引,代码如下
代码语言:csharp复制 uint glyphIndex = face.GetCharIndex('林');
以上代码就可以获取到 林
字在字体文件里面的索引
接下来为了将字体加载到 slot 里面,需要先设置一点必要的初始化参数
代码语言:csharp复制 // 设置字体大小,修复 SharpFont.FreeTypeException:“FreeType error: Invalid size handle.”
face.SetCharSize(26,0,96,0);
接着将字体加载到 slot 里面,用于后续获取 Glyph 属性,获取信息
代码语言:javascript复制 // 加载 slot 用于后续渲染
face.LoadGlyph(glyphIndex, LoadFlags.Default, LoadTarget.Normal);
完成以上步骤即可使用以下代码,获取到字符的信息
代码语言:csharp复制 float advanceX = (float) face.Glyph.Advance.X; // same as the advance in metrics
float bearingX = (float) face.Glyph.Metrics.HorizontalBearingX;
float width = face.Glyph.Metrics.Width.ToSingle();
float glyphTop = (float) face.Glyph.Metrics.HorizontalBearingY;
float glyphBottom = (float) (face.Glyph.Metrics.Height - face.Glyph.Metrics.HorizontalBearingY);
以上的各个变量就是对于传入的字符的信息
将字体渲染到图片需要借助 GDI 部分的辅助,先调用 RenderGlyph 方法,再通过 ToGdipBitmap 转换为 System.Drawing.Bitmap 对象,用于保存到本地文件
代码语言:csharp复制 face.Glyph.RenderGlyph(RenderMode.Normal);
face.Glyph.Bitmap.ToGdipBitmap().Save("1.png");
以上的代码我都放在一个 Main 方法里面,代码如下
代码语言:csharp复制using System;
using System.Collections.Generic;
using System.Drawing;
using System.Linq;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks;
using SharpFont;
namespace ChewukeriLudikanal
{
internal class Program
{
public static void Main(string[] args)
{
var folderPath = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
var nugetFolder = Path.Combine(folderPath, @"...nugetpackagessharpfont.dependencies");
// 如果自己的 nuget 没有设置为其他路径的话
var sharpFontDependenciesNuGetFolder = Directory.EnumerateDirectories(nugetFolder).First();
if (Environment.Is64BitProcess)
{
var libraryFolder = Path.Combine(sharpFontDependenciesNuGetFolder, @"binmsvc12x64");
SetDllDirectory(libraryFolder);
}
else
{
var libraryFolder = Path.Combine(sharpFontDependenciesNuGetFolder, @"binmsvc12x86");
SetDllDirectory(libraryFolder);
}
var library = new Library();
var face = new Face(library, @"C:windowsfontssimfang.ttf");
uint glyphIndex = face.GetCharIndex('林');
// 设置字体大小,修复 SharpFont.FreeTypeException:“FreeType error: Invalid size handle.”
face.SetCharSize(26,0,96,0);
// 加载 slot 用于后续渲染
face.LoadGlyph(glyphIndex, LoadFlags.Default, LoadTarget.Normal);
// 获取字体信息
float advanceX = (float) face.Glyph.Advance.X; // same as the advance in metrics
float bearingX = (float) face.Glyph.Metrics.HorizontalBearingX;
float width = face.Glyph.Metrics.Width.ToSingle();
float glyphTop = (float) face.Glyph.Metrics.HorizontalBearingY;
float glyphBottom = (float) (face.Glyph.Metrics.Height - face.Glyph.Metrics.HorizontalBearingY);
// 尝试获取字间距
//kern = (float) face.GetKerning(glyphIndex, face.GetCharIndex(cNext), KerningMode.Default).X;
face.Glyph.RenderGlyph(RenderMode.Normal);
face.Glyph.Bitmap.ToGdipBitmap().Save("1.png");
}
[DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
private static extern bool SetDllDirectory(string path);
}
}
尝试运行代码,可以看到运行之后输出了 1.png 文件,用图片查看器打开可以看到里面绘制出了字符
本文代码放在 github 和 gitee 上,可以使用如下命令行拉取代码
先创建一个空文件夹,接着使用命令行 cd 命令进入此空文件夹,在命令行里面输入以下代码,即可获取到本文的代码
代码语言:bash复制git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin df6a50e5af79104064e91aca92f72d331fac7161
以上使用的是 gitee 的源,如果 gitee 不能访问,请替换为 github 的源。请在命令行继续输入以下代码,将 gitee 源换成 github 源进行拉取代码
代码语言:bash复制git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin df6a50e5af79104064e91aca92f72d331fac7161
获取代码之后,进入 ChewukeriLudikanal 文件夹,即可获取到源代码