FontMapper

FontMapperは、Apache PDFBoxにおいてPDF文書を扱う際にフォント置換とマッピング機能を提供するクラスです。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) に従ってPDF文書内で指定されたフォントと、PDF操作を実行するシステム上で実際に利用可能なフォントとの橋渡しを行います。このコンポーネントは、PDFレンダリング、テキスト抽出、文書操作タスクにおいて視覚的忠実性を維持するために不可欠です。

FontMapperは、PDFで指定された正確なフォントが利用できない場合に適切な代替フォントを見つけることでフォント参照を解決する、Apache PDFBoxのユーティリティクラスです。PDF文書が ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているフォント辞書を使用してフォントを参照する際、FontMapperは文字の外観とテキストの整合性を保持しながら、代替として機能するシステム上の物理的なフォントファイルを決定します。

フォント埋め込み（フォントデータがPDF内に格納される）とは異なり、FontMapperは実行時のフォント解決を扱います。文字からグリフへのマッピングを処理するフォントエンコーディングクラスとも異なり、FontMapperはフォントファミリー、ウェイト、スタイルのマッチングというより高レベルのタスクに焦点を当てています。このクラスは内部マッピングを維持し、システムフォントディレクトリ、フォント設定ファイル、またはプログラム的に定義された置換ルールを使用してルックアップを実行できます。

PDFBoxを扱う開発者にとって、FontMapperはいくつかの実用的なシナリオで重要です。

テキスト抽出の精度: アクセシビリティ目的でPDFからテキストを抽出する場合や、 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) に準拠したTagged PDFを作成する際、適切なフォントマッピングにより文字が正しく識別・抽出され、文字化けや欠落を防ぎます。

レンダリングの一貫性: PDFコンテンツをレンダリングするアプリケーションは、元のフォントが利用できない場合にテキストを正しく表示するためにFontMapperを必要とします。これは、PDFが異なるシステムで作成された場合や独自フォントを使用している場合によく発生します。

クロスプラットフォーム互換性: FontMapperは、プラットフォーム固有のフォント配置メカニズムを抽象化し、フォールバック戦略を提供することで、Windows、macOS、Linux間でアプリケーションが一貫して動作するのを支援します。

文書処理: プログラム的にPDFを作成または修正する際、FontMapperは文書の外観を維持しながら、 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) のベストプラクティスに従ってテキストがアクセシブルで適切に構造化されたままであることを保証する適切なフォントの選択を支援します。

FontMapperはいくつかの主要なメカニズムを通じて動作します。

フォント検出: このクラスは初期化時にシステムフォントディレクトリをスキャンし、利用可能なフォントとそのプロパティ（ファミリー名、ウェイト、スタイルなど）の内部レジストリを構築します。WindowsではC:\Windows\Fontsのような標準ディレクトリを、Unix系システムでは/usr/share/fontsのようなパスを調べます。

置換ロジック: PDFBoxがPDF内のフォント参照に遭遇すると、FontMapperは優先順位付けされたマッチングアルゴリズムを使用します：

1. 正確なフォント名の一致を試行
2. 一致するウェイトとスタイルを持つ同じフォントファミリーを検索
3. 類似のフォントファミリーにフォールバック
4. デフォルトのフォールバックフォント（通常はArial、Helvetica、またはLiberation Sans）を使用

エンコーディング処理: FontMapperは ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されたフォントエンコーディングを考慮し、代替フォントが使用される場合でも文字コードがグリフに正しくマッピングされることを保証します。これは、非ラテン文字や記号フォントにとって特に重要です。

カスタマイズ: 開発者は以下の方法でFontMapperの動作を拡張または上書きできます：

• カスタムフォントディレクトリの登録
• 明示的なフォント置換マッピングの提供
• 埋め込みフォントやWebフォント用のカスタムフォントプロバイダーの実装
• 特定のフォントファミリーに対するフォールバック設定の構成

キャッシング: パフォーマンスを最適化するため、FontMapperはフォントルックアップとファイルシステムスキャンをキャッシュし、繰り返しのPDF操作中のオーバーヘッドを削減します。

• Font Dictionary（フォント辞書） – PDF標準で指定されている、フォントのプロパティ、メトリクス、エンコーディング情報を定義するPDFオブジェクト構造
• Font Embedding（フォント埋め込み） – すべてのシステムで一貫したレンダリングを保証するために、完全なフォントデータをPDFファイル内に含めるプロセス
• Glyph（グリフ） – 特定のフォントにおける文字の視覚的表現、テキスト表示の最小単位
• Character Encoding（文字エンコーディング） – 文字コードとその意味の間のマッピングシステム、PDFにおける適切なテキスト解釈に不可欠
• TrueType Font（TrueTypeフォント） – PDFやオペレーティングシステムで使用される一般的なフォント形式、スケーラブルなテキストレンダリングのためのアウトラインデータを含む