Overlay

Apache PDFBoxのOverlayは、あるPDF文書のコンテンツを別のPDF文書のページ上に重ね合わせる機能を提供するJava APIクラスです。この機能は、既存の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 ) では階層化されたコンテンツの基本構造が定義されていますが、PDFBoxのOverlayクラスは、PDFコンテンツをプログラムで結合するための高レベルなJavaインターフェースを提供します。

Apache PDFBoxのOverlayクラスは、ソースPDF文書の1ページ以上をターゲットPDF文書のページの上(または下)に配置することで、PDFコンテンツの結合を容易にするユーティリティです。単純なページの連結やマージとは異なり、Overlay操作は、ベース文書の既存コンテンツを保持しながら、新しい視覚要素を階層化して追加します。このクラスは、各ページの既存コンテンツの前面(上)または背景(下)にオーバーレイコンテンツを配置するなど、さまざまなオーバーレイモードをサポートしています。これは、ページコンテンツを直接変更するコンテンツストリームとは異なり、Overlayはページレベルで動作し、 ( 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クラスは、各ページのコンテンツストリームを手動で編集することなく、プログラムでPDF文書を強化する必要がある開発者にとって不可欠です。一般的な使用例としては、企業ブランディングの適用、セキュリティ透かしの追加、免責事項の挿入、動的に生成される文書へのテンプレート適用などがあります。この機能により、低レベルの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 ) 標準に準拠したアクセシビリティ対応文書の場合、オーバーレイ操作が文書の論理構造や読み上げ順序にどのように影響するかを理解することは、コンプライアンスを維持する上で極めて重要です。

Overlayクラスは、ベースPDF文書と1つ以上のオーバーレイ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 ) で要求される構造を維持しますが、アクセシブルなPDFを扱う場合、開発者はオーバーレイ操作がTagged Contentの構造に干渉しないことを検証する必要があります。

• PDDocument – メモリ内のPDF文書を表すApache PDFBoxのメインクラス
• Content Stream – ページの視覚的外観を記述するPDF演算子のシーケンス
• Page Tree – PDF内のすべてのページを整理して参照する階層構造
• Layer (Optional Content Group) – オーバーレイの配置とは独立してコンテンツの可視性を制御できるPDF機能
• PDPageContentStream – PDFページに直接コンテンツを書き込むためのApache PDFBoxクラス