PDShadingType4

PDShadingType4は、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 ) で定義されている複数のシェーディングタイプの1つである自由形式グローシェーディング三角形メッシュ（Free-Form Gouraud-Shaded Triangle Mesh）シェーディングパターンを表現します。このクラスは、開発者に対してType 4シェーディングを読み取り、操作するためのメソッドを提供します。Type 4シェーディングは、三角形パッチを使用して複雑な形状全体に滑らかな色のグラデーションを作成します。PDShadingType4は、PDFのグラフィカル要素を扱うためのPDFBoxの高レベル抽象化レイヤーの一部です。

PDShadingType4は、 ( 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 4シェーディングパターンのプロパティと動作をカプセル化するJavaクラスです。Type 4シェーディングは自由形式グローシェーディング三角形メッシュを表現し、各三角形パッチは色が関連付けられた3つの頂点によって定義され、内部の色はグローシェーディングアルゴリズムを使用して頂点間で滑らかに補間されます。

軸方向シェーディングや放射状シェーディングなどのよりシンプルなシェーディングタイプとは異なり、Type 4シェーディングは三角形メッシュ構造を通じてシェーディング領域のジオメトリを自由に定義できます。メッシュ内の各三角形は隣接する三角形に接続でき、複雑で曲線的な色の遷移を作成します。これは、構造化されたグリッドパターンを使用するPDShadingType5（格子形式グローシェーディング三角形メッシュ）や、より洗練されたパラメトリックパッチ定義を使用するPDShadingType6およびPDShadingType7（CoonsパッチメッシュおよびTensor-Productパッチメッシュ）とは異なります。

PDShadingType4クラスは、基底クラスであるPDShadingクラスを継承し、三角形メッシュ構造を定義する頂点座標、色値、エッジフラグを含むデータストリームにアクセスするための固有のメソッドを提供します。

複雑なPDFグラフィックスや視覚効果を扱う開発者にとって、PDShadingType4は高度なグラデーションレンダリング技術へのプログラマティックなアクセスを提供します。このクラスを理解することは、以下の場合に重要です。

• 芸術的または技術的なイラストレーションのために滑らかで複雑な色の遷移を作成する必要があるPDF生成ツールの構築
• 既存のPDFを解析して、グラフィックスから高度なシェーディング情報を抽出または分析する場合
• 三角形メッシュシェーディングを保持または変換する必要がある異なるグラフィックス形式間での変換
• 特定の視覚効果に適切なシェーディングタイプを選択することによる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 ) で概説されているように、必要に応じて適切な代替表現が提供されるようにする必要があります。

PDShadingType4は、三角形パッチのシーケンスを定義するデータストリームをカプセル化することで動作します。メッシュ内の各頂点は以下によって指定されます。

• 頂点位置を定義する座標値（x、y）
• その頂点での色を定義する色成分
• 頂点が以前の頂点にどのように接続して三角形を形成するかを示すエッジフラグ

データストリームは通常、圧縮形式でエンコードされており、PDShadingType4クラスは、デコードされたストリームにアクセスし、PDF仕様の要件に従って頂点データを解釈するためのメソッドを提供します。シェーディングの座標空間は変換行列によって定義され、色は特定の色空間（DeviceRGB、DeviceCMYKなど）で指定されます。

PDFレンダリングソフトウェアがType 4シェーディングに遭遇すると、頂点データを順次読み取り、エッジフラグに基づいて三角形パッチを構築し、グローシェーディング補間を適用して各三角形の内部全体で色を滑らかにブレンドします。レンダリングエンジンは、これらの補間された三角形を組み合わせて、最終的なシェーディングの外観を生成します。

PDShadingType4を使用する開発者は、座標あたりのビット数、コンポーネントあたりのビット数、色空間、デコード配列、生のデータストリームなどのプロパティにアクセスできます。このクラスは、JavaBeanの規則に従ったgetterおよびsetterメソッドを提供し、シェーディングプロパティの読み取りと書き込みの両方の操作を可能にします。

• PDShading – Apache PDFBoxのすべてのシェーディングタイプの基底クラス
• PDShadingType6 – より複雑なパラメトリックパッチのためのCoonsパッチメッシュシェーディングクラス
• PDColor – シェーディングで使用される特定の色空間の色を表すクラス
• PDGraphicsState – 現在のシェーディングパターンを含むグラフィックス状態を管理するクラス
• COSStream – シェーディングデータを含むストリームオブジェクトを表す低レベルクラス