PDTransitionMotion
PDTransitionMotionは、PDFドキュメントにおけるページ遷移効果の動作方向を定義するApache PDFBoxの列挙型クラスです。
PDTransitionMotionは、PDFドキュメントにおけるページ遷移効果の動作方向を定義するApache PDFBoxの列挙型クラスです。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 ) で規定されている遷移動作パラメータに対応しています。このクラスにより、開発者はPDFをプレゼンテーションモードで表示する際のページ間の視覚的遷移の表現方法を制御できます。
PDTransitionMotionは、Apache PDFBoxにおけるJava列挙型で、PDF仕様で定義されている特定のページ遷移スタイル、具体的にはSplit（分割）およびBox（ボックス）遷移の動作方向を表します。この列挙型は2つの定数を提供します：INWARD（動作がページの中心に向かって進む）とOUTWARD（動作が中心から外側のエッジに向かって進む）です。このクラスはPDTransitionクラスと連携して動作し、PDTransitionクラスは ( 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 ) で定義されているスタイル、継続時間、方向、動作パラメータなど、ページ遷移効果のすべての側面を管理します。
PDTransitionMotion列挙型は、関連する遷移パラメータであるPDTransitionDirection（水平/垂直方向を制御）とは異なり、視覚効果がページの中心に対して内向きまたは外向きに動くかを具体的に制御します。すべての遷移スタイルが動作パラメータを使用するわけではなく、PDF仕様ではSplitとBoxの遷移のみがこのプロパティを参照します。
PDTransitionMotionの理解は、プレゼンテーションスタイルのPDFや、ページ間の洗練された視覚的遷移を必要とするインタラクティブなドキュメントを作成する開発者にとって重要です。Apache PDFBoxを使用してPDF生成ツール、ドキュメントビューア、またはプレゼンテーションアプリケーションを構築する際、このクラスはページナビゲーション中のユーザーエクスペリエンスをプログラム的に制御する手段を提供します。適切に設定された遷移により、Javaアプリケーションから生成される自動レポート、スライドショースタイルのPDF、またはトレーニング資料の専門的な外観を向上させることができます。
既存のPDFを扱う開発者にとって、PDTransitionMotionはドキュメントを操作する際に遷移効果を読み取り、保持することを可能にし、処理ワークフローを通じてプレゼンテーション特性が維持されることを保証します。これは、PDFプレゼンテーションを結合、分割、または変換する際に特に重要です。
PDTransitionMotionは、Apache PDFBoxにおけるより広範なページ遷移フレームワークの一部として機能します。PDFページオブジェクト（PDPage）が遷移辞書エントリを含む場合、PDTransitionクラスはオプションの動作パラメータを含む遷移プロパティを読み書きします。開発者は、PDTransitionオブジェクトのgetMotion()やsetMotion(PDTransitionMotion motion)などのメソッドを通じて動作方向にアクセスし、設定します。
列挙値は、PDF仕様で定義された値に直接マッピングされます：
- INWARD：視覚効果がエッジからページの中心に向かって移動します（PDF辞書では"I"としてエンコード）
- OUTWARD：視覚効果が中心からエッジに向かって移動します（PDF辞書では"O"としてエンコード）
プログラム的に遷移を作成する場合、開発者はPDTransitionオブジェクトをインスタンス化し、そのスタイルをSplitまたはBoxに設定してから、PDTransitionMotion定数を使用して動作を設定します。その後、遷移はPDPageオブジェクトの辞書に添付されます。遷移をサポートするPDFビューアは、プレゼンテーションモードでそのページにナビゲートする際に指定された動作効果をレンダリングします。
- PDTransition – ページ遷移効果辞書全体を表すApache PDFBoxクラス
- PDTransitionDirection – 遷移効果の水平または垂直方向を定義する列挙型
- PDTransitionStyle – 遷移の視覚スタイル（Split、Box、Blindsなど）を定義する列挙型
- PDPage – PDFドキュメント内の単一ページを表すApache PDFBoxクラス
- Page Transition（ページ遷移） – プレゼンテーションモードでページ間をナビゲートする際に表示される視覚効果
- (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