PDOptionalContentProperties.BaseState

PDOptionalContentProperties.BaseStateは、Apache PDFBoxライブラリにおけるJavaクラスで、PDFドキュメント内のオプショナルコンテンツ（レイヤー）のベース状態プロパティを表します。このクラスは、PDFBoxのPDModel APIの一部であり、 ( 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構造への高レベルなアクセスを提供します。BaseStateプロパティは、PDFが最初に開かれたとき、または他の状態情報が利用できない場合に、オプショナルコンテンツグループのデフォルトの可視性状態（ONまたはOFF）を決定します。

PDOptionalContentProperties.BaseStateは、Apache PDFBoxのオプショナルコンテンツフレームワーク内の特定のプロパティクラスで、PDFレイヤーの初期可視性状態を管理します。PDFドキュメントにおいて、オプショナルコンテンツグループ（OCG）は、コンテンツの一部を選択的に表示または非表示にすることを可能にし、BaseStateプロパティは、明示的な状態情報が提供されていない場合のデフォルトの可視性を定義します。このクラスは、個別のオプショナルコンテンツグループ設定とは異なり、特定のレイヤー状態を制御するのではなく、ドキュメント全体のデフォルトを確立します。BaseStateには通常、3つの可能な値があります：ON（すべてのレイヤーがデフォルトで表示）、OFF（すべてのレイヤーがデフォルトで非表示）、またはUNCHANGED（以前の構成からの状態を保持）。このプロパティは、 ( 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ドキュメントを扱う開発者にとって、BaseStateを理解し適切に管理することは、PDFが異なるビューアーやコンテキストで開かれたときに予測可能な動作を保証するために重要です。このプロパティは、技術文書、CAD図面、または特定のレイヤーがデフォルトで表示または非表示にされるべき多言語ドキュメントのために複雑なレイヤー構造を持つPDFを作成する際に特に重要になります。BaseStateの設定が正しくないと、ユーザーがドキュメントを最初に開いたときに予期しないコンテンツが表示されたり、重要な情報が欠落したりする可能性があります。アクセシビリティの観点から、BaseState設定を含む適切なレイヤー管理は、支援技術がドキュメント構造を正しく解釈できるようにするのに役立ち、これは ( 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アクセシビリティ標準に沿っています。PDFBoxを使用してプログラム的にPDFを操作または生成する開発者は、オプショナルコンテンツの初期表示を制御するために、このプロパティを正しく設定する必要があります。

PDOptionalContentProperties.BaseStateクラスは、PDFドキュメントのオプショナルコンテンツ構成辞書とインターフェースすることで、PDFBoxのオプショナルコンテンツ管理システム内で機能します。PDFBoxを使用してPDFが作成または変更される際、開発者はドキュメントカタログを通じてオプショナルコンテンツプロパティにアクセスし、PDOptionalContentPropertiesオブジェクトを通じてBaseStateプロパティを取得または設定します。BaseState値は、 ( 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の/D（デフォルト）構成辞書の/BaseStateエントリに格納されます。PDFビューアーがドキュメントを開くと、このBaseState値を読み取り、構成で明示的なON/OFF状態が定義されていないオプショナルコンテンツグループの初期可視性を決定します。このプロパティは、特定のグループのBaseStateをオーバーライドできるONおよびOFF配列などの他のオプショナルコンテンツ設定と連携して機能します。開発者は通常、PDOptionalContentPropertiesオブジェクトのメソッドを呼び出してBaseStateを設定し、PDFBoxはドキュメントが保存されるときに適切なPDF辞書構造にシリアル化します。

• PDOptionalContentGroup – PDFドキュメント内で、オン・オフを切り替えることができる個別のレイヤーまたはオプショナルコンテンツグループを表します
• PDOptionalContentProperties – PDFドキュメントのすべてのオプショナルコンテンツ構成設定を管理する親クラス
• PDDocumentCatalog – PDFBoxのドキュメント構造のルートオブジェクトで、オプショナルコンテンツやその他のドキュメント全体のプロパティへのアクセスを提供します
• OCG（Optional Content Group） – コンテンツを選択的に表示または印刷できるレイヤーに整理することを可能にするPDF機能
• Layer Visibility State – オプショナルコンテンツグループの現在のON/OFF状態で、ユーザーの操作後にBaseStateとは異なる場合があります