PDPropBuildは、Apache PDFBoxライブラリのPDModel APIに含まれるJavaクラスで、PDF文書内のプロパティビルド辞書を表現および操作します。これらの辞書は、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
)
で定義)。PDPropBuildは、PDFオブジェクトに関連付けられたビルドプロパティの読み取りと書き込みへのプログラマティックなアクセスを開発者に提供し、PDFワークフロー内でのバージョン追跡とアプリケーション識別を可能にします。
PDPropBuildは、Apache PDFBoxにおけるPDF「prop_build」辞書構造をカプセル化した高レベルラッパークラスです。この辞書タイプは、特に署名辞書やその他のメタデータ構造など、さまざまなPDFコンテキストで使用され、特定のPDF要素を作成または処理したソフトウェアアプリケーションを文書化します。このクラスは、アプリケーション名、バージョン情報、オペレーティングシステムの詳細、リビジョン番号などのビルドプロパティにアクセスするためのgetterおよびsetterメソッドを提供します。COS(Carousel Object System)オブジェクトを直接操作する低レベルのPDFBoxクラスとは異なり、PDPropBuildは基盤となる辞書操作を抽象化し、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
)
で定義された標準キーに対応する型安全なJavaメソッドを提供します。
PDPropBuildDataDictは、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
)
で定義されているように、デジタル署名の作成または変更に使用されたソフトウェアアプリケーションと環境に関するメタデータを読み取りおよび変更するためのプログラマティックなアクセスを提供します。これは、基礎となるCOS(Carousel Object Structure)レイヤーのラッパーとして機能し、署名ビルドプロパティを操作するための型安全なメソッドを提供します。
PDPropBuildDataDictは、Apache PDFBoxにおける特殊な辞書クラスで、PDF署名辞書内に存在する/Prop_Buildエントリをカプセル化します。この辞書には、デジタル署名の適用時に使用されたハードウェアおよびソフトウェア環境に関する情報が含まれており、アプリケーション名、バージョン、オペレーティングシステム、使用されたPDFライブラリの詳細などが記録されます。このクラスは、PDFBoxの標準的な辞書ラッパーパターンを拡張し、低レベルのCOSオブジェクト操作を抽象化するgetterおよびsetterメソッドを提供します。COSDictionaryのような汎用辞書クラスとは異なり、PDPropBuildDataDictは
(
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標準への適合性を保証します。
PDPropertyListは、Apache PDFBoxのPDModel APIに含まれる高レベルJavaクラスであり、
(
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文書の基本構造をプログラムから読み取り、変更するための機能を開発者に提供します。このクラスは、低レベルのCOS(Carousel Object Structure)レイヤーを直接操作することなく、ページ、リソース、注釈、フォームフィールドなどのPDF要素を扱えるようにする、オブジェクト指向レイヤーの一部として機能します。PDPropertyListは、Javaアプリケーションと、PDF文書を構成する複雑な階層構造との橋渡し役を担います。
PDPropertyListは、Apache PDFBoxのPDModelパッケージ内の基礎クラスであり、様々なリスト形式のPDF構造をオブジェクト指向的に表現します。PDFのネイティブなデータ構造を直接扱う低レベルのCOSArrayやCOSDictionaryクラスとは異なり、PDPropertyListはPDFオブジェクトのコレクションを操作するための型安全で開発者に優しいインターフェースを提供します。このクラスは通常、ページツリー、注釈配列、フォームフィールド階層など、特定の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
)
で定められた構造要件への準拠を維持し、PDF構造への変更が仕様に従って有効であることを保証します。
PDPushButtonは、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
)
で定義されたインタラクティブフォーム要素であり、クリックされるとフォームデータの送信、フィールドのリセット、JavaScriptの実行などのアクションをトリガーします。このクラスは、開発者がPDFフォーム内でプッシュボタンのプロパティをプログラムで作成、読み取り、変更するためのメソッドを提供します。
PDPushButtonは、Apache PDFBox内の具象実装クラスで、インタラクティブフォームフィールド階層を拡張し、プッシュボタンウィジェットを専門的に処理します。ユーザー入力を収集または保存するテキストフィールドやチェックボックスとは異なり、プッシュボタンはアクション指向のコントロールで、アクティブ化されるとコマンドを実行します。
(
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フォームのコンテキストでは、プッシュボタンはボタンフィールドタイプ(フィールドタイプ「Btn」)に属しますが、ラジオボタンやチェックボックスとは異なり、永続的な値の状態を保持しません。プッシュボタンは、アクションをトリガーするためだけに存在します。PDPushButtonクラスは、プッシュボタンフィールドの低レベルディクショナリ構造をカプセル化し、PDF構文を直接処理することなく、ボタンの外観、アクション、動作プロパティを操作するための開発者フレンドリーなインターフェースを提供します。
PDRadioButtonは、Apache PDFBoxの高レベルPDModel APIにおいて、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
)
で定義されているインタラクティブなフォーム要素であり、相互排他的な選択肢グループから単一のオプションをユーザーが選択できるようにします。このクラスは、開発者がPDF文書内のラジオボタンフォームフィールドをプログラム的に読み取り、作成、変更するためのメソッドを提供します。
PDRadioButtonは、PDFBoxのフォームフィールド階層を拡張してラジオボタンウィジェットを専門的に扱う特化されたフォームフィールドクラスです。複数のオプションを独立して選択できるチェックボックスとは異なり、ラジオボタンは相互排他性を強制します—ラジオボタングループ内では常に1つのボタンのみを選択できます。このクラスは、基盤となるPDFディクショナリ構造をカプセル化し、選択された値、利用可能なオプション、外観状態、ウィジェットアノテーションなどのプロパティを操作するためのJavaフレンドリーなAPIを提供します。PDRadioButtonは、
(
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
)
で定義されているAcroForm(インタラクティブフォーム)構造と連携して動作し、これはPDF文書内に入力可能なフォームを作成するための標準メカニズムです。
PDRangeは、Apache PDFBoxの高レベルPDModel APIに含まれるクラスで、開発者が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
)
などの標準化された仕様に準拠していますが、PDFBoxは低レベルのPDF構文を直接扱う複雑さを抽象化し、オブジェクト指向のJavaクラスを提供します。PDRangeは特に、PDFドキュメント内の範囲ベースの構造やコレクションを表現し、開発者が生のPDFストリームデータを扱うことなくドキュメント要素を操作できるようにします。
PDRangeは、PDFフォーマット仕様の上に高レベルの抽象化レイヤーを実装するApache PDFBoxのPDModelパッケージの一部です。
(
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操作とは異なり、PDRangeや類似のPDModelクラスは、PDFドキュメント構造に対応するJavaオブジェクトを提供します。「PD」というプレフィックスは、PDFBoxの命名規則で「Portable Document」モデルクラスを示しており、ページ、注釈、フォーム、フォント、リソースなどのPDFエンティティをカプセル化します。PDRangeは特に範囲ベースのコレクションや値の配列を扱い、PDF仕様への準拠を維持しながら、これらの構造にアクセス、変更、検証するためのメソッドを提供します。
PDRectangleは、Apache PDFBoxの高レベルPDModel APIにおけるコアクラスで、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
)
に従って、ページ境界、メディアボックス、クロップボックス、注釈領域などの様々なPDF要素の座標と寸法を定義します。PDRectangleは、原点(0,0)が通常ページの左下隅に位置するPDF座標空間を使用して、矩形のプロパティを作成、変更、照会するためのメソッドを提供します。
PDRectangleは、PDF文書内の矩形の幾何学的プロパティをカプセル化するJavaクラスです。4つの座標値(左下x、左下y、右上x、右上y)を格納するか、あるいはx、y、幅、高さとして表現します。汎用のJava矩形クラス(java.awt.Rectangleなど)とは異なり、PDRectangleは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
)
で規定された矩形定義に準拠しています。
PDRectlinearMeasureDictionary は、Apache PDFBox ライブラリのクラスで、
(
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
)
で定義されている rectilinear measurement dictionary(直交計測辞書)を表す特殊な構造です。この高レベル PDModel API クラスにより、開発者は PDF ドキュメント内で正確な計測を行う注釈をプログラムで作成、読み取り、変更することができます。これらの計測注釈は、縮尺、距離、面積、角度の計算を PDF ドキュメント内に直接表示します。このような計測ツールは、正確な寸法情報が重要となる技術図面、建築図面、エンジニアリング図、地理空間ドキュメントなどで一般的に使用されています。
PDRectlinearMeasureDictionary は、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
)
で規定されている rectilinear measure dictionary(直交計測辞書)のプロパティと動作をカプセル化する Java クラスです。一般的な注釈辞書とは異なり、rectilinear measure dictionary は直交軸(水平および垂直)に沿った計測を専門的に扱うため、標準的な直交座標系を持つドキュメントにおける距離、周囲長、面積の表現に最適です。このクラスは、縮尺比率、単位ラベル、数値フォーマット、座標系などの計測固有のプロパティに対するゲッターおよびセッターメソッドを提供します。ポリゴン計測などの他の計測タイプとの違いは、任意の多角形形状ではなく、rectilinear パス(ページ軸に平行な直線に沿った計測)に計算を制限している点です。
PDRenderingModeは、Apache PDFBox Javaライブラリにおける列挙型で、PDFページを画像に変換したり、PDF内容を画面に表示したりする際のレンダリング方法を制御します。この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ビジュアル内容の解釈と表示方法に影響を与えます。
PDRenderingModeは、Apache PDFBox内のJava列挙型クラスで、PDF内容をレンダリングするための異なる戦略を定義します。この列挙型は、レンダリングプロセス中にPDFページのどの要素を含めるかを決定する複数の定数を提供します。一般的な値には、すべての内容をレンダリングする、ベクトルグラフィックスのみをレンダリングする、画像、テキスト、注釈などの特定の要素タイプを選択的に含めるまたは除外するなどがあります。PDF仕様で定義された低レベルのPDF演算子とは異なり、PDRenderingModeはPDFBox実装に固有のもので、レンダリングパイプラインを制御するための高レベルの抽象化を提供します。これは、
(
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レンダリングインテントや色管理設定とは異なります。
PDResourcesは、Apache PDFBox PDModel APIにおける高レベルのJavaクラスで、PDFページまたはフォームXObjectのリソース辞書へのプログラマティックなアクセスを提供します。この辞書には、
(
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文書をプログラムで操作する際に、これらのリソースを読み取り、変更、管理できます。PDResourcesの理解は、コンテンツ抽出、PDF操作、アクセシビリティ修正などのタスクに不可欠です。
PDResourcesは、PDFリソース辞書構造を表すApache PDFBoxのラッパークラスです。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
)
において、リソース辞書は、コンテンツストリームが名前付き参照を通じて参照するすべての外部リソースをカタログ化する、必須またはオプションのコンポーネント(コンテキストに依存)です。これらのリソースには、フォント(テキスト操作で参照される)、画像やフォームなどのXObject、ExtGStateグラフィックス状態パラメータ、色空間、パターン、シェーディング辞書が含まれます。