PDAnnotationLine

PDAnnotationLineは、Apache PDFBoxライブラリに含まれるJavaクラスで、PDF文書内の線注釈（line annotation）を表現します。線注釈は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 ) で定義されているように、両端に矢印、円、その他の図形など、さまざまな線端スタイルをオプションで設定できます。このクラスは、開発者がPDFBoxの高レベルPDModel APIを通じて、線注釈の作成、読み取り、変更をプログラムで行えるようにします。

PDAnnotationLineは、Apache PDFBoxの注釈フレームワーク内の具象実装クラスで、PDFの線注釈を専門的に扱います。このクラスはPDAnnotation基底クラスを継承し、 ( 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 ) で規定されている線注釈特有のプロパティと動作をカプセル化します。テキスト注釈や四角形注釈などの他の注釈タイプとは異なり、PDAnnotationLineは、PDFページ上の2つの座標点（始点と終点）で定義される幾何学的な線分を表現します。このクラスは、線の座標、線端スタイル（Open、Closed、Square、Circle、Diamond、OpenArrow、ClosedArrow、Butt、ROpenArrow、RClosedArrow、Slashなど）、内部色、引出線、線と共に表示できるキャプションテキストなど、線固有のプロパティに対するgetterおよびsetterメソッドを提供します。

PDF文書を扱う開発者にとって、PDAnnotationLineは、正確な視覚的インジケーター、測定値、または吹き出しを必要とするインタラクティブでマークアップされた文書を作成するために不可欠です。このクラスにより、アプリケーションは寸法注釈をプログラムで追加したり、既存のコンテンツに方向指示でマークアップしたり、レビュー担当者が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 ) などの規格への準拠をサポートします。

PDAnnotationLineは、PDF仕様の線注釈要件に準拠した辞書構造を維持することで機能します。開発者は、新しい注釈を作成するか、PDFページの注釈配列から既存の注釈を取得することで、このクラスをインスタンス化します。線は、注釈辞書の「L」エントリに格納される2組の座標ペア（x1, y1）と（x2, y2）によって定義され、これらはPDFユーザー空間座標における始点と終点を指定します。クラスは、これらの点を定義するためにsetLine(PDRectangle rect)のようなメソッドや直接的な座標setterを提供します。線端スタイルは「LE」（Line Ending）配列エントリを通じて制御され、 ( 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がレンダリングされる際、ビューアアプリケーションはこれらのプロパティを解釈して、指定された視覚特性で線注釈を描画します。このクラスは、引出線（端点からの延長線）、注釈を説明するキャプションテキスト、線が単純な線を表すか寸法測定を表すかを指定するインテントタイプなどのオプション機能もサポートします。

• PDAnnotation – Apache PDFBoxにおけるすべての注釈タイプの基底クラスで、共通の注釈プロパティと動作を提供します
• PDAnnotationSquare – 四角形注釈を表すPDFBoxクラスで、線注釈に似ていますが閉じた図形用です
• PDAnnotationPolygon – PDFページ上に複数セグメントのポリラインおよびポリゴン注釈を作成するためのクラスです
• PDAppearanceStream – 注釈の視覚的外観を管理し、PDFビューアでのレンダリング方法を定義します
• COSDictionary – PDFファイル構造内の実際の注釈データを格納する低レベルのCarousel Object System辞書です