PDFSharp 中文字體問題研究

讀者 GregYu 問到 PdfSharp 的中文支援問題。

直覺認為 PdfSharp 身為資深元件，使用者眾，字型支援應該很成熟，不會遇到阻礙才對。但實際一試，馬上學到一些魔鬼細節。

用以下範例重現問題：

using System.Diagnostics;
using MigraDoc.DocumentObjectModel;
using MigraDoc.Rendering;
using PdfSharp.Pdf;

var document = new Document();
var normalStyle = document.Styles.Normal;
normalStyle.Font.Size = 14;
normalStyle.Font.Bold = false;

var kaiStyle = document.Styles.AddStyle("Kai", "Normal");
kaiStyle.Font.Name = "標楷體";

var mingStyle = document.Styles.AddStyle("Ming", "Normal");
mingStyle.Font.Name = "新細明體";

var section = document.AddSection();
var p = section.AddParagraph();
p.Add(new Text("Normal: 中文測試 Hello, World!"));
p.AddLineBreak();

p = section.AddParagraph();
p.Style = "Kai";
p.Add(new Text("標楷: 中文測試 Hello, World!"));
p.AddLineBreak();

/*
p = section.AddParagraph();
p.Style = "Ming";
p.Add(new Text("新細明: 中文測試 Hello, World!"));
p.AddLineBreak();
*/

var pdfRenderer = new PdfDocumentRenderer
{
    Document = document,
    PdfDocument = new PdfDocument()
};
pdfRenderer.RenderDocument();

var filename = Path.GetTempFileName() + ".pdf";
pdfRenderer.PdfDocument.Save(filename);
Process.Start(new ProcessStartInfo(filename) { UseShellExecute = true });

我準備用三種樣式顯示含中文的字串，字體分別為預設字體、標楷體、新細明體(新細明體部分先註解掉)。結果如下：

預設字型中文變方格無法顯示，標楷體倒是正常。接著取消註解，加入新細明體段落，程式便會出現 Font has no usable platform or encoding ID. It cannot be used with PDFsharp. at PdfSharp.Fonts.OpenType.CMapTable.Read() 錯誤：

查了一下，這是個已知問題。微軟 Windows 字型檔會分成 TTF 跟 TTC 兩種格式(參考：【三個常見字型】TTF. / OTF. / TTC. 副檔名的差異)，TTC 為 True Type Collection，可將同一套字型的 Light/Regular/Bold 字體集合成一個文件，從而共同字型輪廓節省大量空間。當代字體諸如：新細明體(mingliu.ttc)、微軟正黑體(msjh.ttc)、微軟雅黑體(msyh.ttc)... 幾乎都是採用 TTC 格式，上古字型標楷體 (Kai.ttf)及新宋體-ExtB(simsunb.ttf) 是碩果僅存的 TTF 格式。而 PdfSharp 只支援 TTF 格式，登楞!

一個無腦解法是設法找 TTF 格式的中文字型檔，這裡以 翰字鑄造 JT Foundry 台北黑體為例，安裝字型後，用 var fontName = System.Drawing.FontFamily.Families.FirstOrDefault(f => f.Name.Contains("Taipei"))?.Name; 查得台北黑體對應的系統名稱為 "Taipei Sans TC Beta"，指定正確字體名稱即可成功顯示：

var tpeStyle = document.Styles.AddStyle("TPE", "Normal");
tpeStyle.Font.Name = "Taipei Sans TC Beta";

//...

p = section.AddParagraph();
p.Style = "TPE";
p.Add(new Text("台北黑體: 中文測試 Hello, World!"));
p.AddLineBreak();

小測了一下，PdfSharp 產生包含自訂中文字型的 PDF，在 Linux 上檢視也是 OK 的。

除了找 TTF 將就 PdfSharp，另個思路是修改 PdfSharp 使其支援 TTC，網路上可找到網友分享的修改方式，但工程較大，這篇先留個筆記，待日後有實際需求再研究。

Research and Workaround for Chinese Font Support Issue in PdfSharp.