PDThreadBead
PDThreadBeadは、Apache PDFBox PDModel APIのクラスで、PDF文書内の記事スレッド（article thread）におけるビーズ（bead）を表します。
PDThreadBeadは、Apache PDFBox PDModel APIのクラスで、PDF文書内の記事スレッド（article thread）におけるビーズ（bead）を表します。 ( 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 ) で定義されている記事スレッドは、ページをまたいで不連続に配置されたコンテンツの論理的な順序を読者が追えるようにするもので、例えば1ページ目から5ページ目、さらに8ページ目へと続く雑誌記事などに使用されます。スレッド内の各ビーズは、記事コンテンツの一部を含む特定のページ上の矩形領域を識別します。
PDThreadBeadは、PDF文書内の記事ビーズ構造へのプログラムによるアクセスを提供する高レベルの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 ) では、記事スレッドは、定義された読み順序で複数のページにわたるコンテンツ領域をリンクする一連のビーズ（ビーズ辞書で表現）で構成されます。各ビーズはページ上の矩形領域を定義し、シーケンス内の次と前のビーズへの参照、および親記事スレッドへの参照を保持します。PDThreadBeadクラスは、これらの辞書エントリをカプセル化し、ビーズの矩形座標、関連するページ、スレッドシーケンス内での位置などのビーズプロパティを読み取りおよび操作するメソッドを提供します。これは、単純なページリンクやアノテーションとは異なり、記事スレッドは物理的なページレイアウトとは独立した論理的な読み順序を特に保持します。
複雑なPDF文書を扱う開発者にとって、PDThreadBeadは、線形的なページ順序に従わないコンテンツを通る構造化されたナビゲーションパスの作成と保守を可能にします。これは、レイアウトが連続しないページにまたがる場合でも、記事、ストーリー、その他の物語的コンテンツを正しい読み順序で提示する必要があるPDFリーダーやコンテンツ管理システムを開発する際に特に重要です。PDThreadBeadの理解は、記事コンテンツを適切な順序で抽出する必要があるアプリケーション、記事追跡機能を備えたカスタムPDFビューアの実装、または雑誌、新聞、複数セクションのレポートなどの出版物向けに高度なナビゲーション構造を持つPDFを作成する場合に不可欠です。記事スレッドへのプログラム的なアクセスと変更の能力は、適切なコンテンツシーケンスがスクリーンリーダーやその他の支援技術にとって重要であるため、アクセシビリティ機能もサポートします。
PDThreadBeadは、基礎となるPDFビーズ辞書をラップし、そのプロパティにアクセスするための型付きメソッドを提供することで動作します。各ビーズには、特定のページ（Pエントリ）上のコンテンツ領域を定義する矩形（Rエントリ）と、スレッド（Tエントリ）、シーケンス内の次のビーズ（Nエントリ）、前のビーズ（Vエントリ）への参照が含まれます。PDFBoxを使用する場合、開発者は通常、完全な記事を構成するビーズのコレクションを保持するPDArticleThreadオブジェクトを通じてビーズにアクセスします。PDThreadBeadクラスは、矩形座標用のgetterおよびsetterメソッドを提供し、シーケンス内のビーズ間のナビゲーションを可能にし、記事の前方および後方の両方向のトラバースを可能にする双方向リンクを維持します。プログラム的に記事スレッドを変更または作成する場合、開発者は循環リンク構造が適切に維持されていることを確認する必要があります。最後のビーズは最初のビーズにリンクバックする必要があり、各ビーズの次/前の参照は一貫している必要があります。このクラスは、PDFBoxの高レベルオブジェクトモデルと、実際のPDFファイル形式を構成する低レベルのCOS（Carousel Object System）辞書構造との間の変換を処理します。
- PDArticleThread – 複数のビーズを含む完全な記事スレッドを表す親コンテナクラス
- PDPage – PDFページを表すクラス。各ビーズは、そのコンテンツ矩形が配置されている特定のページを参照する必要があります
- PDAnnotation – PDFページ上のインタラクティブ要素。アノテーションは必ずしも読み順序の一部ではないため、ビーズとは異なります
- PDOutlineItem – PDFの文書アウトラインのブックマークエントリ。記事スレッドと比較して代替のナビゲーションを提供します
- COSDictionary – PDThreadBeadのようなPDModelクラスの基礎となるPDF辞書オブジェクトを表す低レベルのPDFBoxクラス
- (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