オーバーレイ（PDFBoxツール）

Overlayツールは、Apache PDFBoxが提供するコマンドラインユーティリティで、2つのPDF文書のページを重ね合わせて結合する機能を開発者に提供します。このツールは、既存のPDF文書に透かし、スタンプ、または背景デザインを追加する用途で一般的に使用されます。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 ) は、オーバーレイを可能にする基礎となるページコンテンツストリームモデルを定義していますが、Overlayツールは、手動でコンテンツストリームを操作することなくこの機能を実装するための高レベルなJava APIを提供します。

Overlayツールは、Apache PDFBoxのコマンドラインアプリケーションスイートの一部で、複数のPDFファイルのコンテンツをレイヤー化して結合するプロセスを自動化します。単純なページの連結や統合とは異なり、Overlayツールは、1つのPDF文書（オーバーレイ文書）のページコンテンツを、別のPDF文書（入力文書）のページの上または下に配置し、合成結果を生成します。これは、既存のコンテンツを変更するPDF編集操作や、独立したページオブジェクトである注釈とは異なります。オーバーレイは、複数のページのコンテンツストリームを実際に結合し、出力文書内の単一のページにします。

このツールは、複数のオーバーレイモードをサポートしています。入力文書のすべてのページに同じオーバーレイページを適用したり、奇数ページと偶数ページに異なるオーバーレイページを使用したり、指定したページ範囲に特定のオーバーレイを適用したりできます。開発者は、オーバーレイコンテンツを前景（元のコンテンツの上に表示）または背景（元のコンテンツの下に表示）に配置できるため、透かしとテンプレート化の両方のシナリオに適しています。

Overlayツールは、PDFコンテンツストリーム構文の深い知識を必要とせずに、一貫したブランディング、セキュリティマーキング、または装飾要素を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を扱う場合、開発者は、オーバーレイされた装飾要素が基礎となるコンテンツの意味構造や読み上げシーケンスを破壊しないようにする必要があります。

このツールは、効率的なバッチ処理操作も可能にし、組織が手動介入や高額なサードパーティサービスを使用せずに、大規模な文書コレクションに透かしや背景を適用できるようにします。

OverlayツールはPDFBox APIレベルでPDFページのコンテンツストリームを操作することで動作します。文書をオーバーレイする際、ツールはオーバーレイPDFページからコンテンツストリーム演算子を読み取り、指定されたレイヤーモードに従って入力PDFページのコンテンツストリーム演算子と結合します。

背景オーバーレイの場合、ツールは結合出力において元のページのコンテンツストリームの前にオーバーレイコンテンツストリームを配置します。前景オーバーレイ（透かし）の場合、オーバーレイコンテンツは元のコンテンツの後に追加されます。このシーケンスが、PDFリーダーがページをレンダリングする際のz順序の描画優先度を決定します。

このツールは、オーバーレイ文書のグラフィカル要素を統合しながら、入力文書のページサイズ、メディアボックス、クロップボックスを保持します。オーバーレイページと入力ページのサイズが異なる場合、ツールはオーバーレイコンテンツを元の座標で維持するため、適切な配置を確保するためにオーバーレイテンプレートを慎重に設計する必要がある場合があります。

コマンドラインの観点からは、開発者は入力PDF、オーバーレイPDF、出力先、およびページ範囲と配置のオプション設定を指定するパラメータを使用してツールを呼び出します。プログラム的には、PDFBoxのOverlayクラスがPDFDocumentオブジェクトと設定パラメータを受け取るJavaメソッドを提供し、より大規模な文書処理パイプラインへの統合を可能にします。

基礎となるメカニズムは、 ( 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のコンテンツストリームモデルに依存しています。このモデルでは、各ページにテキスト、画像、ベクターグラフィックスの描画方法を記述するグラフィックス演算子のストリームが含まれています。これらのストリームを慎重に結合することで、Overlayツールは両方のソース文書のコンテンツを同時に表示するページを作成します。

• Content Stream（コンテンツストリーム） – ページの視覚的外観を定義するPDF演算子のシーケンス
• Watermark（透かし） – 文書のステータス、所有権、または真正性を示すために文書に重ねて表示される可視マーキング（テキストまたは画像）
• Page Object（ページオブジェクト） – ページプロパティ、コンテンツ参照、およびメタデータを含むPDF辞書構造
• Form XObject（フォームXObject） – PDF内で複数回参照およびレンダリングできる再利用可能なコンテンツストリーム
• Z-order（Z順序） – 重なり合うグラフィカル要素の前後の順序で、どのコンテンツが上に表示されるかを決定する