PDAnnotationSquareCircle

PDAnnotationSquareCircleは、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ページに幾何学的図形を追加できるようにします。このクラスは、正方形と円形の両方のアノテーションプロパティをプログラム的に作成、読み取り、変更するためのメソッドを提供します。

PDAnnotationSquareCircleは、Apache PDFBox内の高レベルJavaクラスで、関連する2つのアノテーションサブタイプである正方形アノテーションと円形アノテーションをサポートします。両方のアノテーションタイプは、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 ) においてマークアップアノテーションとして分類され、同じ基本構造を共有していますが、レンダリングされる形状のみが異なります。正方形アノテーションは矩形（オプションで角を丸めることも可能）として表示され、円形アノテーションはアノテーションの境界矩形内に内接する楕円として表示されます。このクラスはPDAnnotationを継承し、境界線スタイル、色、内部色、アノテーションの矩形寸法などのプロパティを操作するメソッドを提供します。テキストアノテーションやリンクアノテーションとは異なり、これらの幾何学的アノテーションは主にドキュメントのマークアップやレビューワークフローで使用される視覚的要素です。

PDF文書処理を扱う開発者にとって、PDAnnotationSquareCircleは手動の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 ) などの標準への準拠を目的とした文書のアクセシビリティ問題に対する視覚的インジケーターなどの機能を実装できます。さらに、既存の正方形および円形アノテーションを読み取ることで、文書解析ツールはPDFファイルからレビュアーのフィードバックやマークアップ情報を抽出できます。

PDAnnotationSquareCircleは、 ( 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ファイル形式内の正方形および円形アノテーションを表す辞書構造をカプセル化することで動作します。開発者はクラスをインスタンス化し、アノテーション矩形（位置とサイズを定義）、ストローク色（境界線）、塗りつぶし色（内部）、境界線幅、境界線スタイル（実線、破線、面取りなど）などのプロパティを設定します。次に、PDPageクラスを通じて、アノテーションがページのアノテーション配列に追加されます。レンダリング時、PDFビューアはアノテーションのサブタイププロパティに基づいて矩形または楕円を描画し、指定された境界矩形内に図形を配置します。このクラスは、雲形効果の境界線、不透明度設定、アノテーションを開いたときに表示されるオプションのテキストコンテンツなどの追加機能もサポートしています。すべてのプロパティ変更は、PDFファイル内のアノテーションを表す基礎となるCOS（Carousel Object Structure）辞書と同期されます。

• PDAnnotation – Apache PDFBoxにおけるすべてのPDFアノテーションタイプの基底クラス
• PDPage – アノテーションが追加されるPDFドキュメント内の単一ページを表すクラス
• PDAnnotationMarkup – レビューおよびコメント機能をサポートするマークアップアノテーションの親クラス
• COSDictionary – PDFオブジェクトの辞書構造を表す低レベルクラス
• PDAppearanceStream – レンダリング時のアノテーションの視覚的外観を定義するクラス