PDUserPropertyは、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
)
で定義されているように、文書のアクセシビリティとセマンティック情報を向上させます。このクラスを使用することで、開発者はTagged PDF構造を扱う際に、これらのプロパティをプログラムで読み取り、操作できます。
PDUserPropertyは、Apache PDFBoxのPDModelパッケージに含まれる高レベルなJavaクラスで、PDF文書内にあるユーザープロパティ辞書構造をカプセル化します。ユーザープロパティは、Tagged 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仕様への準拠を損なうことなく、文書のセマンティクスを強化するカスタムメタデータフィールドを定義できます。
PDVariableTextは、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
)
で定義されたインタラクティブフォーム要素を表し、ユーザーがテキスト情報を入力または選択できるようにします。PDFBoxの抽象化レイヤーの一部として、PDVariableTextは、基盤となるPDF構造を直接操作することなく、テキストベースのフォームフィールドプロパティの読み取りと変更のプロセスを簡素化します。
PDVariableTextは、Apache PDFBoxの抽象クラスで、可変テキストコンテンツを表示するPDFフォームフィールドタイプの親クラスとして機能します。PDFieldクラスを拡張し、PDTextFieldやPDChoice(リストボックスやコンボボックスを含む)などのフォームフィールドに共通の機能を提供します。PDF文書内の静的テキストコンテンツとは異なり、可変テキストフィールドは、ユーザー入力を受け付けたり、動的に変化する値を表示できるインタラクティブ要素です。
このクラスは、フォームフィールド内のテキスト表示に固有のプロパティをカプセル化します。これには、フォント選択、テキストサイズ、テキストカラー、テキスト配置、複数行テキスト処理などが含まれます。PDVariableTextは、テキストコンテンツがユーザーのインタラクションやプログラムによる更新に基づいて変化することが期待されるフォームフィールドコンテキストに特化している点で、他のPDFテキストレンダリングメカニズムとは異なります。これは、テキストが通常静的でページ上に絶対位置で配置される標準的なコンテンツストリームとは異なります。
PDFフォームを扱う開発者にとって、PDVariableTextはアクセシブルでインタラクティブな文書を作成するための重要な機能を提供します。このクラスを理解することは、プログラムでフォームに記入したり、フォームデータを抽出したり、PDFフォームをゼロから作成したりする必要があるアプリケーションを構築する際に不可欠です。可変テキストプロパティの適切な設定により、フォームフィールドが異なるPDFビューアやプラットフォーム間で一貫してレンダリングされることが保証されます。
PDVectorFontは、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
)
で定義されたフォント仕様に準拠したフォントデータへのアクセスと操作を行うメソッドを提供します。
PDVectorFontは、Apache PDFBoxの高レベルPDModel API階層における抽象クラスで、主にType1フォントとTrueTypeフォントというベクターフォントタイプを扱います。ベクターフォントは、固定サイズのビットマップではなく、拡大縮小可能な幾何学的記述として文字のアウトラインを保存します。PDFBoxのアーキテクチャにおいて、PDVectorFontは基底クラスであるPDFontを拡張し、PDType1FontやPDTrueTypeFontなどの具体的なベクターフォント実装の親クラスとして機能します。このクラスは、
(
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文書内でテキストがどのようにレンダリングされるべきかを定義するフォントプログラムデータ、文字メトリクス、エンコーディング情報、グリフアウトライン定義をカプセル化します。
PDViewerPreferencesは、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ビューアアプリケーションがドキュメントをどのように表示すべきかを制御します。このクラスにより、開発者はPDFドキュメントの作成または変更時に、既存のビューア設定を読み取ったり、新しい設定を行ったりすることができます。
PDViewerPreferencesは、Apache PDFBoxのPDModel APIレイヤー内の高レベルJavaクラスで、PDFドキュメントのカタログに含まれるViewerPreferences辞書エントリをカプセル化します。この辞書には、準拠するPDFリーダーがユーザーにドキュメントをどのように提示すべきかを示唆するオプション設定が含まれています。ドキュメントコンテンツや構造要素とは異なり、ビューア設定はPDFの実際のコンテンツには影響しませんが、ブックマークを表示するか、ツールバーを非表示にするか、ページをウィンドウに合わせるか、特定のレイアウトモードでページを表示するかなど、表示特性についてビューアアプリケーションにヒントを提供します。
このクラスは、基礎となるCOS(Carousel Object Structure)辞書のラッパーとして機能し、
(
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
)
で定義されている標準のビューア設定キーに対応する型安全なgetterおよびsetterメソッドを提供します。この抽象化により、開発者は低レベルのPDF辞書オブジェクトを直接操作することなく、ビューア設定機能へのフルアクセスを維持できます。
PDViewerPreferences.BOUNDARYは、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ビューアアプリケーションでページがどのように表示、印刷、トリミングされるかを制御します。BOUNDARY列挙型は、5つの標準的なPDFページ境界を表す型安全な定数を提供します:MediaBox、CropBox、BleedBox、TrimBox、ArtBoxです。
PDViewerPreferences.BOUNDARYは、PDF仕様で定義されているページ境界ボックス定数をカプセル化するJava列挙型です。PDFドキュメントでは、異なる境界ボックスがドキュメントのレンダリングと制作ワークフローにおいて明確な目的を果たします。この列挙型は以下の標準化された識別子を提供します:
- MediaBox: 物理的なページサイズ
- CropBox: 表示または印刷時に見える領域
- BleedBox: 制作用の裁ち落とし領域を含む範囲
- TrimBox: 断裁後の意図された仕上がりページサイズ
- ArtBox: 意味のあるコンテンツ領域
この列挙型は主に、ページの表示または印刷にどの境界ボックスを使用するかを指定するビューア設定を行う際に使用されます。直接的な文字列表現とは異なり、BOUNDARY列挙型はコンパイル時の型安全性を提供し、PDFBox APIを使用する際の誤字や無効な境界ボックス名によるエラーを防ぎます。
PDViewerPreferences.DUPLEXは、Apache PDFBox PDModel APIの定数で、PDFドキュメントを両面(duplex)モードで印刷する際の動作を指定します。この設定は、
(
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ビューアーやプリンターによるドキュメントの処理方法のさまざまな側面を制御できるようにします。DUPLEX定数を使用することで、開発者はPDFドキュメントに対する優先両面印刷モードをプログラムで設定または取得できます。
PDViewerPreferences.DUPLEXは、Apache PDFBoxライブラリのPDViewerPreferencesクラス内の列挙定数で、PDFのViewerPreferences辞書内のDuplexエントリを表します。この定数は、
(
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
)
で定義されている3つの可能な値のいずれかに対応します:Simplex(片面印刷)、DuplexFlipShortEdge(短辺に沿って反転する両面印刷)、またはDuplexFlipLongEdge(長辺に沿って反転する両面印刷)です。画面表示動作を制御する他のビューアー設定とは異なり、DUPLEXは特に印刷出力の動作に影響します。この定数は、Javaコードで両面印刷設定を扱うための型安全な方法を提供し、基礎となるPDF辞書構造を開発者から抽象化します。
PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODEは、Apache PDFBoxのPDViewerPreferencesクラスに含まれる定数で、ユーザーがフルスクリーンモードを終了した際の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ビューアーの表示動作を制御できるようにします。この定数は、フルスクリーンモードから通常の表示モードへ移行する際に、どのナビゲーションパネルやページレイアウトを表示するかを決定します。
PDViewerPreferences.NON_FULL_SCREEN_PAGE_MODEは、Apache PDFBoxの高レベルPDModel API内のJava列挙型または定数値で、PDFのViewerPreferencesディクショナリ内のNonFullScreenPageModeエントリを表します。
(
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ビューアーが何を表示するかを制御します。指定可能な値には、UseNone(文書のアウトラインもサムネイル画像も表示しない)、UseOutlines(文書のアウトラインを表示)、UseThumbs(サムネイル画像を表示)、UseOC(オプションコンテンツグループパネルを表示)が含まれます。
PDViewerPreferences.PRINT_SCALINGは、Apache PDFBoxライブラリの定数で、PDF文書内のPrintScalingビューア設定を表します。この設定は、
(
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ビューアが印刷時に自動的なページスケーリングを適用するかどうかを制御します。開発者は、この設定を使用して、文書を実際のサイズで印刷するか、用紙に合わせて拡大縮小するかを指定できます。
PDViewerPreferences.PRINT_SCALINGは、Apache PDFBoxのPDModel API内のJava定数で、PDF文書のビューア設定ディクショナリ内の/PrintScalingエントリに対応します。この設定は2つの値を受け入れます:None(スケーリングを適用しないことを示す)またはAppDefault(PDFビューアアプリケーションがデフォルト動作を使用することを許可する)。Noneに設定すると、文書は自動的なページ合わせスケーリングなしで実際のサイズで印刷されます。これは、フォーム、技術図面、特定の用紙サイズ向けに設計された文書など、正確な寸法が重要な文書において特に重要です。この設定は、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
)
。
PDViewerPreferences.READING_DIRECTIONは、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
)
で規定されている右から左への言語や双方向テキストにおいて重要です。読み取り方向の設定は、ページレイアウト、ナビゲーション、およびユーザーが複数ページのドキュメントとやり取りする方法に影響を与え、文化的・言語的慣習に従ってコンテンツが表示されることを保証します。
PDViewerPreferences.READING_DIRECTIONは、Apache PDFBoxのPDViewerPreferencesクラス内のJava定数で、PDFドキュメントのビューア設定辞書内のReadingDirectionエントリに対応します。このプロパティは、L2R(左から右)、R2L(右から左)、または指定なし(デフォルト動作の継承)の3つの値を受け入れます。個々のテキスト実行や段落に適用されるテキスト方向属性とは異なり、READING_DIRECTIONはドキュメント全体の設定を行い、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
)
によれば、この設定はデフォルトのページ進行方向とレイアウト方向を決定し、並列表示においてページが左から右へ進むか、右から左へ進むかに影響します。
PDViewportDictionaryは、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
)
で定義されたビューポートプロパティへのプログラムによるアクセスを提供し、開発者がビューポートの境界とそれに関連する測定データを読み取り、操作できるようにします。ビューポートは、正確な測定値と座標系を保持する必要がある技術図面、地図、地理空間PDFで一般的に使用されます。
PDViewportDictionaryは、Apache PDFBoxのPDModelレイヤー内の高レベルラッパークラスで、PDF仕様で定義されたビューポート辞書構造をカプセル化します。ビューポート辞書は、ページ座標と実世界の測定値または地理座標系との対応関係を確立し、通常は単位、スケール係数、座標変換を定義する測定辞書(measure dictionary)と関連付けられます。一般的なページ境界やクロップボックスとは異なり、ビューポートは測定データが意味を持ち適用可能な特定の領域を定義するため、正確な寸法精度や地理空間参照を必要とする文書には不可欠です。PDViewportDictionaryクラスは、PDFBoxの標準的なPDModelパターンに従い、低レベルのPDF構文を抽象化しながら、基礎となるCOSDictionary表現にアクセスするためのgetterおよびsetterメソッドを提供します。
技術図面、工学文書、建築図面、または地理空間PDFを扱う開発者にとって、PDViewportDictionaryは測定精度と座標系情報を保持するために必要なプログラムインターフェースを提供します。CAD図面やGISマップを含むPDFからデータを抽出する際、ビューポート情報にアクセスすることで、測定値を元の単位と座標系で正しく解釈できるようになります。この機能は、PDFを他の形式に変換するアプリケーション、自動測定を実行するアプリケーション、または文書処理ワークフロー全体で空間データの整合性を維持する必要があるアプリケーションにとって特に重要です。適切なビューポート処理がなければ、測定データと地理座標はその意味や精度を失う可能性があります。