PDTransitionStyle

PDTransitionStyleは、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 ) で定義されているように、プレゼンテーションモードでページ間を移動する際に発生する視覚的な遷移効果を読み取り、変更するためのメソッドを提供します。ページ遷移は、PDFスライドショーやプレゼンテーションにおいて、あるページから別のページへ移動する際に滑らかな視覚効果を生成するために一般的に使用されます。

PDTransitionStyleは、Apache PDFBoxにおける高レベルラッパークラスで、PDFページオブジェクトに含まれる/Trans辞書エントリをカプセル化します。この辞書は、プレゼンテーション中にページが表示される際に適用されるべき遷移効果を定義します。このクラスは、遷移スタイル(ディゾルブ、ワイプ、スプリットなど)、継続時間、次元、動作方向、スケールといった遷移プロパティのgetterおよびsetterメソッドを提供します。低レベルのCOSDictionary操作とは異なり、PDTransitionStyleは、これらの遷移パラメータを扱うための型安全で開発者フレンドリーなメソッドを提供します。このクラスは、 ( 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ビューア、またはドキュメント生成ツールを開発する開発者にとって、PDTransitionStyleは、基盤となるPDF辞書構造を手動で構築することなく、魅力的なページ遷移を実装するための標準化された方法を提供します。この抽象化レイヤーは、PDFプレゼンテーション機能の実装の複雑さを軽減し、PDF仕様への準拠を保証します。プレゼンテーションをPDF形式にエクスポートするアプリケーションを構築する際、PDTransitionStyleを理解することで、開発者はスライドショーソフトウェアでユーザーが期待する遷移効果を保持できるようになります。さらに、アクセシビリティの観点から、開発者はユーザーが遷移を無効化または変更できるようにする必要がある場合があり、PDTransitionStyleを通じたこれらのプロパティへのプログラマティックなアクセスは、包括的なPDFアプリケーションを作成する上で不可欠です。

PDTransitionStyleは、PDF構造内の遷移辞書を表すCOSDictionaryオブジェクトをラップすることで動作します。PDPageオブジェクトで遷移が有効になっている場合、PDTransitionStyleクラスは、ページのgetTransition()メソッドを使用して取得するか、setTransition()を使用して設定できます。このクラスは、STYLE_SPLIT、STYLE_BLINDS、STYLE_DISSOLVEなどの値を受け取るsetStyle()を通じて遷移タイプを設定するメソッドを提供します。開発者は、setDuration()を使用して秒単位で遷移継続時間を設定し、setDimension()およびsetMotion()でモーションベースの遷移の方向を制御し、スケールやフライ方向などの追加パラメータを指定できます。PDFが保存されると、PDFBoxは、 ( 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 ) で規定されているように、これらのJavaオブジェクトプロパティをPDFファイル構造内の適切な辞書エントリにシリアライズします。プレゼンテーションモードをサポートするPDFビューアは、これらの遷移辞書を読み取り、ページナビゲーション中に適切な視覚効果をレンダリングします。

• PDPage – PDFドキュメント内の単一ページを表し、遷移スタイルを含むことができます
• PDModel – PDF文書構造を扱うためのApache PDFBoxの高レベルAPIレイヤー
• COSDictionary – PDTransitionStyleがラップするPDF辞書オブジェクトを表す低レベルPDFBoxクラス
• PDPageDisplay – PDFビューアでのページ表示方法を制御します
• PDDocumentCatalog – プレゼンテーションモード設定を含む可能性のあるPDFドキュメントメタデータのトップレベルコンテナ