PDPageFitRectangleDestination

PDPageFitRectangleDestinationは、Apache PDFBoxライブラリにおいて、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 ) で定義されている「FitR」デスティネーションタイプを実装しており、開発者がユーザーのPDF文書内のナビゲーション時にコンテンツがどのように表示されるかを正確に制御できるようにします。

PDPageFitRectangleDestinationは、Apache PDFBoxの高レベルPDModel API内の具象実装クラスであり、 ( 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 ) で指定されている「FitR」（Fit Rectangle）デスティネーション動作をカプセル化します。このデスティネーションタイプには5つのパラメータが必要です。ターゲットページへの参照と、ページの座標空間内で矩形を定義する4つの座標（left、bottom、right、top）です。

PDPageFitWidthDestination（ページ幅に合わせる）やPDPageFitHeightDestination（ページ高さに合わせる）などの他のデスティネーションタイプとは異なり、PDPageFitRectangleDestinationは、開発者がページのどの矩形領域を表示し、ビューアウィンドウに合わせて拡大するかを正確に指定できるため、ビューポートに対する最も細かい制御を提供します。指定された矩形の座標は、PDF座標系を使用します。この座標系では、原点(0,0)はページの左下隅にあります。

このクラスはPDDestination基底クラスを継承し、矩形座標とターゲットページオブジェクトを操作するためのgetterメソッドとsetterメソッドを提供します。これにより、PDF文書から既存のFitRデスティネーションを読み取ることと、プログラムで新しいデスティネーションを作成することの両方が可能になります。

インタラクティブなPDF文書を扱う開発者にとって、PDPageFitRectangleDestinationは正確なナビゲーション体験を作成するために不可欠です。このクラスは、いくつかの重要なユースケースを実現します。

アクセシビリティの向上: ( 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を作成する際、開発者はこのデスティネーションタイプを使用して、特定のコンテンツ領域にユーザーの注意を向けることができます。これにより、視覚障害や認知障害のあるユーザーが気を散らすことなく関連情報に集中できるようになります。

インタラクティブなナビゲーション: PDFレポート、ドキュメント、またはeラーニング教材を生成するアプリケーションは、PDPageFitRectangleDestinationを使用して、重要なチャート、図、またはテキストセクションに直接ズームする目次エントリ、ハイパーリンク、またはブックマークを作成でき、ユーザーエクスペリエンスを大幅に向上させることができます。

フォームフィールドナビゲーション: 複雑なPDFフォームでは、このデスティネーションタイプにより、開発者はフォームフィールド間でユーザーをスムーズに誘導でき、フィールドがフォーカスを受け取ったときに、理解を深めるために周辺のコンテキストが表示されたままになるようにします。

文書の自動化: 自動化されたPDF処理ワークフローは、文書コンテンツを分析し、重要な情報を強調表示するデスティネーションをプログラムで挿入できます。これにより、手動介入なしに生成されたPDFがよりナビゲートしやすく、ユーザーフレンドリーになります。

PDPageFitRectangleDestinationは、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リーダーがこのデスティネーションタイプに遭遇すると、次の操作を実行します。

座標の指定: このクラスは、ページの座標系内で矩形を定義する4つの座標値（left、bottom、right、top）を格納します。これらの値は、デフォルトのユーザー空間単位（通常は1インチの1/72）で測定されます。たとえば、(100, 200)から(400, 500)までの矩形は、幅300単位、高さ300単位の領域を指定します。

ページ参照: デスティネーションはPDPageオブジェクトへの参照を保持し、文書内のどのページを表示するかを識別します。これにより、文書構造全体にわたるナビゲーションが可能になります。

ビュー変換: アクティブになると、PDFビューアは、コンテンツのアスペクト比を維持しながら、指定された矩形を利用可能な表示領域内に収めるために必要なズームレベルとスクロール位置を計算します。ビューアは、矩形領域全体が表示されるように、拡大率とビューポート位置の両方を調整します。

作成と変更: 開発者はPDPageFitRectangleDestinationオブジェクトをインスタンス化し、setPage(PDPage page)、setLeft(int left)、setBottom(int bottom)、setRight(int right)、setTop(int top)などのメソッドを使用して設定します。その後、デスティネーションはPDAnnotationLinkオブジェクト、PDOutlineItemブックマークなどのインタラクティブ要素にアタッチしたり、アクションで使用したりできます。

配列表現: 内部的には、デスティネーションは[page /FitR left bottom right top]という形式のPDF配列としてシリアライズされます。ここで、「page」はページ辞書への間接参照であり、座標は矩形の境界を定義します。

• PDDestination – PDF文書内のナビゲーションターゲットを定義するすべてのデスティネーションタイプのApache PDFBoxにおける基底クラス
• PDPage – PDF文書内の単一ページを表し、デスティネーションオブジェクトのターゲットとして機能します
• PDAnnotationLink – デスティネーションを使用して文書内または文書間をナビゲートするクリック可能なハイパーリンクを作成する注釈タイプ
• PDOutlineItem – ナビゲーションのためにデスティネーションを参照できるPDFの文書アウトライン内のブックマークエントリを表します
• PDPageFitWidthDestination – ビューアウィンドウ内でページの全幅に合わせる代替デスティネーションタイプ