PDCalGray

PDCalGrayは、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 ) で定義されているCalGrayカラースペース（校正済みグレースケールカラースペース）を表現します。このカラースペースは、ホワイトポイント、ブラックポイント、ガンマ補正などの校正パラメータを指定することで、デバイスに依存しないグレースケールレンダリングを提供します。開発者は、異なる出力デバイス間で正確な校正済みグレースケール色再現が必要なPDF文書を扱う際にPDCalGrayを使用します。

PDCalGrayは、PDF仕様で定義されているCalGray（Calibrated Gray）カラースペースを実装するApache PDFBoxのJavaクラスです。出力デバイスの特性に依存する単純なDeviceGrayカラースペースとは異なり、CalGrayカラースペースはICC準拠の校正パラメータを通じてデバイス非依存のカラーレンダリングを提供します。このクラスは3つの主要な校正属性をカプセル化します：ホワイトポイント（白色の三刺激値を定義）、オプションのブラックポイント（黒色の三刺激値を定義）、およびトーン再現のためのオプションのガンマ値です。PDCalGrayはPDFBoxの抽象カラースペースクラスを継承し、これらの校正パラメータを読み取りおよび設定するメソッドを提供することで、開発者が制御されたグレースケール外観を持つPDFコンテンツを作成または操作できるようにします。これは、校正機能を持たずデバイス固有のレンダリングに完全に依存するPDDeviceGrayや、簡略化された校正パラメータではなく完全なICCプロファイルを使用するPDICCBasedカラースペースとは異なります。

異なるディスプレイ、プリンタ、プラットフォーム間で一貫したグレースケール外観が必要なPDF文書を扱う開発者にとって、PDCalGrayは不可欠なカラーマネジメント機能を提供します。これは、プロフェッショナルな出版ワークフロー、アーカイブ文書、およびグレースケールコンテンツが出力デバイスに関係なく予測可能にレンダリングされる必要があるアクセシビリティ強化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 ) のようなアクセシビリティ基準を満たす上で重要です。PDCalGrayは、アプリケーションのニーズに対して正確だが簡潔なグレースケール校正で十分な場合に、完全なICCプロファイルベースのカラーマネジメントに代わる、よりシンプルな選択肢も提供します。このクラスを理解することで、開発者はPDFコンテンツをプログラム的に作成または変更する際に、カラースペースの選択について情報に基づいた判断を下すことができます。

PDCalGrayは、単一成分のグレースケール値がどのように解釈され、レンダリングされるべきかを定義する校正パラメータを保存し適用することで機能します。PDFリーダーがCalGrayカラースペースに遭遇すると、指定されたホワイトポイント（通常はCIE XYZ色空間座標で表現）を使用して、グレースケール範囲の基準白色を確立します。オプションのガンマパラメータ（線形応答の場合はデフォルトで1.0）は、トーン再現曲線を制御し、知覚的均一性やデバイス特性に合わせた調整を可能にします。ブラックポイントパラメータは、指定された場合、再現可能な最も暗い色を定義します。PDFBoxでは、開発者はPDFリソースから既存のカラースペース定義を読み取るか、特定の校正値で新しいインスタンスを作成することでPDCalGrayオブジェクトをインスタンス化します。このクラスは、ホワイトポイント配列、ガンマ値、ブラックポイント配列のgetterおよびsetterメソッドを提供し、これらの校正パラメータへのプログラマティックなアクセスを可能にします。レンダリング時には、PDFビューアまたはプリンタが校正済みカラースペースからデバイス固有のカラースペースへの変換を適用し、一貫した外観を保証します。PDCalGrayクラスは、PDFBoxの広範なカラーマネジメントシステムと統合され、他のカラースペースクラスと連携してPDF操作タスクのための包括的なカラー処理を提供します。

• PDDeviceGray – PDFBoxにおける校正されていない、デバイス依存のグレースケールカラースペース
• PDICCBased – 完全なカラーマネジメント機能のためのICCプロファイルベースのカラースペースクラス
• Color Space – PDF文書内で色がどのように表現されるかを定義する数学的モデル
• PDResources – カラースペース、フォント、画像を含むPDFページリソースのコンテナクラス
• White Point – 校正済みカラースペースにおける基準白色を定義する三刺激値