PDAppearanceDictionary

PDAppearanceDictionaryは、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要素が画面上や印刷時にどのようにレンダリングされるかを制御するアピアランスストリームの読み取り、作成、変更が可能になります。

PDAppearanceDictionaryは、PDF仕様で定義されているアピアランス辞書構造を表すJavaクラスラッパーです。PDF文書において、アピアランス辞書には、アノテーションやフォームフィールドが異なる条件下（通常状態、ロールオーバー状態、ダウン状態）でどのように表示されるべきかを定義する1つ以上のアピアランスストリームが含まれます。PDAppearanceDictionaryクラスは、PDFBoxの低レベルCOS（Carousel Object System）レイヤーを抽象化し、PDF構文を直接扱うことなく、これらのアピアランスストリームにアクセスして操作するための型安全なメソッドを提供します。直接的なCOS辞書操作とは異なり、このクラスはアピアランス関連の操作専用に設計された便利なメソッドを提供し、 ( 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を扱う開発者にとって、アピアランス辞書を理解し適切に管理することは、フォームフィールドやアノテーションが異なる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 ) などの規格に基づくアクセシビリティが求められるシナリオでは問題となります。PDAppearanceDictionaryクラスは、これらのアピアランスストリームを作成・維持する複雑な作業を簡素化し、準拠していない、あるいは適切にレンダリングされないPDFを生成してしまうエラーの可能性を低減します。これは、動的フォームの生成、カスタムアノテーションの追加、または異なるプラットフォームで文書を表示する際にインタラクティブ要素の視覚的整合性を確保する場合に特に重要です。

PDAppearanceDictionaryクラスは、Javaアプリケーションと基盤となるPDF構造との仲介役として機能します。アノテーションやフォームフィールドからアピアランス辞書を取得すると、PDFBoxは対応するCOS辞書をラップするPDAppearanceDictionaryオブジェクトをインスタンス化します。このクラスは、異なるインタラクション状態に対応する3つの主要なアピアランスストリーム（通常（N）、ロールオーバー（R）、ダウン（D））にアクセスするメソッドを提供します。各アピアランスストリームは、視覚的コンテンツをレンダリングするグラフィックスオペレーターを含むPDAppearanceStreamオブジェクト自体によって表されます。開発者は、PDAppearanceDictionaryを使用して、検査のために既存のアピアランスストリームを取得したり、カスタムビジュアライゼーション用の新しいストリームを作成したり、要素の表示方法を更新するために既存のストリームを変更したりできます。このクラスは、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 ) で定義されているように、異なるアノテーション状態に対応する複数のアピアランスストリームを含むサブ辞書のサポートを含め、アピアランス辞書構造の複雑さを処理します。

• PDAnnotation – 視覚的レンダリングにアピアランス辞書を使用するPDFアノテーションを表す基底クラス
• PDAppearanceStream – レンダリング用のグラフィックスオペレーターを含む個別のアピアランスストリームを表す
• COSDictionary – PDAppearanceDictionaryがラップする低レベルのCarousel Object System辞書
• PDFormXObject – アピアランスストリーム内で再利用可能なコンテンツを定義するために使用できるフォームXObject
• PDResources – アピアランスストリームによって参照されるリソース（フォント、画像、グラフィックス状態）を含む