PDAnnotationSquiggly

PDAnnotationSquigglyは、Apache PDFBoxライブラリにおけるJavaクラスで、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 ) で定義されており、選択されたテキストの下に波状の線として表示され、スペルミスやその他のテキストの問題を示すために一般的に使用されます。開発者は、JavaアプリケーションでPDFファイルを操作する際に、このクラスを使用して波線下線アノテーションをプログラム的に作成、変更、または抽出します。

PDAnnotationSquigglyは、Apache PDFBoxのテキストマークアップアノテーション階層を拡張する具体的な実装クラスです。これは ( 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 ) で規定されているテキストマークアップアノテーションの「Squiggly」サブタイプに対応します。ハイライト、下線、取り消し線などの他のテキストマークアップアノテーションとは異なり、波線アノテーションはマークされたテキスト領域の下にギザギザまたは波状の線として描画され、直線の下線や他のマークアップスタイルと視覚的に区別されます。このクラスは、波線下線処理を受けるテキスト部分を指定する四角形領域（QuadPoints）を定義するメソッドと、色、作成者、変更日などの標準的なアノテーションプロパティを提供します。

PDF処理アプリケーションを構築する開発者にとって、PDAnnotationSquigglyは自動化された文書レビューおよび編集ワークフローを可能にします。このクラスは、スペルチェックシステム、文法検証ツール、または基礎となるコンテンツを永続的に変更することなくテキストエラーの可能性にフラグを立てる必要がある共同レビュープラットフォームを作成する際に特に価値があります。アクセシビリティ機能に取り組む開発者にとって、このアノテーションタイプを理解することは不可欠です。なぜなら、波線下線のようなテキストマークアップアノテーションは、スクリーンリーダーや支援技術が文書マークアップを正しく解釈できるように、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 ) で適切に構造化される必要があるためです。これらのアノテーションをプログラム的に追加または削除する機能により、アプリケーションは文書の整合性を維持しながらユーザーに視覚的フィードバックを提供できます。

PDAnnotationSquigglyは、波線下線でマークされるテキストを囲む矩形領域（四角形）を定義することによって動作します。インスタンスを作成する際、開発者は通常、クラスをインスタンス化し、ページ参照を設定し、すべてのマーク領域を含むアノテーション矩形を定義し、各テキスト領域を正確に識別するQuadPoints座標の配列を指定します。四角形はPDF座標空間で定義され、点は左下隅から反時計回りの順序で指定されます。PDFレンダラーは、これらの境界内のテキストの下に特徴的な波状線を描画します。アノテーションには、ポップアップノート、作成日、件名の説明などの追加メタデータを含めることができます。Tagged PDF構造 ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) では、文書のアクセシビリティを維持するために、これらのアノテーションは基礎となるコンテンツ構造と適切に関連付けられる必要があります。開発者は、PDFBoxのアノテーションフレームワークを通じてこれらのアノテーションにアクセスし操作します。通常、ページのアノテーションリストから取得するか、PDFページに追加する新しいインスタンスを作成します。

• PDAnnotation – Apache PDFBoxにおけるすべてのPDFアノテーションタイプの基底クラス
• Text Markup Annotation – ハイライト、下線、取り消し線、波線タイプを含むアノテーションのカテゴリ
• QuadPoints – マークされたテキストを囲む四角形領域を定義する座標配列
• Tagged PDF – アクセシビリティとコンテンツの再利用のためのセマンティック情報を含むPDF構造
• Apache PDFBox – PDF文書の作成と操作のためのオープンソースJavaライブラリ