PDViewerPreferences.READING_DIRECTION

PDViewerPreferences.READING_DIRECTIONは、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 ) で規定されている右から左への言語や双方向テキストにおいて重要です。読み取り方向の設定は、ページレイアウト、ナビゲーション、およびユーザーが複数ページのドキュメントとやり取りする方法に影響を与え、文化的・言語的慣習に従ってコンテンツが表示されることを保証します。

PDViewerPreferences.READING_DIRECTIONは、Apache PDFBoxのPDViewerPreferencesクラス内のJava定数で、PDFドキュメントのビューア設定辞書内のReadingDirectionエントリに対応します。このプロパティは、L2R（左から右）、R2L（右から左）、または指定なし（デフォルト動作の継承）の3つの値を受け入れます。個々のテキスト実行や段落に適用されるテキスト方向属性とは異なり、READING_DIRECTIONはドキュメント全体の設定を行い、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ドキュメントを作成または処理する開発者にとって、適切な読み取り方向の設定は、適切なドキュメント表示とユーザーエクスペリエンスに不可欠です。この設定が適切に行われると、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 ) で概説されているアクセシビリティ基準に沿って、障害を持つユーザーに論理的にコンテンツを提示します。読み取り方向が誤って指定されている、または欠落している場合、特に2言語または多言語ドキュメントにおいて、混乱、ナビゲーションエラー、アクセシビリティの障壁につながる可能性があります。

READING_DIRECTION定数は、PDFBoxのPDDocumentおよびPDViewerPreferencesクラスを通じて、PDFドキュメント内のビューア設定を取得または設定する際に使用されます。開発者はPDDocumentインスタンスからビューア設定オブジェクトにアクセスし、この定数を使用して現在の読み取り方向を取得するか、新しい値を設定します。R2Lに設定されると、この機能をサポートする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レイヤーを使用して基礎となるPDF構造を抽象化し、開発者が生のPDF構文を直接操作するのではなく、高レベルのJavaオブジェクトで作業できるようにしています。

• PDViewerPreferences – PDFドキュメントのビューア設定と表示設定を管理するためのApache PDFBoxクラス
• PDDocument – 完全なPDFドキュメントとその操作を表すApache PDFBoxのメインクラス
• Viewer Preferences Dictionary（ビューア設定辞書） – ビューアがドキュメントをどのように表示するかを制御する設定を含むPDF構造
• BiDi（Bidirectional Text、双方向テキスト） – 同じドキュメント内で左から右と右から左のコンテンツが混在するテキストレンダリング
• Document Catalog（ドキュメントカタログ） – ドキュメントレベルのプロパティと設定を含むPDFファイル構造のルートオブジェクト