PDArtifactMarkedContentは、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
)
で定義されているTagged 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
)
などの標準に準拠したアクセシブルなPDFを扱う際に、これらのアーティファクト指定をプログラム的に識別、アクセス、操作できます。
PDAttributeObjectは、Apache PDFBoxライブラリの高レベルPDModel APIにおける基盤となるJavaクラスであり、PDF文書要素への構造化されたアクセスを提供します。PDFBoxのオブジェクト指向インターフェースの一部として、低レベルのCOS(Carousel Object Structure)層をラップし、開発者が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の内部的な辞書やストリーム構造を直接操作する必要がなくなり、Javaメソッドとプロパティを通じてPDFを操作できるため、PDF処理が大幅に簡素化されます。
PDAttributeObjectは、Apache PDFBox内の抽象基底クラスであり、生のCOS層よりも高い抽象度でPDF辞書オブジェクトを表現します。PDAttributeObjectとそのサブクラスを含むPDModel APIは、PDFのネイティブなデータ構造を、型付けされたメソッドとプロパティを持つJavaオブジェクトに変換します。PDFオブジェクトをキーと値のペアとして表現する低レベルのCOSDictionaryやCOSBaseクラスとは異なり、PDAttributeObjectのサブクラスは、特定のPDF構造を扱うためのドメイン固有のインターフェースを提供します。
例えば、COSDictionaryには"/Type /Page"や"/MediaBox [0 0 612 792]“のような任意のエントリが含まれる場合がありますが、PDPageのようなPDAttributeObjectサブクラスでは、これらを適切な型チェックと検証を伴ったgetMediaBox()やsetMediaBox()メソッドとして公開します。この階層化されたアーキテクチャは関心事を分離します。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の構文と構造を扱い、PDModel層は開発者に意味論的な意味と利便性を提供します。
PDBorderEffectDictionaryは、Apache PDFBoxのクラスで、PDFドキュメント内の境界線効果辞書を表現します。この辞書は、注釈の境界線に適用される視覚効果を定義します。このクラスは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ドキュメント内のインタラクティブ要素の視覚的表現を強化します。
PDBorderEffectDictionaryは、Apache PDFBoxのJavaクラスで、PDF仕様の境界線効果辞書構造をカプセル化します。この辞書は、リンク注釈やその他の注釈タイプの境界線に適用できるオプションの視覚効果を定義します。このクラスは、効果スタイル(「S」はソリッド、「C」は雲形など)や、これらの効果の外観を制御する強度値などのプロパティを操作するためのgetterおよびsetterメソッドを提供します。
境界線の幅、破線パターン、スタイルなどの基本的な境界線プロパティを定義するPDBorderStyleDictionaryクラスとは異なり、PDBorderEffectDictionaryは境界線のレンダリング方法を変更する装飾的効果を特に扱います。この分離により、PDF開発者は境界線の構造的プロパティと視覚効果を独立して制御できるため、注釈の外観をより柔軟にカスタマイズできます。
PDF注釈を扱う開発者にとって、PDBorderEffectDictionaryはPDF標準に準拠したインタラクティブ要素の視覚的表現を正確に制御することを可能にします。アクセシブルなPDFを作成したり、注釈の外観をカスタマイズしたりする際、境界線効果を理解することで、さまざまなPDFビューアやデバイス間で視覚的手がかりが適切にレンダリングされることを保証します。
PDBorderStyleDictionary は、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
)
で定義されている境界線の外観プロパティを読み取り、変更するための高レベルな Java インターフェースを提供します。これにより、開発者はインタラクティブな PDF 要素の境界線の幅、破線パターン、スタイルタイプなどの視覚的特性をプログラムで制御できます。
PDBorderStyleDictionary は、PDF 仕様で定義されている境界線スタイル(BS)辞書構造をカプセル化する具象 Java クラスです。このクラスは、基礎となる PDF 辞書オブジェクトのラッパーとして機能し、境界線プロパティに対して型安全な getter および setter メソッドを提供します。レガシー PDF に見られる古い境界線(B)配列形式とは異なり、PDBorderStyleDictionary は、追加のスタイルオプションをサポートする、より現代的で柔軟な境界線スタイル辞書アプローチを表します。このクラスは、スタイルタイプ(実線、破線、ベベル、インセット、または下線)、境界線の幅、およびカスタムライン スタイルを定義する破線配列パターンなどのプロパティを処理します。
PDBoxStyleは、Apache PDFBoxエコシステムにおいて誤認識された用語と思われます。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
)
に準拠したPDF文書を操作するためのJavaライブラリです。PDFBoxライブラリは、PDF文書構造と対話するための高レベルインターフェースとしてPDModel APIを提供していますが、「PDBoxStyle」はApache PDFBoxライブラリの標準的なクラス名ではありません。これは、カスタムスタイリングユーティリティ、PDModel API自体、またはPDFBoxの文書操作機能に対する誤った名称を指している可能性があります。
Apache PDFBoxのPDModel APIは、開発者がプログラムでPDF文書構造と対話するために使用する高レベルインターフェースです。PDModelパッケージには、PDDocument、PDPage、PDResources、PDAnnotation、PDPageContentStreamなどのクラスが含まれており、低レベルのPDF構文を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構造を直接操作することなく、ページ、フォント、画像、フォームフィールド、メタデータ、注釈などのPDF要素を読み取り、作成、変更することができます。
PDButtonは、Apache PDFBoxのPDModel APIにおけるJavaクラスであり、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フォームとのユーザーインタラクションを可能にします。この高レベルクラスは、開発者がプログラム的にボタンフィールドのプロパティと動作を作成、読み取り、変更するためのメソッドを提供します。
PDButtonは、Apache PDFBoxライブラリ内の具象実装クラスであり、PDFieldクラス階層を拡張してボタン型フォームフィールドを専門的に処理します。
(
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用語において、ボタンはユーザーがアクションをトリガーしたりオプションを選択したりできるインタラクティブフォームフィールド(AcroFormフィールド)です。PDButtonは、これらのインタラクティブ要素を定義する基礎となるPDFディクショナリ構造に対するJava APIの抽象化を提供します。
PDCalGrayは、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
)
で定義されているCalGrayカラースペース(校正済みグレースケールカラースペース)を表現します。このカラースペースは、ホワイトポイント、ブラックポイント、ガンマ補正などの校正パラメータを指定することで、デバイスに依存しないグレースケールレンダリングを提供します。開発者は、異なる出力デバイス間で正確な校正済みグレースケール色再現が必要なPDF文書を扱う際にPDCalGrayを使用します。
PDCalGrayは、PDF仕様で定義されているCalGray(Calibrated Gray)カラースペースを実装するApache PDFBoxのJavaクラスです。出力デバイスの特性に依存する単純なDeviceGrayカラースペースとは異なり、CalGrayカラースペースはICC準拠の校正パラメータを通じてデバイス非依存のカラーレンダリングを提供します。このクラスは3つの主要な校正属性をカプセル化します:ホワイトポイント(白色の三刺激値を定義)、オプションのブラックポイント(黒色の三刺激値を定義)、およびトーン再現のためのオプションのガンマ値です。PDCalGrayはPDFBoxの抽象カラースペースクラスを継承し、これらの校正パラメータを読み取りおよび設定するメソッドを提供することで、開発者が制御されたグレースケール外観を持つPDFコンテンツを作成または操作できるようにします。これは、校正機能を持たずデバイス固有のレンダリングに完全に依存するPDDeviceGrayや、簡略化された校正パラメータではなく完全なICCプロファイルを使用するPDICCBasedカラースペースとは異なります。
異なるディスプレイ、プリンタ、プラットフォーム間で一貫したグレースケール外観が必要なPDF文書を扱う開発者にとって、PDCalGrayは不可欠なカラーマネジメント機能を提供します。これは、プロフェッショナルな出版ワークフロー、アーカイブ文書、およびグレースケールコンテンツが出力デバイスに関係なく予測可能にレンダリングされる必要があるアクセシビリティ強化PDFにおいて特に重要です。校正済みカラースペースを使用することで、開発者はグレースケール画像、テキスト、グラフィックスが意図した視覚的外観とコントラスト比を維持することを保証でき、これはPDF/UA
(
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
)
のようなアクセシビリティ基準を満たす上で重要です。PDCalGrayは、アプリケーションのニーズに対して正確だが簡潔なグレースケール校正で十分な場合に、完全なICCプロファイルベースのカラーマネジメントに代わる、よりシンプルな選択肢も提供します。このクラスを理解することで、開発者はPDFコンテンツをプログラム的に作成または変更する際に、カラースペースの選択について情報に基づいた判断を下すことができます。
PDCalRGBは、Apache PDFBoxライブラリにおいて、PDF文書内のキャリブレーションされたRGBカラースペースを表すクラスです。このカラースペースタイプにより、開発者は
(
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
)
で定義されている特定の白色点、黒色点、ガンマ補正パラメータを持つデバイス非依存のRGB色値を定義できます。PDCalRGBは、デバイス依存のRGB値に頼るのではなく、明示的なキャリブレーション情報を提供することで、異なるデバイス間での正確な色再現を可能にします。
PDCalRGBは、Apache PDFBoxのPDModelパッケージに含まれる高レベルAPIクラスで、PDF標準のCalRGBカラースペース仕様をカプセル化します。基本的なデバイス依存RGBカラースペース(DeviceRGB)とは異なり、CalRGBカラースペースには、RGB値がCIE XYZカラースペースとの関係でどのように解釈されるべきかを定義するキャリブレーションパラメータが含まれています。このクラスは、白色点(必須パラメータ)、黒色点(オプション)、各色成分のガンマ値(オプション)、および変換マトリックス(オプション)を取得および設定するメソッドを提供します。これらのパラメータにより、出力デバイスの固有の色特性に関係なく、色が一貫してレンダリングされることが保証されます。PDCalRGBはPDCIEBasedColorSpaceクラスを拡張し、PDFコンテンツストリームおよびリソースディクショナリからCalRGBカラースペースディクショナリを読み書きするために必要な機能を実装しています。
色が重要なPDFアプリケーションを開発する開発者にとって、PDCalRGBは色の精度と一貫性を制御するための不可欠な手段を提供します。プロフェッショナル写真、グラフィックデザイン、印刷制作文書など、正確な色再現が必要なPDFを作成する場合、キャリブレーションされたカラースペースを使用することで、異なる表示デバイスやプリンター間で意図した通りの色が表示されることが保証されます。これは特にアクセシビリティの観点で重要であり、一貫した色レンダリングは視覚障害のあるユーザーの可読性と使いやすさに影響を与える可能性があります。PDCalRGBを理解し実装することで、開発者は基本的なRGB色表現を超えて、プロフェッショナルグレードのカラーマネジメントを備えたPDFを作成できます。これは、色の忠実度が文書の品質と使いやすさに直接影響を与える業界のアプリケーションにとって非常に重要です。
PDCheckBoxは、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
)
で定義されたインタラクティブフォーム仕様に準拠したチェックボックスウィジェットの読み取り、変更、作成が可能になります。PDCheckBoxは、基盤となるPDF構造を直感的なJavaメソッドに抽象化することで、PDFフォーム要素の操作を簡素化します。
PDCheckBoxは、Apache PDFBox内の特殊なJavaクラスで、チェックボックスフォームフィールド、つまり2つの状態(通常はチェック済みと未チェック)を切り替えるボタンフィールドの一種を表現します。グループ内で1つの選択肢のみを許可するラジオボタンとは異なり、チェックボックスは独立して動作し、他のフォームフィールドの状態に関係なくチェック・チェック解除が可能です。このクラスはPDFBoxのフォームフィールド階層を拡張し、外観状態、デフォルト値、エクスポート値などのチェックボックスプロパティを操作するメソッドを提供します。PDCheckBoxは、PDFフォームフィールド辞書、外観ストリーム、ウィジェット注釈の複雑さを処理し、開発者にチェックボックス操作のための分かりやすいオブジェクト指向インターフェースを提供します。
アクセシブルでインタラクティブなPDF文書を作成する開発者にとって、PDCheckBoxは技術仕様と
(
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
)
などのアクセシビリティ標準の両方を満たすフォーム機能を実装するために不可欠です。このクラスはプログラムによるフォーム入力を可能にし、自動文書処理ワークフロー、データ収集システム、文書生成サービスにおいて重要な役割を果たします。PDCheckBoxを使用することで、開発者は適切な外観辞書と状態値を持つ正しく構造化されたチェックボックスを保証でき、異なるPDFビューア間で正しくレンダリングされない不正な形式のPDFフォームを作成するリスクを軽減できます。この一貫性は、PDFが法的拘束力のある文書やコンプライアンス記録として機能するエンタープライズアプリケーションにおいて特に重要です。
PDChoiceは、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
)
で定義されているように、事前に定義された値のリストからユーザーが1つまたは複数のオプションを選択できるようにします。この高レベルクラスは、開発者が選択フィールドのプロパティ(利用可能なオプション、デフォルト選択、フィールドの動作など)をプログラムで読み取りおよび変更するための便利なメソッドを提供します。
PDChoiceは、Apache PDFBoxの高レベルPDModel APIの一部であり、選択可能なオプションをユーザーに提示するインタラクティブフォームフィールド(AcroForm)と連携するように特別に設計されています。このクラスはPDFieldクラス階層を拡張し、2つの具体的な実装の親クラスとして機能します:PDListBox(スクロール可能なリスト選択用)とPDComboBox(ドロップダウン選択用)です。自由形式の入力を受け付けるテキストフィールドとは異なり、PDChoiceフィールドはユーザー入力を事前に定義された値のセットに制限するため、PDFフォームにおける構造化データ収集に不可欠です。このクラスは、基礎となるPDFディクショナリ構造をカプセル化し、オプション配列、エクスポート値、複数選択機能、ソート動作などの選択フィールド属性を操作するための型安全なJavaメソッドを提供します。
PDFフォームを扱う開発者にとって、PDChoiceは、構造化データを確実に収集するアクセシブルでユーザーフレンドリーなドキュメントを作成するために重要です。選択フィールドは、ユーザー入力を有効なオプションに制限することでデータ品質を向上させ、エラーを削減し、下流のデータ処理を簡素化します。PDFフォーム自動化を実装する際、開発者はPDChoiceを使用して、ビジネスロジックに基づいてドロップダウンメニューやリストボックスを動的に設定したり、他のフィールドでのユーザー選択に基づいて利用可能なオプションを更新したり、選択された値を処理のために抽出したりします。選択フィールドの適切な実装は、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
)
にも貢献し、支援技術が障害を持つユーザーにオプションを正しく提示できるようにします。