PDTransition

PDTransitionは、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 ) で規定されているように、プレゼンテーションモード中にページ間を移動する際に発生する視覚効果を定義します。PDTransitionを使用することで、開発者はPDFページに関連付けられた遷移辞書をプログラム的に読み取り、作成、変更でき、PDFビューア内でスライドショー形式のプレゼンテーションを制御できます。

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 ) で定義されているPDF遷移辞書構造をカプセル化したJavaクラスです。このクラスは、遷移スタイル（ディゾルブ、ワイプ、グリッターなど）、持続時間、方向、モーションパラメータといった遷移プロパティにアクセスし操作するためのオブジェクト指向インターフェースを提供します。基本的なページナビゲーションとは異なり、PDTransitionは特に視覚的なプレゼンテーション層、つまりフルスクリーンモードやプレゼンテーションモードでページ間を移動する際にコンテンツがどのように表示されるかを扱います。このクラスはPDFBoxのPDModelパッケージの一部であり、低レベルのPDF構文を開発者にとって使いやすいJavaオブジェクトに抽象化します。これは、PDFのプリミティブオブジェクトを直接扱う低レベルのCOS（Carousel Object System）層とは区別されます。

PDFプレゼンテーションツール、スライドショーアプリケーション、またはプレゼンテーション機能を持つドキュメントビューアを構築する開発者にとって、PDTransitionは魅力的な視覚体験を作成するための必須機能を提供します。このクラスにより、JavaアプリケーションはPDF辞書を手動で構築することなく、プロフェッショナルなプレゼンテーション効果を持つPDFを生成でき、実装の複雑さと潜在的なエラーを削減します。PDTransitionの理解は、教育ソフトウェア、ビジネスプレゼンテーションツール、または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 ) などの標準に準拠して慎重に実装することが重要であり、アクセシビリティの観点からも意義があります。

PDTransitionは、PDF仕様で定義された遷移パラメータを含むCOSDictionaryオブジェクトをラップすることで機能します。開発者は通常、PDPageオブジェクトの遷移メソッドを通じてPDTransitionインスタンスを作成または取得します。このクラスは、スタイル（Split、Blinds、Box、Wipe、Dissolve、Glitterなど）、秒単位の持続時間、該当するスタイルの次元（水平または垂直）、モーション方向（内向きまたは外向き）、方向角度などの遷移プロパティに対するgetterおよびsetterメソッドを提供します。遷移効果を含む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 ) に従ってオプションであり、明示的な遷移を持たないページはビューアのデフォルト動作を使用します。PDTransitionは、Javaメソッド呼び出しと基礎となるPDF構文間の変換を処理し、値を検証し、COSDictionaryのライフサイクルを管理して適切なPDF構造を保証します。

• PDPage – PDF文書内の単一ページを表すPDFBoxクラスで、PDTransitionを含むことができます
• PDModel – PDF文書構造を扱うためのApache PDFBoxの高レベルAPIパッケージ
• COSDictionary – PDTransitionがラップするPDF辞書オブジェクトを表す低レベルのPDFBoxクラス
• Page Navigation – PDF文書内のページ間を移動するプロセスで、遷移効果を伴う場合があります
• Presentation Mode – PDFリーダーのフルスクリーン表示モードで、通常はページ遷移効果が表示されます