OCProperties

OCPropertiesは、PDF文書のCatalogディクショナリ内のエントリであり、文書内のオプショナルコンテンツ（レイヤー）の設定とプロパティを定義します ( 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全体でどのように整理、表示、管理されるかを制御します。OCPropertiesが存在する場合、文書にはユーザー設定、表示コンテキスト、またはアプリケーション設定に基づいて選択的に表示または非表示にできる、複数のバージョンまたはビューのコンテンツを含めることができます。

OCPropertiesは、文書のCatalog内に配置されるディクショナリオブジェクトであり、PDFにおけるすべてのオプショナルコンテンツ機能の中心的な制御ポイントとして機能します。このディクショナリには3つの主要コンポーネントが含まれます：OCGs配列（文書内のすべてのオプショナルコンテンツグループをリスト化）、Dエントリ（デフォルトのオプショナルコンテンツ設定ディクショナリ）、およびオプションでConfigs配列（代替設定）です。他のフォーマットにおける単純なレイヤー実装とは異なり、OCPropertiesは、どのコンテンツグループが存在するかだけでなく、それらがユーザーにどのように提示されるべきか、初期の表示状態、階層的な関係、および使用状況に基づく表示ルールを定義する包括的なフレームワークを提供します。OCPropertiesエントリはPDF文書において完全にオプションです。その不在は、単に文書がオプショナルコンテンツ機能を含まないことを意味します。

PDF生成、操作、またはビューアアプリケーションを開発する開発者にとって、レイヤー機能を実装したり、条件付きコンテンツ表示を持つ文書を作成したりする際には、OCPropertiesの理解が不可欠です。これは、複数の詳細レベルを持つ技術文書、異なる言語版を切り替えられる多言語文書、またはユーザー入力に基づいてセクションを表示または非表示にするフォームを生成する必要があるアプリケーションを構築する際に特に重要になります。適切に設定されたOCPropertiesは、レイヤー化されたコンテンツが異なるPDFビューアやプラットフォーム間で一貫して動作することを保証し、混乱や情報の欠落につながる可能性のあるコンテンツ表示の問題を防ぎます。さらに、アクセシブルなPDFを扱う際には、開発者はオプショナルコンテンツが文書構造とアクセシビリティ機能を妨げないようにする必要があります。スクリーンリーダーや支援技術は、オプショナルコンテンツを適切に処理する必要があるためです。

OCPropertiesディクショナリは、オプショナルコンテンツグループをその表示プロパティと動作にリンクする階層的な設定システムとして機能します。最上位レベルでは、OCGs配列が文書内のどこかで使用されるすべてのOptional Content Groups（OCG）を登録し、コンテンツマーキングの有効な参照として確立します。次に、D（デフォルト）設定ディクショナリが、これらのグループがどのように提示されるべきかを定義します。これには、名前、初期のON/OFF状態、およびOrder配列を通じた組織構造が含まれ、ビューアインターフェースにレイヤーがどのように表示されるかが決定されます。RBGroups（ラジオボタングループ）エントリは、一度に1つのメンバーのみが表示可能な相互排他的なグループを指定できます。さらに、各OCG内のUsageディクショナリは、意図された使用コンテキスト（View、Print、Exportなど）を指定でき、ビューアが現在の操作に基づいて自動的に表示を調整できるようにします。PDFプロセッサがOCGを参照する/OCエントリでマークされたコンテンツに遭遇すると、現在の設定状態をチェックして、そのコンテンツをレンダリングすべきかどうかを判断し、複数のファイルバージョンを必要とせずに動的な文書動作を作成します。

• Optional Content Group（OCG） – 独立して表示を制御できる個別のレイヤーまたはコンテンツグループ
• Catalog – PDF文書の論理構造のルートオブジェクトで、主要な文書コンポーネントへの参照を含む
• Content Stream – PDFページ上の視覚的コンテンツを記述するオペレータとオペランドのシーケンス
• Marked Content – コンテンツをプロパティやメタデータと関連付けるコンテンツストリーム内のタグ付きセクション
• Configuration Dictionary – オプショナルコンテンツグループの特定の状態とプロパティのセットを定義するディクショナリ