PDViewerPreferences.BOUNDARY

PDViewerPreferences.BOUNDARYは、Apache PDFBoxのPDModel API内の列挙型クラスで、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ビューアアプリケーションでページがどのように表示、印刷、トリミングされるかを制御します。BOUNDARY列挙型は、5つの標準的なPDFページ境界を表す型安全な定数を提供します:MediaBox、CropBox、BleedBox、TrimBox、ArtBoxです。

PDViewerPreferences.BOUNDARYは、PDF仕様で定義されているページ境界ボックス定数をカプセル化するJava列挙型です。PDFドキュメントでは、異なる境界ボックスがドキュメントのレンダリングと制作ワークフローにおいて明確な目的を果たします。この列挙型は以下の標準化された識別子を提供します:

• MediaBox: 物理的なページサイズ
• CropBox: 表示または印刷時に見える領域
• BleedBox: 制作用の裁ち落とし領域を含む範囲
• TrimBox: 断裁後の意図された仕上がりページサイズ
• ArtBox: 意味のあるコンテンツ領域

この列挙型は主に、ページの表示または印刷にどの境界ボックスを使用するかを指定するビューア設定を行う際に使用されます。直接的な文字列表現とは異なり、BOUNDARY列挙型はコンパイル時の型安全性を提供し、PDFBox APIを使用する際の誤字や無効な境界ボックス名によるエラーを防ぎます。

ページ境界を理解し正しく実装することは、PDF生成、操作、またはビューアアプリケーションを開発する開発者にとって極めて重要です。異なるワークフローでは異なる境界ボックスが必要になります。例えば、印刷制作ワークフローでは、トンボや裁ち落とし領域を適切に処理するためにBleedBoxとTrimBoxへのアクセスが必要ですが、デジタルのみのドキュメントでは通常MediaBoxとCropBoxのみを使用します。

PDViewerPreferences.BOUNDARY列挙型を使用することで、PDFの操作コードがビューアアプリケーションによって尊重されるべきページ境界を正しく指定できるようになります。これは、プロフェッショナル印刷用のPDFを作成する場合、アクセシビリティ準拠を確保する場合、またはカスタムPDFビューアを実装する場合に特に重要です。境界の指定が誤っていると、コンテンツがクリップされたり、不適切なスケーリングが発生したり、様々なPDFリーダー間でページが意図したとおりに表示されなかったりする可能性があります。

BOUNDARY列挙型は、PDFBoxのビューア設定システムの一部として機能し、開発者がPDFリーダーアプリケーションにドキュメントの表示方法を指定できるようにします。ビューア設定を行う際、BOUNDARY列挙型の値を使用して、特定の表示または印刷操作にどのページ境界を使用するかを示すことができます。

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 ) では、ビューア設定にViewArea、ViewClip、PrintArea、PrintClipなどの設定を含めることができ、これらはそれぞれ値として境界ボックスタイプを受け入れます。PDViewerPreferences.BOUNDARY列挙型は、これらの境界ボックス名に直接マッピングされ、これらの設定をプログラム的に行う方法を提供します。

例えば、開発者はPDViewerPreferences.BOUNDARY.CROP_BOXを使用してビューアが各ページのトリミングされた領域のみを表示するように指定したり、PDViewerPreferences.BOUNDARY.MEDIA_BOXを使用して完全な物理的ページサイズを表示したりできます。列挙型の値は、PDF仕様の要件に準拠する名前オブジェクトとしてPDFのカタログ辞書にシリアル化されます。

境界ボックスは階層的な関係を形成し、小さいボックスは大きいボックス内に含まれる必要があり、MediaBoxが最も外側の必須境界となります。PDFBox APIは、これらの関係をプログラム的に読み取ったり変更したりする際の一貫性を維持するためにBOUNDARY列挙型を使用します。

• PDViewerPreferences – 表示と印刷設定を含むPDFビューア設定を管理するメインクラス
• PDPage – PDFドキュメント内の単一ページを表し、実際の境界ボックス定義を含む
• PDRectangle – PDFページの境界ボックスの寸法座標を定義するために使用されるクラス
• Viewer Preferences – PDFリーダーがユーザーにドキュメントをどのように提示すべきかを提案するドキュメントレベルの設定
• Page Boundaries – PDFページのジオメトリの異なる側面を定義する5つの境界ボックスタイプの総称