PDTilingPattern

PDTilingPatternは、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 ) で定義されているタイリングパターンは、小さなグラフィック要素（パターンセルと呼ばれる）を固定された水平・垂直間隔で複製することで領域を塗りつぶす、パターンリソースの一種です。この高レベルAPIクラスにより、Java開発者はPDFファイル内のタイリングパターンリソースをプログラム的に読み取り、作成、変更することができます。

PDTilingPatternは、 ( 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仕様の低レベルなタイリングパターン辞書構造にマッピングされる、Apache PDFBoxのオブジェクト指向抽象化レイヤーの一部です。独自の色指定を含む色付きタイリングパターン（Type 1）や、使用されるコンテキストから色を継承する色なしタイリングパターン（Type 2）とは異なり、PDTilingPatternは両方のパターンタイプを扱うための統一されたJavaインターフェースを提供します。このクラスはPDAbstractPattern基底クラスを拡張し、ペイントタイプ、タイリングタイプ、バウンディングボックスの寸法、水平・垂直間隔（XStepとYStep）、およびパターンのコンテンツストリームなどのパターンプロパティにアクセスするメソッドを提供します。このクラスは、離散的な繰り返しセルではなく滑らかなカラーグラデーションを使用するシェーディングパターン（PDShadingPatternで表現される）とは異なります。

PDF生成または操作に携わる開発者にとって、PDTilingPatternは、大きなビットマップ画像を埋め込むことなく複雑な塗りつぶしパターンやテクスチャを作成するために不可欠です。タイリングパターンにより、透かし、背景テクスチャ、ハッチングパターン、装飾的な塗りつぶしなどの繰り返しグラフィック要素を、ファイルサイズを小さく保ちながら効率的に表現できます。このクラスの理解は、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ジェネレータを構築する際に特に重要です。タイリングパターンをプログラム的にアクセスおよび変更する機能により、開発者はカスタムレンダリングロジックの実装、分析のためのパターン情報の抽出、またはPDF最適化ワークフロー中のパターン変換が可能になります。

PDTilingPatternは、PDFタイリングパターン辞書をカプセル化し、パターン属性のゲッターおよびセッターメソッドを提供することで機能します。PDFBoxがPDFを解析する際、タイリングパターンリソースはPDTilingPatternオブジェクトとしてインスタンス化され、PDResourcesクラスを通じてページのリソース辞書から取得できます。パターンのコンテンツストリームには、単一のパターンセルの外観を定義するグラフィックスオペレータが含まれ、XStepやYStepなどのプロパティは繰り返し間の間隔を決定します。開発者はパターンのバウンディングボックス（BBox）にアクセスしてセルの寸法を理解し、PatternTypeをチェックして色付きと色なしのパターンを区別し、TilingTypeプロパティを調べて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 ) で指定されているように、デフォルトのユーザー空間座標系に対してパターン座標空間に適用される変換を定義するパターンマトリックスへのアクセスも提供します。

• PDAbstractPattern – PDFBoxのパターンリソースの基底クラスで、PDTilingPatternとPDShadingPatternの親クラス
• PDResources – コンテンツストリームで使用されるフォント、画像、パターン、その他のリソースへの参照を含むPDFリソース辞書を表すクラス
• PDShadingPattern – 繰り返しセルではなくカラーグラデーションを使用する滑らかなシェーディングパターンを表すApache PDFBoxクラス
• PDPageContentStream – パターン定義を含むグラフィックスオペレータとコンテンツストリームをPDFページに書き込むために使用されるクラス
• COSDictionary – パターン属性を格納する基礎となる辞書構造を表す低レベルPDFBoxクラス