PDPageXYZDestination

PDPageXYZDestinationは、Apache PDFBoxの高レベルPDModel APIにおけるクラスで、PDF文書内のXYZ形式の移動先（destination）を表現します。この移動先タイプは、開発者がページ上の水平（X）座標と垂直（Y）座標、さらにズーム係数（Z）を含むターゲット位置を指定できるようにし、 ( 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内の特定の表示位置にユーザーを誘導する内部リンク、ブックマーク、ナビゲーション要素の作成に一般的に使用されます。

PDPageXYZDestinationは、PDF仕様で利用可能な複数の明示的な移動先形式の一つであるXYZ移動先タイプをカプセル化したJavaクラスです。ページ全体を表示するFitや、ページ幅に合わせるFitHなどの他の移動先タイプとは異なり、XYZ移動先は3つのパラメータ（左（X）座標、上（Y）座標、ズームレベル（Z））を精密に制御できます。これらのパラメータはそれぞれ明示的に設定することも、nullのままにすることもでき、未指定の値についてはPDFビューアがユーザーの現在の位置やズームレベルを維持します。このクラスはPDDestination抽象クラスを拡張しており、Apache PDFBoxアプリケーション内でページ参照と位置座標をプログラム的に操作するためのgetterおよびsetterメソッドを提供します。

PDFのナビゲーションおよびアクセシビリティ機能を扱う開発者にとって、PDPageXYZDestinationは正確なユーザーエクスペリエンスを作成するために不可欠です。文書管理システム、レポートジェネレーター、 ( 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を生成するアプリケーションを構築する際、リンクやブックマークをたどったときにユーザーがどこに到達するかを正確に制御する能力は、ユーザビリティを大幅に向上させます。これは、一般的なページ位置ではなく特定のコンテンツ要素にユーザーを誘導する必要がある構造的ナビゲーションを持つTagged PDFにおいて特に重要です。適切な移動先管理がなければ、文書内部のリンクが意図したユーザーエクスペリエンスを提供できず、複雑な文書でのナビゲーションフローが機能しなくなったり、支援技術ユーザーにアクセシビリティの問題を引き起こす可能性があります。

Apache PDFBoxでPDPageXYZDestinationインスタンスを作成する際、開発者はまずオブジェクトをインスタンス化し、次にsetterメソッドを通じてそのプロパティを設定します。setPage()メソッドは移動先を特定のPDPageオブジェクトに関連付け、setLeft()、setTop()、setZoom()メソッドはそれぞれX、Y、Zパラメータを定義します。座標はPDFユーザー空間単位（通常1/72インチ）で指定され、 ( 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またはnullに設定されている場合、PDFビューアはそのパラメータについてユーザーの現在の設定を保持します。移動先オブジェクトは、その後PDFBoxのアノテーションおよびアウトラインクラスを使用して、リンクアノテーション、アウトライン項目（ブックマーク）、またはその他のインタラクティブ要素に関連付けることができます。レンダリング時に、PDFビューアはこれらの移動先を解釈し、指定された座標とズームレベルに従ってビューポートを配置し、ユーザーに意図されたコンテンツの場所への直接的なナビゲーションを提供します。

• PDDestination – Apache PDFBoxにおけるすべてのPDF移動先タイプの抽象基底クラス
• PDPageFitDestination – ビューアウィンドウ内にページ全体を収める移動先タイプ
• PDOutlineItem – ナビゲーションのためにPDPageXYZDestinationを参照できるブックマークエントリ
• Link Annotation（リンクアノテーション） – ナビゲーションターゲットを定義するために移動先を使用するインタラクティブなPDF要素
• Explicit Destination（明示的移動先） – 名前付き移動先とは対照的に、ページと表示パラメータを直接指定する移動先を指すPDF用語