Q. GopdfでフォントをNoto Sans CJKに変更したら文字が細くなった

2025-02-07

Tech

PDF

/

Golang

状況#

Gopdfで PDF を出力する際に利用するフォントを Noto Sans CJK に変更したところ、文字自体は Noto Sans CJK で表示されるが文字が細くなったという報告を見かけ、不思議に思ったため調査を行った。

調査と原因の推測#

利用されているフォントを見ると、NotoSansCJKjp-VF.ttfとありバリアブルフォントであることが分かった。

Gopdf がバリアブルフォント対応していない、正確にはフォント自体は表示されているため、フォント特性をサポートしていないことが原因と考えられる。実際コードを見ると、フォント特性をコントロールするような API はなく、そもそも API がフォントファイルとスタイルを一対一で紐づけるようになっており静的フォントを前提としているように見える。

1
pdf.AddTTFFontWithOption("SomeFont", "./SomeFont-Regular.ttf", gopdf.TtfOption{
2
    Style: gopdf.Regular,
3
})
4

5
// これは内部的にRegularのSomeFontを探し、無ければエラーを吐く。
6
pdf.SetFont("SomeFont", "U", 16)

ただし、これは Gopdf に限らず、ざっと調べただけだが Go 言語のライブラリでは対応しているものがなく、JavaScript などのライブラリでも対応しているものは限られていた。さらに PDF 出力できる有名なアプリケーションでもバリアブルフォントの対応の不十分なものがあり、報告が見られる。

バリアブルフォントについて#

バリアブルフォント（Variable font、可変フォント）は OpenType フォント仕様を発展させたもので、単一のフォントファイルに複数のバリエーションを含めることができる。また、font-variation-settings プロパティなどを利用して、フォントの太さや幅、傾きなどを変化させることもできる。

2010 年代にサポートされた比較的新しいフォント形式だが、既に Google Fonts などを始め多くのプラットフォームでバリアブルフォントが提供されている。

これ以前のフォント（標準フォント、静的フォントと呼ばれる）はバリエーション毎に作成され、個別にファイルを提供している。