PDTristimulus

PDTristimulus は、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 ) で規定されている人間の視覚システムの応答に対応する3つの数値成分を使用して色を定義します。このクラスにより、開発者は PDF ドキュメントをプログラム的に操作する際に、CalRGB や CalGray などの校正された色空間を読み取り、操作することができます。

PDTristimulus は Apache PDFBox 内の Java クラスで、三刺激値の色座標を表す3つの浮動小数点値をカプセル化します。これらの値は通常、CIE XYZ 色空間における X、Y、Z 値に対応します。 ( 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 ドキュメントにおいて校正された色空間を定義する基礎となるもので、白色点、黒色点、ガンマ補正パラメータを指定します。デバイス依存の RGB や CMYK 値とは異なり、三刺激値はデバイス独立の色指定を提供し、異なる出力デバイス間で一貫した色再現を保証します。PDTristimulus クラスは、デバイス固有の色エンコーディングではなく、人間の目で知覚される色の数学的表現を具体的に扱う点で、PDFBox の他の色クラスとは異なります。

PDF の色管理を扱う開発者にとって、PDTristimulus は正確な色再現とアクセシビリティ機能を実装する際に不可欠です。三刺激値を正しく理解し、適切に処理することで、表示デバイスやプリンタに関係なく 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 ) で概説されているアクセシビリティ準拠のための適切な色コントラストが必要な Tagged PDF を扱う場合、開発者は三刺激値を使用する校正された色空間を扱う必要があります。このクラスは、PDF から既存の色校正データを読み取る、または特定の色要件を持つ新しい PDF ドキュメントを作成する際に適切な三刺激値を設定するためのプログラマティックなインターフェースを提供します。

PDTristimulus は、CIE XYZ 色空間における色の X、Y、Z 成分を表す3つの倍精度浮動小数点値を格納します。PDFBox が CalRGB または CalGray 色空間を含む PDF ドキュメントを解析する際、PDF 色空間辞書から WhitePoint、BlackPoint、またはその他の三刺激値ベースのパラメータを抽出し、これらの値を表す PDTristimulus オブジェクトをインスタンス化します。開発者は、getter メソッド（通常は getX()、getY()、getZ()）を通じて個々の成分にアクセスし、対応する setter メソッドまたはコンストラクタパラメータを通じて設定できます。このクラスは、 ( 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 ファイル構造に格納される PDF 配列表現と、Java オブジェクト表現との間の変換を処理します。PDF ドキュメントを作成または変更する際、PDFBox は PDTristimulus オブジェクトを色空間辞書内の適切な PDF 配列形式にシリアライズします。三刺激値は、PDF レンダリングエンジンによって、校正された色空間からデバイス固有の色空間へ色を変換する際に使用され、指定された測色パラメータに基づいた正確な色再現を保証します。

• CalRGB Color Space（CalRGB 色空間）– 白色点、黒色点、ガンマ補正を定義するために三刺激値を使用する PDF の校正された RGB 色空間
• CalGray Color Space（CalGray 色空間）– デバイス独立のグレー再現のために三刺激値を使用する校正されたグレースケール色空間
• CIE XYZ Color Space（CIE XYZ 色空間）– X、Y、Z の三刺激値を使用する人間の視覚知覚に基づく国際標準色空間
• PDColorSpace – 校正された色空間を含むさまざまな PDF 色空間タイプを表す Apache PDFBox の親クラス
• Color Space Dictionary（色空間辞書）– 校正された色空間を定義する三刺激値などのパラメータを含む PDF 構造