PDAnnotationSquare

PDAnnotationSquareは、Apache PDFBoxライブラリにおいて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文書におけるレビューやコメントワークフローの実装によく使用されます。

PDAnnotationSquareは、Apache PDFBox内のJavaクラスで、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 ) で定義されている正方形注釈タイプを実装しています。名称に反して、この注釈タイプは正方形だけでなく、任意の比率の長方形も表現できます。このクラスはPDAnnotationMarkupクラスを拡張しており、作成日、作成者情報、返信スレッド機能など、すべてのマークアップ注釈に共通するプロパティを継承しています。

正方形注釈は、設定可能な境界線と内部色を持つ長方形を描画するために特別に設計されている点で、他の図形注釈とは異なります。円形注釈（楕円を描画）とは異なり、正方形注釈は常にページ座標系に沿った直線エッジを維持します。これらは準拠PDF閲覧ソフトがサポートすべき標準注釈タイプの一部であり、カスタムスタンプ注釈や幾何学的フォームXObjectとは区別されます。なぜなら、PDF構造内に専用の辞書エントリを持つ第一級の注釈エンティティだからです。

PDF文書を扱う開発者にとって、PDAnnotationSquareは、基礎となるコンテンツを変更することなく、文書に視覚的なマークアップをプログラム的に追加する手段を提供します。これは、文書レビュー、コラボレーション機能、または元の文書の整合性を保ちながら特定のページ領域を視覚的に強調する必要があるアプリケーションにとって極めて重要です。

Apache PDFBoxを通じて正方形注釈を作成・操作する機能により、開発者は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 ) であるため、PDAnnotationSquareで作成された文書は、異なるPDF閲覧ソフトやプラットフォーム間で互換性を維持します。この相互運用性は、クロスプラットフォームソリューションを構築する場合や、障害を持つユーザーが文書にアクセスする必要がある場合に特に重要です。なぜなら、適切に構造化された注釈は、Tagged 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 ) と組み合わせることで文書のアクセシビリティに貢献できるからです。

PDAnnotationSquareは、PDFの注釈配列内にサブタイプ「Square」の辞書エントリを作成することで機能します。開発者はクラスをインスタンス化し、位置（注釈の境界を定義する長方形を通じて）、境界線スタイル、色、不透明度などのプロパティを設定します。長方形座標はPDF座標系を使用し、原点(0,0)は通常ページの左下隅にあります。

設定可能な主要プロパティには、内部色（長方形を塗りつぶす）、ストローク色（境界線用）、境界線の幅とスタイル（実線、破線、面取りなど）、そしてクラウドスタイルの境界線などの効果を作成できる長方形差分配列があります。注釈の外観は、アピアランスストリームを通じてカスタマイズでき、開発者は注釈のレンダリング方法を正確に定義できます。

正方形注釈を含むPDFが開かれると、閲覧アプリケーションは注釈辞書を読み取り、これらのプロパティに基づいて正方形をレンダリングします。注釈はページコンテンツストリームとは別に保持されるため、基礎となる文書コンテンツを変更することなく、オン・オフの切り替え、変更、または削除が可能です。Apache PDFBoxは低レベルの辞書操作を処理するため、開発者はPDF構文を直接操作するのではなく、直感的なgetterおよびsetterメソッドで作業できます。

• PDAnnotation – Apache PDFBoxにおけるすべての注釈タイプの基底クラス
• PDAnnotationMarkup – 正方形、円形、ポリゴンなどのマークアップ注釈の親クラス
• PDAnnotationCircle – 円形または楕円形の注釈を作成するための関連クラス
• PDAnnotationTextMarkup – テキストの強調表示、下線、取り消し線注釈のためのクラス
• Tagged PDF – 論理的な文書構造を含むPDF構造。注釈を使用する際のアクセシビリティに重要