PDShadingType2

PDShadingType2は、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 ) で定義されている軸方向（線形）シェーディングパターンを表すApache PDFBoxのクラスです。この高レベルなPDModel APIクラスを使用することで、開発者はType 2シェーディングをプログラムで読み取り、操作することができます。Type 2シェーディングは、2点間の直線に沿って滑らかな色の遷移を作成します。このクラスは、PDFファイル内の複雑なグラフィカル要素を処理するためのPDFBoxのリソース管理システムの一部です。

PDShadingType2は、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 ) で定義されているType 2（軸方向）シェーディング辞書をカプセル化する、Apache PDFBox内の特殊なJavaクラスです。Type 2シェーディングは、2つの座標点で定義される線形軸に沿って滑らかに変化するカラーグラデーションを生成し、この軸に垂直に色を補間することで線形グラデーションのような効果を作り出します。このクラスはベースクラスであるPDShadingを拡張し、開始座標と終了座標、色遷移を定義する関数、定義された端点を超えてシェーディングを拡張するかどうかなど、シェーディング固有のプロパティにアクセスおよび変更するためのメソッドを提供します。円形グラデーションを作成するType 3（放射状）シェーディングや、メッシュベースのパターンを使用するType 4-7シェーディングとは異なり、PDShadingType2は、PDFコンテンツの背景、塗りつぶし、視覚効果に一般的に使用される線形グラデーション効果を特に処理します。

PDF生成または操作を行う開発者にとって、PDShadingType2は視覚的に魅力的で専門的なグラデーション効果を持つドキュメントを作成するための重要な機能を提供します。このクラスを理解することは、既存のPDFからグラフィカル情報を抽出したり、視覚的なデザインを再現したり、複雑なシェーディングパターンを持つ新しいPDFを生成したりする必要があるアプリケーションを構築する際に不可欠です。線形グラデーションをプログラムで制御できることにより、開発者はブランドの一貫性を維持し、動的なドキュメントテンプレートを作成し、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 ) などの標準への準拠に影響を与えるアクセシブルなドキュメントのアプリケーションにおいて特に重要です。

PDShadingType2は、PDFファイル構造内のシェーディングを表す低レベルのCOS（Carousel Object Structure）辞書をカプセル化することで動作します。インスタンス化されると、このクラスは主要なプロパティにアクセスするためのgetterおよびsetterメソッドを提供します：Coords配列（グラデーション軸の開始点[x0, y0]と終了点[x1, y1]を定義）、Functionオブジェクト（0から1の間の位置値を色値にマッピング）、Domain配列（関数の有効な入力範囲を指定）、およびExtend配列（定義された端点を超えてグラデーションを拡張するかどうかを示すブール値フラグ）。開発者は、PDShadingType2をインスタンス化し、これらのプロパティを設定し、ページのリソースにシェーディングを追加することで、新しいType 2シェーディングを作成できます。レンダリング時、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ビューア間で正確なレンダリングを保証します。

• PDShading – Apache PDFBox内のすべてのPDFシェーディングパターンのベースクラス
• PDShadingType3 – PDFBoxにおける放射状（円形）シェーディングパターンを表すクラス
• PDColorSpace – PDFドキュメント内で使用される色空間を表し、色の解釈方法を定義
• PDResources – PDFページに関連付けられたすべてのリソース（フォント、画像、シェーディング）を管理するコンテナクラス
• COSDictionary – PDFファイル全体で使用される辞書データ構造を表す低レベルのPDFBoxクラス