Skip to content

WPF 解决 Skia 因为找不到字体而绘制不出中文字符

Updated: at 08:22,Created: at 04:30

在 WPF 使用 Skia 做渲染工具,如果绘制的中文都是方块,也许是字体的问题。字体的问题是 Skia 没有找到字体,本文告诉大家如何修复

在 Skia 使用特定字体,可以使用 SkiaSharp 的 SKTypeface 方法指定

var name = "微软雅黑";
var skTypeface = SKTypeface.FromFamilyName(name);

但是如何判断 Skia 找不到字体?可以判断字体名

var name = "微软雅黑";
var skTypeface = SKTypeface.FromFamilyName(name);
if (skTypeface.FamilyName != name)
{
// 字体加载失败了
}

解决方法是通过 WPF 辅助拿到字体,请看代码

var fontFamily = new FontFamily(name);
foreach (var familyNamesValue in fontFamily.FamilyNames.Values)
{
skTypeface = SKTypeface.FromFamilyName(familyNamesValue);
if (skTypeface.FamilyName == familyNamesValue)
{
break;
}
}

上面代码存在的坑是 SKTypeface 是需要手动释放的资源,因此优化的代码如下

var name = "微软雅黑";
var skTypeface = SKTypeface.FromFamilyName(name);
if (skTypeface.FamilyName != name)
{
// 字体加载失败了
skTypeface.Dispose();
}
var fontFamily = new FontFamily(name);
foreach (var familyNamesValue in fontFamily.FamilyNames.Values)
{
skTypeface = SKTypeface.FromFamilyName(familyNamesValue);
if (skTypeface.FamilyName == familyNamesValue)
{
break;
}
else
{
skTypeface.Dispose();
}
}

需要在绘制之后调用 Dispose 释放字体


更新:

在 SkiaSharp 2.88.3 之前,由于没有合入我的修复代码: https://github.com/mono/SkiaSharp/pull/2146

导致了输入中文的字体名的时候,在 SKTypeface.FromFamilyName 返回找不到

如果是此问题,那只需要更新 SkiaSharp 到 2.88.3 或更高版本

为什么在 2.88.3 之前,传入中文的字体名的时候,将会返回找不到字体?

原因是在 SkiaSharp 里面使用平台调用的时候,传入的中文字体名采用的是 C# 默认的 UTF16 编码。然而在 Skia 里面,期望的字符串编码采用的是 UTF8 编码。这就导致了咱给的中文的字体名,将不会被 Skia 底层识别,从而找不到字体

详细请参阅 [BUG] sk_fontmgr_match_family_style must input family name argument by utf8 string · Issue #1914 · mono/SkiaSharp

另外的,如果采用 MAUI 配合 Skia 进行渲染的,也可能出现中文无法渲染的问题,这是 MAUI 层也存在的坑。此问题已经被我修了,请看 https://github.com/dotnet/maui/pull/9124

详细请看 Microsoft.Maui.Graphics.Skia do not support Chinese text drawing · Issue #473 · dotnet/Microsoft.Maui.Graphics

也就是说只需要更新到最新版本的 MAUI 自然就修复此问题


知识共享许可协议

原文链接: http://blog.lindexi.com/post/WPF-%E8%A7%A3%E5%86%B3-Skia-%E5%9B%A0%E4%B8%BA%E6%89%BE%E4%B8%8D%E5%88%B0%E5%AD%97%E4%BD%93%E8%80%8C%E7%BB%98%E5%88%B6%E4%B8%8D%E5%87%BA%E4%B8%AD%E6%96%87%E5%AD%97%E7%AC%A6

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。 欢迎转载、使用、重新发布,但务必保留文章署名 林德熙 (包含链接: https://blog.lindexi.com ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请与我 联系