在 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 自然就修复此问题


本文会经常更新,请阅读原文: https://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.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

如果你想持续阅读我的最新博客,请点击 RSS 订阅,推荐使用RSS Stalker订阅博客,或者收藏我的博客导航

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

微软最具价值专家


无盈利,不卖课,做纯粹的技术博客

以下是广告时间

推荐关注 Edi.Wang 的公众号

欢迎进入 Eleven 老师组建的 .NET 社区

以上广告全是友情推广,无盈利