Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

PDActionMovie

PDActionMovieは、Apache PDFBox PDModel APIのクラスで、PDF文書内のムービーアクションを表現します。

キーワード: pdactionmovie, PDActionMovie

概要

PDActionMovieは、Apache PDFBox PDModel APIのクラスで、PDF文書内のムービーアクションを表現します。 ( Citation: N.A., (N.A.). (). 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開発者に対して、再生操作、配置、タイミング制御などのムービーアクションプロパティをプログラムで作成、読み取り、変更するためのメソッドを提供します。

定義

PDActionMovieは、Apache PDFBoxのPDModelパッケージ内の高レベルJavaクラスで、PDFのムービーアクションタイプをカプセル化します。PDF仕様 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) では、ムービーアクションはムービー注釈を制御するインタラクティブ要素であり、PDFビューア内でユーザーがマルチメディアコンテンツを再生、一時停止、停止、または再開できるようにします。ページ移動やURL開封などの様々なアクションタイプを処理する一般的なPDActionクラスとは異なり、PDActionMovieはユーザーイベント(ボタンのクリックなど)とムービー注釈の再生との間のインタラクションを専門的に管理します。このクラスは基底クラスPDActionを拡張し、ムービー注釈への参照や操作タイプ(再生、停止、一時停止、または再開)などのムービー固有のディクショナリエントリを実装します。

重要性

マルチメディアコンテンツを含むインタラクティブなPDF文書を扱う開発者にとって、PDActionMovieは魅力的なユーザー体験を創出するための重要な機能を提供します。このクラスにより、PDFの構造を手動で操作することなく、ビデオ再生をプログラムで制御できるため、ビデオコンテンツを組み込んだ教育資料、プレゼンテーション、またはインタラクティブなドキュメントを構築する際の開発の複雑さが軽減されます。PDActionMovieの理解は、レガシーのマルチメディアPDF文書を移行する場合や、ビデオコンテンツを適切にタグ付けして制御する必要があるアクセシブルなPDFを作成する場合に特に重要です。ムービーアクションをプログラムで操作する機能により、開発者はマルチメディアリッチなPDFのバッチ処理を自動化し、異なるPDFビューア間で一貫した再生動作を確保できます。

仕組み

PDActionMovieは、ムービー注釈ディクショナリへの参照と、希望する再生アクションを指定する操作パラメータを保持することで動作します。PDActionMovieオブジェクトをインスタンス化する際、開発者は新しいムービーアクションを作成するか、PDFファイルから取得した既存のCOS(Carousel Object Structure)ディクショナリをラップすることができます。このクラスは、ムービー注釈への参照(通常はPDAnnotationMovieオブジェクト)と操作タイプのためのgetterおよびsetterメソッドを提供します。操作タイプは特定の再生コマンドに対応します。ユーザーがPDFビューアでこのアクションをトリガーすると(フォームボタンやリンクのクリックなど)、ビューアのレンダラーはPDActionMovieのプロパティを解釈し、対応するマルチメディア操作を実行します。このクラスは低レベルのPDFディクショナリ構造を処理するため、開発者は生のPDF構文ではなく、直感的なJavaオブジェクトで作業できます。PDActionMovieは、PDAnnotationPDPageなどの他のPDFBoxコンポーネントと統合し、ユーザーインタラクションからマルチメディア再生までの完全な連鎖を確立します。

関連用語

  • PDAction – ナビゲーション、URI、JavaScriptアクションを含むすべてのPDFアクションタイプの基底クラス
  • PDAnnotationMovie – PDFページ内でマルチメディアコンテンツを表示するムービー注釈を表現するクラス
  • PDAnnotation – テキスト、リンク、マルチメディア注釈を含むすべてのPDF注釈タイプの親クラス
  • COSDictionary – キーと値のペアを格納するPDFディクショナリオブジェクトを表現する低レベルPDFBoxクラス
  • PDPage – 注釈やアクションを添付できるPDF文書内の単一ページを表現するクラス

出典

(N.A.) (2020)
(N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html