PDImageXObject
PDImageXObjectは、Apache PDFBoxライブラリにおいて、PDFドキュメント内の画像XObjectを表すクラスです。
PDImageXObjectは、Apache PDFBoxライブラリにおいて、PDFドキュメント内の画像XObjectを表すクラスです。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ドキュメント全体で複数回参照できるようにします。
PDImageXObjectは、PDF画像XObjectの構造と操作をカプセル化したJavaクラスです。PDF用語では、XObjectは一つまたは複数のページに複数回描画できる自己完結型のグラフィックスオブジェクトであり、画像XObjectは特にラスター画像やビットマップ画像を表します。コンテンツストリームに直接埋め込まれるインライン画像とは異なり、画像XObjectはPDFファイル構造内に別個のオブジェクトとして保存され、ページリソースから名前によって参照されます。PDImageXObjectクラスは、画像データの抽出、画像プロパティ（寸法、色空間、解像度）の照会、およびBufferedImageなどの一般的なJava画像フォーマットから新しい画像XObjectを作成するメソッドを提供します。
JavaでPDF生成や操作を行う開発者にとって、PDImageXObjectは画像を効率的に扱うために不可欠です。既存のPDFから画像を抽出して分析やアーカイブを行う、PDFドキュメントに新しい画像を追加する、同じ画像XObjectを複数のページで再利用することで重複する画像データの埋め込みを避けてPDFファイルサイズを最適化するといった操作を可能にします。これは特にアクセシブルなPDFを作成する際に重要で、XObjectを通じた適切な画像処理により、 ( 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 ) などの標準で要求される代替テキストや構造要素とのより良い統合が可能になります。PDImageXObjectの理解は、PDF処理ワークフロー、レポート生成システム、またはドキュメント変換ツールを構築する開発者にとって極めて重要です。
PDImageXObjectは、基盤となるPDF画像XObjectのディクショナリとストリームをラップし、画像プロパティにアクセスして変更するためのJavaに適したインターフェースを提供することで機能します。既存のPDFを読み取る際、開発者はリソース名を使用してページのPDResourcesからPDImageXObjectインスタンスを取得します。このクラスは、様々な色空間（DeviceRGB、DeviceGray、DeviceCMYK、ICCベース）、圧縮フィルタ（JPEGのDCTDecode、PNG類似の圧縮のためのFlateDecode）、および画像マスクのサポートを含む、PDF画像エンコーディングの複雑さを処理します。新しい画像を作成するには、開発者はPDDocumentと、BufferedImageまたは画像データを含むInputStreamのいずれかでPDImageXObjectをインスタンス化します。このクラスは、PDF互換フォーマットへの変換、適切な圧縮の適用、およびドキュメントのリソース構造への画像の登録を自動的に処理します。その後、PDPageContentStreamを使用してページに画像を描画できます。これはPDImageXObjectを割り当てられたリソース名で参照し、スケーリングや配置などの変換を適用します。
- PDResources – 画像、フォント、その他のXObjectを含むページリソースを管理するコンテナクラス
- PDPageContentStream – 画像を含むコンテンツをPDFページに描画するためのクラス
- COSStream – 画像データを含む基盤となるストリームオブジェクトを表す低レベルのPDFBoxクラス
- Content Stream – ページにコンテンツがどのように描画されるかを定義するPDF演算子とオペランドのシーケンス
- Form XObject – 再利用可能なベクターグラフィックスとグループ化されたコンテンツに使用される別のタイプのXObject。画像XObjectに類似しているがPDF描画コマンドを含む
- (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
- (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