PDTransitionDimension

PDTransitionDimensionは、Apache PDFBoxのPDModel APIに含まれるJavaクラスで、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 ) の一部であり、プレゼンテーション文書においてページ変更時の視覚的なアニメーションを作成するために一般的に使用されます。

PDTransitionDimensionは、Apache PDFBox内の高レベルAPIクラスであり、PDF仕様で定義されているトランジション次元パラメータをカプセル化します。PDF文書では、ページトランジションにワイプ、スプリット、ブラインドなどの視覚効果を含めることができ、これらは水平方向または垂直方向の次元に沿って発生します。このクラスは、これらの次元プロパティを操作するためのオブジェクト指向インターフェースを提供し、通常は水平（H）または垂直（V）などの列挙値を提供します。すべてのトランジションプロパティを扱う汎用的なトランジションクラスとは異なり、PDTransitionDimensionは特定のトランジションタイプの方向的側面に特化しているため、開発者はPDF辞書エントリを手動で解析または構築することなく、トランジション効果の向きを簡単に指定および取得できます。

PDFプレゼンテーションアプリケーション、文書ビューア、またはPDFトランジションをサポートするコンテンツ管理システムを構築する開発者にとって、PDTransitionDimensionはトランジション動作を制御するための型安全で直感的な方法を提供します。この抽象化により、不正確な文字列値の使用やPDF仕様の要件の誤解など、PDF辞書を直接操作することに伴う一般的なエラーを防ぐことができます。アクセシブルな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 ) に概説されている文書構造の整合性を維持しながら、ユーザーエクスペリエンスを向上させることができます。このクラスは、自動化されたPDF生成ワークフローにおいて、一貫性のあるプロフェッショナルなページトランジションを作成するプロセスを簡素化します。

PDTransitionDimensionは、Apache PDFBoxの広範なPDPageTransitionクラス階層の一部として機能します。PDFページオブジェクトにトランジション辞書（/Transエントリ）が含まれている場合、次元パラメータは特定のトランジション効果の方向を指定します。開発者は、ページトランジションを構成する際に、通常はPDPageTransitionクラスのgetterおよびsetterメソッドを通じて、PDTransitionDimension値をインスタンス化または取得します。このクラスは内部的に、 ( 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トランジション辞書の/Dm（次元）エントリにマッピングされます。既存のPDFを読み取る際、Apache PDFBoxはトランジション辞書を解析し、次元値をPDTransitionDimensionオブジェクトに変換します。書き込み時には、このクラスが適切なPDF名前オブジェクト（通常は/Hまたは/V）に変換します。この双方向マッピングにより、開発者はJavaネイティブ型を使用しながら、トランジション効果に関するPDF仕様の要件との完全な互換性を維持できます。

• PDPageTransition – ページトランジション効果とそのプロパティを表すApache PDFBoxクラス
• PDPage – トランジション効果を含むことができるPDF文書内の単一ページを表すApache PDFBoxクラス
• PDModel – PDF文書構造を操作するためのApache PDFBoxの高レベルAPIパッケージ
• COSName – PDF辞書内の名前オブジェクトを表すApache PDFBoxの低レベルクラス
• Transition Dictionary – プレゼンテーションモード中のページトランジション方法を定義するパラメータを含むPDF構造