PDPattern

PDPatternは、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ページ内でコンテンツがどのようにレンダリングされるかを制御するパターン辞書にアクセスし、操作し、作成するためのメソッドを提供します。

PDPatternは、Apache PDFBoxライブラリの抽象基底クラスで、PDF仕様で定義されているさまざまなパターンタイプの親クラスとして機能します。このクラスはPatternリソースを表し、PDFにおける4つの基本的な色空間(DeviceRGB、DeviceCMYK、DeviceGrayと並ぶ)の1つです。PDPatternには2つの具象サブクラスがあります：繰り返しグラフィカルパターンを扱うPDTilingPatternと、滑らかな色の遷移やグラデーションを扱うPDShadingPatternです。単純な色とは異なり、パターンは、領域全体に繰り返しペイントできる、またはグラデーションとしてペイントできる再利用可能なグラフィック要素を定義することで、洗練された視覚効果を実現します。PDPatternオブジェクトは通常、ページのリソース辞書に格納され、パスの塗りつぶしや線描画の際にコンテンツストリーム演算子によって参照されます。

PDF生成または操作を行う開発者にとって、PDPatternは単純な単色を超えた視覚的に豊かなドキュメントを作成するための重要な機能を提供します。カスタムレンダリング効果の実装、複雑な塗りつぶしを使用する既存のPDF文書の解析、またはPDF変更操作中にパターンベースのスタイリングを保持する際には、このクラスを理解することが不可欠です。テクスチャ背景で企業ブランディングを再現したり、ウォーターマークシステムを実装したり、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を扱う際には、装飾的なパターンがコンテンツ構造を妨げないこと、および意味のある視覚情報がパターン塗りつぶしだけで伝達されないことを開発者は確認する必要があります。

PDPatternは、 ( 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コンテンツストリームがパターン色空間を指定すると、ページのResources辞書からパターンリソースを名前で参照します。PDPatternオブジェクトは、パターンタイプ、ペイントタイプ、変換行列、バウンディングボックスなどのパターンプロパティにアクセスするためのgetterおよびsetterメソッドを提供します。タイリングパターン(PDTilingPattern)の場合、このクラスは繰り返しグラフィック要素を定義するパターンセルのコンテンツストリームと、間隔と繰り返しを制御するタイリングパラメータを管理します。シェーディングパターン(PDShadingPattern)の場合は、色グラデーションを定義する関連するシェーディング辞書を管理します。開発者は通常、既存のPDFを読み取る際にはPDResourcesクラスを通じてPDPatternインスタンスを取得し、カスタム視覚効果でPDFコンテンツをプログラム的に生成する際には新しいインスタンスを作成します。

• PDResources – PDFページまたはコンテンツストリームで使用可能なすべてのリソース(フォント、画像、パターンなど)を管理するコンテナクラス
• PDShadingPattern – 滑らかな色のグラデーションと遷移を表すPDPatternのサブクラス
• PDTilingPattern – グリッド状に配置された繰り返しグラフィカルパターンを表すPDPatternのサブクラス
• PDColorSpace – パターン色空間を含む、PDFの色空間を表す抽象クラス
• PDAppearanceStream – 再利用可能なコンテンツを定義するために使用されるForm XObjectで、タイリングパターンのコンテンツストリームと構造が類似