【要約】Pillowで多言語の画像を作ると、タイ語・ミャンマー語だけ静かに壊れる [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
自動化プロジェクトで多言語の図解画像を生成する開発者が、タイ語やミャンマー語の表示崩れに直面した。フォントに全文字のグリフが含まれているにもかかわらず、文字が重なる等の問題が発生した。
- ・原因はPillowのレイアウトエンジンがBASICに留まり、shaping（字形整形）を行わないこと。
- ・libraqmが未導入の場合、RAQMを指定しても警告のみでBASICへ静かにフォールバックされる。
- ・ベトナム語が正常だったのは、NFC正規化によりshapingを必要としない単一コードポイントだったため。
// Approach
環境依存の強いPillowの再ビルドを避け、確実な描画を実現するためにブラウザエンジンを利用した。HTMLとCSSでレイアウトを定義した。Playwright経由でヘッドレスChromeを用いて撮影する手法を採用した。
- ・HTML/CSSを用いてフォントスタックや行間、折り返しを定義する。
- ・PlaywrightでヘッドレスChromeを起動し、指定した解像度でレンダリングを行う。
- ・PythonのsubprocessからNode.jsスクリプトを呼び出し、画像として保存する。
// Result
この手法により、複雑な文字体系を持つ言語でも正確な描画が可能となった。また、CSSの活用により、Pillowで困難だった高度なテキスト制御も容易になった。
- ・タイ語やミャンマー語を含む全言語で、正しい字形整形が実現。
- ・CSSによる自動折り返し機能により、手動の改行位置計算ロジックを排除。
- ・既存のラテン文字用Pillowスクリプトと、新規言語用のHTML版を併用する運用へ移行。
Senior Engineer Insight
> 「エラーが出ない」事象が最も危険である。オプション依存が静かに失敗する設計は、大規模な自動化において致命的な品質低下を招く。解決策は、Pillowのビルド管理コストを、Playwrightへの依存に転換した点にある。インフラは複雑化する。しかし描画の正確性と表現力を考えれば、合理的な選択である。