PDRectangle

PDRectangleは、Apache PDFBoxの高レベルPDModel 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 ) に従って、ページ境界、メディアボックス、クロップボックス、注釈領域などの様々なPDF要素の座標と寸法を定義します。PDRectangleは、原点(0,0)が通常ページの左下隅に位置するPDF座標空間を使用して、矩形のプロパティを作成、変更、照会するためのメソッドを提供します。

PDRectangleは、PDF文書内の矩形の幾何学的プロパティをカプセル化するJavaクラスです。4つの座標値(左下x、左下y、右上x、右上y)を格納するか、あるいはx、y、幅、高さとして表現します。汎用のJava矩形クラス(java.awt.Rectangleなど)とは異なり、PDRectangleは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 ) で規定された矩形定義に準拠しています。

このクラスは、標準ページサイズ(A4、LETTER、LEGALなど)の定義済み定数を提供し、矩形の寸法を取得したり、幅と高さを計算したり、異なる矩形表現間で変換したりするメソッドを含んでいます。PDRectangleオブジェクトは、一部のコンテキストでは不変ですが、可変のPDF構造を表現する場合はセッターメソッドを通じて変更できます。

PDFの生成、操作、またはアクセシビリティ準拠に取り組む開発者にとって、PDRectangleは文書のレイアウトと構造を制御するために不可欠です。PDF/UA ( 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 ) などの標準に準拠したアクセシブルなPDFを作成する際、適切な矩形定義により、コンテンツ領域、注釈境界、ページ寸法が支援技術に対して正しく指定されることが保証されます。

PDRectangleの理解は、ページ境界(MediaBox、CropBox、BleedBox、TrimBox、ArtBox)の操作、フォームフィールドと注釈の配置、クリッピング領域の定義、コンテンツ配置の計算を行う際に重要です。矩形定義が不適切だと、コンテンツが可視領域外に表示されたり、フォームフィールドが不適切に配置されたり、Tagged PDF ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) においてアクセシビリティツールが文書構造を誤って解釈したりする可能性があります。

PDRectangleは、PDFの座標系内で動作します。この座標系では、測定単位はポイント(1インチの1/72)であり、座標原点はコンテキストに依存します。PDRectangleを作成する際、開発者は次のいずれかの方法を使用できます。

1. 定義済み定数の使用: PDRectangle.A4、PDRectangle.LETTERなどにより、標準ページ寸法が提供されます
2. 座標からの構築: 左下のx、y座標と幅、高さの値を指定します
3. 配列からの作成: 基礎となるPDF構造から4つの座標値を含むCOSArrayを渡します

このクラスは、getWidth()、getHeight()、getLowerLeftX()、getLowerLeftY()、getUpperRightX()、getUpperRightY()などのゲッターメソッドを提供し、矩形プロパティにアクセスできます。ページオブジェクト(PDPage)を操作する場合、PDRectangleはMediaBox(物理的なページサイズ)を定義し、オプションでページの表示または印刷方法を制御する他のボックスも定義します。

PDRectangleは、既存のPDF構造を操作する際に特に重要です。これは、PDFファイル形式内で矩形が数値の配列として格納される基礎のCOS(Carousel Object Structure)レイヤーへの高レベルインターフェースを提供するためです。

• PDPage – PDF文書内の単一ページを表し、ページ境界を定義するためにPDRectangleを使用します
• MediaBox – 物理的なページサイズを指定するPDRectangleによって定義されるPDFページ境界
• COSArray – PDRectangleの基礎となる実際の数値配列データを格納する低レベルのPDFBoxクラス
• PDAnnotation – ページ上の位置とサイズを定義するためにPDRectangleを使用するPDF注釈オブジェクト
• Coordinate System(座標系) – PDRectangleの座標が定義される数学的空間で、通常は原点が左下にあります